Analytics

Endpoints related to social media analytics for published posts.

Get analytics for a published post

get

Returns the latest known analytics and snapshot history for a published post. This endpoint does not trigger a re-fetch.

Authorizations

blotato-api-keystringRequired

Path parameters

idstringRequired

The id of the published post.

Example: 12345

Responses

200

Default Response

application/json

publishedPostIdstringRequired

The id of the published post.

Example: 12345

platformstring · enumRequired

Social media platform

Example: twitterPossible values:

lastFetchedAtstring · nullableRequired

lastErrorstring · nullableRequired

403

Forbidden

application/json

404

Not found

application/json

500

Server error

application/json

get/v2/posts/{id}/analytics

GET /v2/posts/{id}/analytics HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Accept: */*

{
  "publishedPostId": "12345",
  "platform": "twitter",
  "lastFetchedAt": "text",
  "lastError": "text",
  "metrics": {
    "clicksCount": "text",
    "commentsCount": "text",
    "followsCount": "text",
    "impressionsCount": "text",
    "interactionsSum": "text",
    "likesCount": "text",
    "navigationsCount": "text",
    "playsCount": "text",
    "profileActivityCount": "text",
    "profileVisitsCount": "text",
    "reachCount": "text",
    "repliesCount": "text",
    "savesCount": "text",
    "sharesCount": "text",
    "viewTimeMsSum": "text",
    "viewsCount": "text",
    "watchTimeMsAvg": "text",
    "twitterRetweetsCount": "text",
    "twitterQuotesCount": "text",
    "blueskyRepostsCount": "text",
    "blueskyQuotesCount": "text",
    "threadsRepostsCount": "text",
    "threadsQuotesCount": "text",
    "linkedinFirstLevelCommentsCount": "text",
    "linkedinReactionsByType": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "pinterestPinClicksCount": "text",
    "pinterestReactionsCount": "text",
    "pinterestVideoP95ViewsCount": "text",
    "pinterestVideo10sViewsCount": "text",
    "pinterestVideoMrcViewsCount": "text",
    "pinterestVideoV50WatchTimeMsSum": "text",
    "pinterestSaveRate": 1,
    "twitterPerMediaVideoViewsCount": [
      "text"
    ],
    "twitterPerMediaVideoPlaybackStartCount": [
      "text"
    ],
    "twitterPerMediaVideoPlayback25Count": [
      "text"
    ],
    "twitterPerMediaVideoPlayback50Count": [
      "text"
    ],
    "twitterPerMediaVideoPlayback75Count": [
      "text"
    ],
    "twitterPerMediaVideoPlaybackCompleteCount": [
      "text"
    ],
    "facebookPostMediaViewsCount": "text",
    "facebookPostMediaViewsUniqueCount": "text",
    "facebookPostReactionsByType": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "facebookBlueReelsPlaysCount": "text",
    "facebookFbReelsReplaysCount": "text",
    "facebookFbReelsTotalPlaysCount": "text",
    "facebookPostVideoWatchTimeMsAvg": "text",
    "facebookPostVideoFollowersCount": "text",
    "facebookPostVideoLikesByReactionType": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "facebookPostVideoSocialActionsByType": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "facebookPostVideoViewTimeMsSum": "text",
    "facebookTotalVideoViewsCount": "text",
    "facebookTotalVideoViewsUniqueCount": "text",
    "facebookTotalVideoViewsAutoplayedCount": "text",
    "facebookTotalVideoViewsClickedToPlayCount": "text",
    "facebookTotalVideoViewsSoundOnCount": "text",
    "facebookTotalVideoCompleteViewsCount": "text",
    "facebookTotalVideoCompleteViewsUniqueCount": "text",
    "facebookTotalVideoCompleteViewsAutoplayedCount": "text",
    "facebookTotalVideoCompleteViewsClickedToPlayCount": "text",
    "facebookTotalVideoCompleteViewsOrganicCount": "text",
    "facebookTotalVideoCompleteViewsOrganicUniqueCount": "text",
    "facebookTotalVideoCompleteViewsPaidCount": "text",
    "facebookTotalVideoCompleteViewsPaidUniqueCount": "text",
    "facebookTotalVideoViews10sCount": "text",
    "facebookTotalVideoViews10sUniqueCount": "text",
    "facebookTotalVideoViews10sAutoplayedCount": "text",
    "facebookTotalVideoViews10sClickedToPlayCount": "text",
    "facebookTotalVideoViews10sOrganicCount": "text",
    "facebookTotalVideoViews10sPaidCount": "text",
    "facebookTotalVideoViews10sSoundOnCount": "text",
    "facebookTotalVideoViews15sCount": "text",
    "facebookTotalVideoViews60sExcludesShorterCount": "text",
    "facebookTotalVideoWatchTimeMsAvg": "text",
    "facebookTotalVideoViewTimeMsSum": "text",
    "facebookTotalVideoViewTimeOrganicMsSum": "text",
    "facebookTotalVideoViewTimePaidMsSum": "text",
    "facebookTotalVideoStoriesByActionType": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "facebookTotalVideoReactionsByType": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "facebookTotalVideoViewTimeMsByAgeBucketAndGender": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "facebookTotalVideoViewTimeMsByRegionId": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "facebookTotalVideoViewsByDistributionType": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "youtubeDislikesCount": "text",
    "youtubeSubscribersLostCount": "text",
    "youtubeVideosAddedToPlaylistsCount": "text",
    "youtubeVideosRemovedFromPlaylistsCount": "text",
    "youtubeRedViewsCount": "text",
    "youtubeRedViewTimeMsSum": "text",
    "youtubeEngagedViewsCount": "text",
    "youtubeAverageViewPercentage": 1,
    "youtubeCardClicksCount": "text",
    "youtubeCardImpressionsCount": "text",
    "youtubeCardClickRate": 1,
    "youtubeCardTeaserClicksCount": "text",
    "youtubeCardTeaserImpressionsCount": "text",
    "youtubeCardTeaserClickRate": 1,
    "youtubeAnnotationClicksCount": "text",
    "youtubeAnnotationClickableImpressionsCount": "text",
    "youtubeAnnotationClosesCount": "text",
    "youtubeAnnotationClosableImpressionsCount": "text",
    "youtubeAnnotationImpressionsCount": "text",
    "youtubeAnnotationClickThroughRate": 1,
    "youtubeAnnotationCloseRate": 1
  },
  "history": [
    {
      "fetchedAt": "text",
      "metrics": {
        "clicksCount": "text",
        "commentsCount": "text",
        "followsCount": "text",
        "impressionsCount": "text",
        "interactionsSum": "text",
        "likesCount": "text",
        "navigationsCount": "text",
        "playsCount": "text",
        "profileActivityCount": "text",
        "profileVisitsCount": "text",
        "reachCount": "text",
        "repliesCount": "text",
        "savesCount": "text",
        "sharesCount": "text",
        "viewTimeMsSum": "text",
        "viewsCount": "text",
        "watchTimeMsAvg": "text",
        "twitterRetweetsCount": "text",
        "twitterQuotesCount": "text",
        "blueskyRepostsCount": "text",
        "blueskyQuotesCount": "text",
        "threadsRepostsCount": "text",
        "threadsQuotesCount": "text",
        "linkedinFirstLevelCommentsCount": "text",
        "linkedinReactionsByType": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "pinterestPinClicksCount": "text",
        "pinterestReactionsCount": "text",
        "pinterestVideoP95ViewsCount": "text",
        "pinterestVideo10sViewsCount": "text",
        "pinterestVideoMrcViewsCount": "text",
        "pinterestVideoV50WatchTimeMsSum": "text",
        "pinterestSaveRate": 1,
        "twitterPerMediaVideoViewsCount": [
          "text"
        ],
        "twitterPerMediaVideoPlaybackStartCount": [
          "text"
        ],
        "twitterPerMediaVideoPlayback25Count": [
          "text"
        ],
        "twitterPerMediaVideoPlayback50Count": [
          "text"
        ],
        "twitterPerMediaVideoPlayback75Count": [
          "text"
        ],
        "twitterPerMediaVideoPlaybackCompleteCount": [
          "text"
        ],
        "facebookPostMediaViewsCount": "text",
        "facebookPostMediaViewsUniqueCount": "text",
        "facebookPostReactionsByType": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "facebookBlueReelsPlaysCount": "text",
        "facebookFbReelsReplaysCount": "text",
        "facebookFbReelsTotalPlaysCount": "text",
        "facebookPostVideoWatchTimeMsAvg": "text",
        "facebookPostVideoFollowersCount": "text",
        "facebookPostVideoLikesByReactionType": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "facebookPostVideoSocialActionsByType": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "facebookPostVideoViewTimeMsSum": "text",
        "facebookTotalVideoViewsCount": "text",
        "facebookTotalVideoViewsUniqueCount": "text",
        "facebookTotalVideoViewsAutoplayedCount": "text",
        "facebookTotalVideoViewsClickedToPlayCount": "text",
        "facebookTotalVideoViewsSoundOnCount": "text",
        "facebookTotalVideoCompleteViewsCount": "text",
        "facebookTotalVideoCompleteViewsUniqueCount": "text",
        "facebookTotalVideoCompleteViewsAutoplayedCount": "text",
        "facebookTotalVideoCompleteViewsClickedToPlayCount": "text",
        "facebookTotalVideoCompleteViewsOrganicCount": "text",
        "facebookTotalVideoCompleteViewsOrganicUniqueCount": "text",
        "facebookTotalVideoCompleteViewsPaidCount": "text",
        "facebookTotalVideoCompleteViewsPaidUniqueCount": "text",
        "facebookTotalVideoViews10sCount": "text",
        "facebookTotalVideoViews10sUniqueCount": "text",
        "facebookTotalVideoViews10sAutoplayedCount": "text",
        "facebookTotalVideoViews10sClickedToPlayCount": "text",
        "facebookTotalVideoViews10sOrganicCount": "text",
        "facebookTotalVideoViews10sPaidCount": "text",
        "facebookTotalVideoViews10sSoundOnCount": "text",
        "facebookTotalVideoViews15sCount": "text",
        "facebookTotalVideoViews60sExcludesShorterCount": "text",
        "facebookTotalVideoWatchTimeMsAvg": "text",
        "facebookTotalVideoViewTimeMsSum": "text",
        "facebookTotalVideoViewTimeOrganicMsSum": "text",
        "facebookTotalVideoViewTimePaidMsSum": "text",
        "facebookTotalVideoStoriesByActionType": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "facebookTotalVideoReactionsByType": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "facebookTotalVideoViewTimeMsByAgeBucketAndGender": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "facebookTotalVideoViewTimeMsByRegionId": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "facebookTotalVideoViewsByDistributionType": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "youtubeDislikesCount": "text",
        "youtubeSubscribersLostCount": "text",
        "youtubeVideosAddedToPlaylistsCount": "text",
        "youtubeVideosRemovedFromPlaylistsCount": "text",
        "youtubeRedViewsCount": "text",
        "youtubeRedViewTimeMsSum": "text",
        "youtubeEngagedViewsCount": "text",
        "youtubeAverageViewPercentage": 1,
        "youtubeCardClicksCount": "text",
        "youtubeCardImpressionsCount": "text",
        "youtubeCardClickRate": 1,
        "youtubeCardTeaserClicksCount": "text",
        "youtubeCardTeaserImpressionsCount": "text",
        "youtubeCardTeaserClickRate": 1,
        "youtubeAnnotationClicksCount": "text",
        "youtubeAnnotationClickableImpressionsCount": "text",
        "youtubeAnnotationClosesCount": "text",
        "youtubeAnnotationClosableImpressionsCount": "text",
        "youtubeAnnotationImpressionsCount": "text",
        "youtubeAnnotationClickThroughRate": 1,
        "youtubeAnnotationCloseRate": 1
      }
    }
  ]
}

List top performing posts

get

Returns the user's top performing published posts ordered by the requested metric over the given time range.

Authorizations

blotato-api-keystringRequired

Query parameters

sincestringOptional

Only include posts published on or after this ISO 8601 timestamp. Defaults to 30 days ago.

untilstringOptional

Only include posts published on or before this ISO 8601 timestamp. Defaults to now.

platformstringOptional

sortBystring · enumOptionalPossible values:

limitinteger · min: 1 · max: 100OptionalDefault: 20

Responses

200

Default Response

application/json

403

Forbidden

application/json

422

Validation error

application/json

500

Server error

application/json

get/v2/analytics

GET /v2/analytics HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Accept: */*

{
  "items": [
    {
      "id": "text",
      "content": "text",
      "postUrl": "text",
      "platform": "twitter",
      "createdAt": "text",
      "mediaUrls": [
        "text"
      ],
      "latestMetrics": {
        "fetchedAt": "text",
        "metrics": {
          "clicksCount": "text",
          "commentsCount": "text",
          "followsCount": "text",
          "impressionsCount": "text",
          "interactionsSum": "text",
          "likesCount": "text",
          "navigationsCount": "text",
          "playsCount": "text",
          "profileActivityCount": "text",
          "profileVisitsCount": "text",
          "reachCount": "text",
          "repliesCount": "text",
          "savesCount": "text",
          "sharesCount": "text",
          "viewTimeMsSum": "text",
          "viewsCount": "text",
          "watchTimeMsAvg": "text",
          "twitterRetweetsCount": "text",
          "twitterQuotesCount": "text",
          "blueskyRepostsCount": "text",
          "blueskyQuotesCount": "text",
          "threadsRepostsCount": "text",
          "threadsQuotesCount": "text",
          "linkedinFirstLevelCommentsCount": "text",
          "linkedinReactionsByType": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          },
          "pinterestPinClicksCount": "text",
          "pinterestReactionsCount": "text",
          "pinterestVideoP95ViewsCount": "text",
          "pinterestVideo10sViewsCount": "text",
          "pinterestVideoMrcViewsCount": "text",
          "pinterestVideoV50WatchTimeMsSum": "text",
          "pinterestSaveRate": 1,
          "twitterPerMediaVideoViewsCount": [
            "text"
          ],
          "twitterPerMediaVideoPlaybackStartCount": [
            "text"
          ],
          "twitterPerMediaVideoPlayback25Count": [
            "text"
          ],
          "twitterPerMediaVideoPlayback50Count": [
            "text"
          ],
          "twitterPerMediaVideoPlayback75Count": [
            "text"
          ],
          "twitterPerMediaVideoPlaybackCompleteCount": [
            "text"
          ],
          "facebookPostMediaViewsCount": "text",
          "facebookPostMediaViewsUniqueCount": "text",
          "facebookPostReactionsByType": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          },
          "facebookBlueReelsPlaysCount": "text",
          "facebookFbReelsReplaysCount": "text",
          "facebookFbReelsTotalPlaysCount": "text",
          "facebookPostVideoWatchTimeMsAvg": "text",
          "facebookPostVideoFollowersCount": "text",
          "facebookPostVideoLikesByReactionType": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          },
          "facebookPostVideoSocialActionsByType": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          },
          "facebookPostVideoViewTimeMsSum": "text",
          "facebookTotalVideoViewsCount": "text",
          "facebookTotalVideoViewsUniqueCount": "text",
          "facebookTotalVideoViewsAutoplayedCount": "text",
          "facebookTotalVideoViewsClickedToPlayCount": "text",
          "facebookTotalVideoViewsSoundOnCount": "text",
          "facebookTotalVideoCompleteViewsCount": "text",
          "facebookTotalVideoCompleteViewsUniqueCount": "text",
          "facebookTotalVideoCompleteViewsAutoplayedCount": "text",
          "facebookTotalVideoCompleteViewsClickedToPlayCount": "text",
          "facebookTotalVideoCompleteViewsOrganicCount": "text",
          "facebookTotalVideoCompleteViewsOrganicUniqueCount": "text",
          "facebookTotalVideoCompleteViewsPaidCount": "text",
          "facebookTotalVideoCompleteViewsPaidUniqueCount": "text",
          "facebookTotalVideoViews10sCount": "text",
          "facebookTotalVideoViews10sUniqueCount": "text",
          "facebookTotalVideoViews10sAutoplayedCount": "text",
          "facebookTotalVideoViews10sClickedToPlayCount": "text",
          "facebookTotalVideoViews10sOrganicCount": "text",
          "facebookTotalVideoViews10sPaidCount": "text",
          "facebookTotalVideoViews10sSoundOnCount": "text",
          "facebookTotalVideoViews15sCount": "text",
          "facebookTotalVideoViews60sExcludesShorterCount": "text",
          "facebookTotalVideoWatchTimeMsAvg": "text",
          "facebookTotalVideoViewTimeMsSum": "text",
          "facebookTotalVideoViewTimeOrganicMsSum": "text",
          "facebookTotalVideoViewTimePaidMsSum": "text",
          "facebookTotalVideoStoriesByActionType": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          },
          "facebookTotalVideoReactionsByType": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          },
          "facebookTotalVideoViewTimeMsByAgeBucketAndGender": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          },
          "facebookTotalVideoViewTimeMsByRegionId": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          },
          "facebookTotalVideoViewsByDistributionType": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          },
          "youtubeDislikesCount": "text",
          "youtubeSubscribersLostCount": "text",
          "youtubeVideosAddedToPlaylistsCount": "text",
          "youtubeVideosRemovedFromPlaylistsCount": "text",
          "youtubeRedViewsCount": "text",
          "youtubeRedViewTimeMsSum": "text",
          "youtubeEngagedViewsCount": "text",
          "youtubeAverageViewPercentage": 1,
          "youtubeCardClicksCount": "text",
          "youtubeCardImpressionsCount": "text",
          "youtubeCardClickRate": 1,
          "youtubeCardTeaserClicksCount": "text",
          "youtubeCardTeaserImpressionsCount": "text",
          "youtubeCardTeaserClickRate": 1,
          "youtubeAnnotationClicksCount": "text",
          "youtubeAnnotationClickableImpressionsCount": "text",
          "youtubeAnnotationClosesCount": "text",
          "youtubeAnnotationClosableImpressionsCount": "text",
          "youtubeAnnotationImpressionsCount": "text",
          "youtubeAnnotationClickThroughRate": 1,
          "youtubeAnnotationCloseRate": 1
        }
      },
      "metricsHistory": [
        {
          "fetchedAt": "text",
          "metrics": {
            "clicksCount": "text",
            "commentsCount": "text",
            "followsCount": "text",
            "impressionsCount": "text",
            "interactionsSum": "text",
            "likesCount": "text",
            "navigationsCount": "text",
            "playsCount": "text",
            "profileActivityCount": "text",
            "profileVisitsCount": "text",
            "reachCount": "text",
            "repliesCount": "text",
            "savesCount": "text",
            "sharesCount": "text",
            "viewTimeMsSum": "text",
            "viewsCount": "text",
            "watchTimeMsAvg": "text",
            "twitterRetweetsCount": "text",
            "twitterQuotesCount": "text",
            "blueskyRepostsCount": "text",
            "blueskyQuotesCount": "text",
            "threadsRepostsCount": "text",
            "threadsQuotesCount": "text",
            "linkedinFirstLevelCommentsCount": "text",
            "linkedinReactionsByType": {
              "ANY_ADDITIONAL_PROPERTY": "text"
            },
            "pinterestPinClicksCount": "text",
            "pinterestReactionsCount": "text",
            "pinterestVideoP95ViewsCount": "text",
            "pinterestVideo10sViewsCount": "text",
            "pinterestVideoMrcViewsCount": "text",
            "pinterestVideoV50WatchTimeMsSum": "text",
            "pinterestSaveRate": 1,
            "twitterPerMediaVideoViewsCount": [
              "text"
            ],
            "twitterPerMediaVideoPlaybackStartCount": [
              "text"
            ],
            "twitterPerMediaVideoPlayback25Count": [
              "text"
            ],
            "twitterPerMediaVideoPlayback50Count": [
              "text"
            ],
            "twitterPerMediaVideoPlayback75Count": [
              "text"
            ],
            "twitterPerMediaVideoPlaybackCompleteCount": [
              "text"
            ],
            "facebookPostMediaViewsCount": "text",
            "facebookPostMediaViewsUniqueCount": "text",
            "facebookPostReactionsByType": {
              "ANY_ADDITIONAL_PROPERTY": "text"
            },
            "facebookBlueReelsPlaysCount": "text",
            "facebookFbReelsReplaysCount": "text",
            "facebookFbReelsTotalPlaysCount": "text",
            "facebookPostVideoWatchTimeMsAvg": "text",
            "facebookPostVideoFollowersCount": "text",
            "facebookPostVideoLikesByReactionType": {
              "ANY_ADDITIONAL_PROPERTY": "text"
            },
            "facebookPostVideoSocialActionsByType": {
              "ANY_ADDITIONAL_PROPERTY": "text"
            },
            "facebookPostVideoViewTimeMsSum": "text",
            "facebookTotalVideoViewsCount": "text",
            "facebookTotalVideoViewsUniqueCount": "text",
            "facebookTotalVideoViewsAutoplayedCount": "text",
            "facebookTotalVideoViewsClickedToPlayCount": "text",
            "facebookTotalVideoViewsSoundOnCount": "text",
            "facebookTotalVideoCompleteViewsCount": "text",
            "facebookTotalVideoCompleteViewsUniqueCount": "text",
            "facebookTotalVideoCompleteViewsAutoplayedCount": "text",
            "facebookTotalVideoCompleteViewsClickedToPlayCount": "text",
            "facebookTotalVideoCompleteViewsOrganicCount": "text",
            "facebookTotalVideoCompleteViewsOrganicUniqueCount": "text",
            "facebookTotalVideoCompleteViewsPaidCount": "text",
            "facebookTotalVideoCompleteViewsPaidUniqueCount": "text",
            "facebookTotalVideoViews10sCount": "text",
            "facebookTotalVideoViews10sUniqueCount": "text",
            "facebookTotalVideoViews10sAutoplayedCount": "text",
            "facebookTotalVideoViews10sClickedToPlayCount": "text",
            "facebookTotalVideoViews10sOrganicCount": "text",
            "facebookTotalVideoViews10sPaidCount": "text",
            "facebookTotalVideoViews10sSoundOnCount": "text",
            "facebookTotalVideoViews15sCount": "text",
            "facebookTotalVideoViews60sExcludesShorterCount": "text",
            "facebookTotalVideoWatchTimeMsAvg": "text",
            "facebookTotalVideoViewTimeMsSum": "text",
            "facebookTotalVideoViewTimeOrganicMsSum": "text",
            "facebookTotalVideoViewTimePaidMsSum": "text",
            "facebookTotalVideoStoriesByActionType": {
              "ANY_ADDITIONAL_PROPERTY": "text"
            },
            "facebookTotalVideoReactionsByType": {
              "ANY_ADDITIONAL_PROPERTY": "text"
            },
            "facebookTotalVideoViewTimeMsByAgeBucketAndGender": {
              "ANY_ADDITIONAL_PROPERTY": "text"
            },
            "facebookTotalVideoViewTimeMsByRegionId": {
              "ANY_ADDITIONAL_PROPERTY": "text"
            },
            "facebookTotalVideoViewsByDistributionType": {
              "ANY_ADDITIONAL_PROPERTY": "text"
            },
            "youtubeDislikesCount": "text",
            "youtubeSubscribersLostCount": "text",
            "youtubeVideosAddedToPlaylistsCount": "text",
            "youtubeVideosRemovedFromPlaylistsCount": "text",
            "youtubeRedViewsCount": "text",
            "youtubeRedViewTimeMsSum": "text",
            "youtubeEngagedViewsCount": "text",
            "youtubeAverageViewPercentage": 1,
            "youtubeCardClicksCount": "text",
            "youtubeCardImpressionsCount": "text",
            "youtubeCardClickRate": 1,
            "youtubeCardTeaserClicksCount": "text",
            "youtubeCardTeaserImpressionsCount": "text",
            "youtubeCardTeaserClickRate": 1,
            "youtubeAnnotationClicksCount": "text",
            "youtubeAnnotationClickableImpressionsCount": "text",
            "youtubeAnnotationClosesCount": "text",
            "youtubeAnnotationClosableImpressionsCount": "text",
            "youtubeAnnotationImpressionsCount": "text",
            "youtubeAnnotationClickThroughRate": 1,
            "youtubeAnnotationCloseRate": 1
          }
        }
      ]
    }
  ]
}

List performance by platform

get

Returns engagement and view totals per platform for the user's posts published in the given time range, based on the latest analytics snapshot of each post.

Authorizations

blotato-api-keystringRequired

Query parameters

sincestringOptional

Only include posts published on or after this ISO 8601 timestamp. Defaults to 24 hours ago.

untilstringOptional

Only include posts published on or before this ISO 8601 timestamp. Defaults to now.

bucketstring · enumOptional

Size of the time buckets. Defaults to 'hour'.

Possible values:

Responses

200

Default Response

application/json

403

Forbidden

application/json

422

Validation error

application/json

500

Server error

application/json

get/v2/analytics/platforms

GET /v2/analytics/platforms HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Accept: */*

{
  "items": [
    {
      "platform": "twitter",
      "postsCount": 1,
      "engagementsCount": "text",
      "likesCount": "text",
      "commentsCount": "text",
      "viewsCount": "text",
      "buckets": [
        {
          "start": "text",
          "engagementsCount": "text",
          "likesCount": "text",
          "commentsCount": "text",
          "viewsCount": "text"
        }
      ]
    }
  ]
}

Get analytics summary

get

Returns published and failed post counts (in total, per platform, and per time bucket) and metric totals for the user's posts published in the given time range.

Authorizations

blotato-api-keystringRequired

Query parameters

sincestringOptional

Only include posts published on or after this ISO 8601 timestamp. Defaults to 30 days ago.

untilstringOptional

Only include posts published on or before this ISO 8601 timestamp. Defaults to now.

bucketstring · enumOptional

Size of the time buckets. Defaults to 'hour'.

Possible values:

Responses

200

Default Response

application/json

publishedCountintegerRequired

Number of posts published through Blotato in the window.

failedCountintegerRequired

Number of posts that failed to publish in the window.

403

Forbidden

application/json

422

Validation error

application/json

500

Server error

application/json

get/v2/analytics/summary

GET /v2/analytics/summary HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Accept: */*

{
  "publishedCount": 1,
  "failedCount": 1,
  "metrics": {
    "postsCount": 1,
    "viewsCount": "text",
    "likesCount": "text",
    "commentsCount": "text"
  },
  "platforms": [
    {
      "platform": "twitter",
      "publishedCount": 1,
      "failedCount": 1
    }
  ],
  "buckets": [
    {
      "start": "text",
      "publishedCount": 1,
      "failedCount": 1
    }
  ]
}