# Analytics

Endpoints related to social media analytics for published posts.

## Get analytics for a published post

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

```json
{"openapi":"3.0.3","info":{"title":"Blotato API","version":"2.0.0"},"tags":[{"name":"analytics","description":"Endpoints related to social media analytics for published posts."}],"servers":[{"url":"https://backend.blotato.com","description":"Blotato API Server"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","name":"blotato-api-key","in":"header"}}},"paths":{"/v2/posts/{id}/analytics":{"get":{"summary":"Get analytics for a published post","tags":["analytics"],"description":"Returns the latest known analytics and snapshot history for a published post. This endpoint does not trigger a re-fetch.","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"The id of the published post."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"publishedPostId":{"description":"The id of the published post.","type":"string"},"platform":{"description":"Social media platform","type":"string","enum":["twitter","instagram","linkedin","facebook","tiktok","pinterest","threads","bluesky","youtube","other"]},"lastFetchedAt":{"type":"string","nullable":true},"lastError":{"type":"string","nullable":true},"metrics":{"type":"object","properties":{"clicksCount":{"type":"string"},"commentsCount":{"type":"string"},"followsCount":{"type":"string"},"impressionsCount":{"type":"string"},"interactionsSum":{"type":"string"},"likesCount":{"type":"string"},"navigationsCount":{"type":"string"},"playsCount":{"type":"string"},"profileActivityCount":{"type":"string"},"profileVisitsCount":{"type":"string"},"reachCount":{"type":"string"},"repliesCount":{"type":"string"},"savesCount":{"type":"string"},"sharesCount":{"type":"string"},"viewTimeMsSum":{"type":"string"},"viewsCount":{"type":"string"},"watchTimeMsAvg":{"type":"string"},"twitterRetweetsCount":{"type":"string"},"twitterQuotesCount":{"type":"string"},"blueskyRepostsCount":{"type":"string"},"blueskyQuotesCount":{"type":"string"},"threadsRepostsCount":{"type":"string"},"threadsQuotesCount":{"type":"string"},"linkedinFirstLevelCommentsCount":{"type":"string"},"linkedinReactionsByType":{"type":"object","additionalProperties":{"type":"string"}},"pinterestPinClicksCount":{"type":"string"},"pinterestReactionsCount":{"type":"string"},"pinterestVideoP95ViewsCount":{"type":"string"},"pinterestVideo10sViewsCount":{"type":"string"},"pinterestVideoMrcViewsCount":{"type":"string"},"pinterestVideoV50WatchTimeMsSum":{"type":"string"},"pinterestSaveRate":{"type":"number"},"twitterPerMediaVideoViewsCount":{"type":"array","items":{"type":"string","nullable":true}},"twitterPerMediaVideoPlaybackStartCount":{"type":"array","items":{"type":"string","nullable":true}},"twitterPerMediaVideoPlayback25Count":{"type":"array","items":{"type":"string","nullable":true}},"twitterPerMediaVideoPlayback50Count":{"type":"array","items":{"type":"string","nullable":true}},"twitterPerMediaVideoPlayback75Count":{"type":"array","items":{"type":"string","nullable":true}},"twitterPerMediaVideoPlaybackCompleteCount":{"type":"array","items":{"type":"string","nullable":true}},"facebookPostMediaViewsCount":{"type":"string"},"facebookPostMediaViewsUniqueCount":{"type":"string"},"facebookPostReactionsByType":{"type":"object","additionalProperties":{"type":"string"}},"facebookBlueReelsPlaysCount":{"type":"string"},"facebookFbReelsReplaysCount":{"type":"string"},"facebookFbReelsTotalPlaysCount":{"type":"string"},"facebookPostVideoWatchTimeMsAvg":{"type":"string"},"facebookPostVideoFollowersCount":{"type":"string"},"facebookPostVideoLikesByReactionType":{"type":"object","additionalProperties":{"type":"string"}},"facebookPostVideoSocialActionsByType":{"type":"object","additionalProperties":{"type":"string"}},"facebookPostVideoViewTimeMsSum":{"type":"string"},"facebookTotalVideoViewsCount":{"type":"string"},"facebookTotalVideoViewsUniqueCount":{"type":"string"},"facebookTotalVideoViewsAutoplayedCount":{"type":"string"},"facebookTotalVideoViewsClickedToPlayCount":{"type":"string"},"facebookTotalVideoViewsSoundOnCount":{"type":"string"},"facebookTotalVideoCompleteViewsCount":{"type":"string"},"facebookTotalVideoCompleteViewsUniqueCount":{"type":"string"},"facebookTotalVideoCompleteViewsAutoplayedCount":{"type":"string"},"facebookTotalVideoCompleteViewsClickedToPlayCount":{"type":"string"},"facebookTotalVideoCompleteViewsOrganicCount":{"type":"string"},"facebookTotalVideoCompleteViewsOrganicUniqueCount":{"type":"string"},"facebookTotalVideoCompleteViewsPaidCount":{"type":"string"},"facebookTotalVideoCompleteViewsPaidUniqueCount":{"type":"string"},"facebookTotalVideoViews10sCount":{"type":"string"},"facebookTotalVideoViews10sUniqueCount":{"type":"string"},"facebookTotalVideoViews10sAutoplayedCount":{"type":"string"},"facebookTotalVideoViews10sClickedToPlayCount":{"type":"string"},"facebookTotalVideoViews10sOrganicCount":{"type":"string"},"facebookTotalVideoViews10sPaidCount":{"type":"string"},"facebookTotalVideoViews10sSoundOnCount":{"type":"string"},"facebookTotalVideoViews15sCount":{"type":"string"},"facebookTotalVideoViews60sExcludesShorterCount":{"type":"string"},"facebookTotalVideoWatchTimeMsAvg":{"type":"string"},"facebookTotalVideoViewTimeMsSum":{"type":"string"},"facebookTotalVideoViewTimeOrganicMsSum":{"type":"string"},"facebookTotalVideoViewTimePaidMsSum":{"type":"string"},"facebookTotalVideoStoriesByActionType":{"type":"object","additionalProperties":{"type":"string"}},"facebookTotalVideoReactionsByType":{"type":"object","additionalProperties":{"type":"string"}},"facebookTotalVideoViewTimeMsByAgeBucketAndGender":{"type":"object","additionalProperties":{"type":"string"}},"facebookTotalVideoViewTimeMsByRegionId":{"type":"object","additionalProperties":{"type":"string"}},"facebookTotalVideoViewsByDistributionType":{"type":"object","additionalProperties":{"type":"string"}},"youtubeDislikesCount":{"type":"string"},"youtubeSubscribersLostCount":{"type":"string"},"youtubeVideosAddedToPlaylistsCount":{"type":"string"},"youtubeVideosRemovedFromPlaylistsCount":{"type":"string"},"youtubeRedViewsCount":{"type":"string"},"youtubeRedViewTimeMsSum":{"type":"string"},"youtubeEngagedViewsCount":{"type":"string"},"youtubeAverageViewPercentage":{"type":"number"},"youtubeCardClicksCount":{"type":"string"},"youtubeCardImpressionsCount":{"type":"string"},"youtubeCardClickRate":{"type":"number"},"youtubeCardTeaserClicksCount":{"type":"string"},"youtubeCardTeaserImpressionsCount":{"type":"string"},"youtubeCardTeaserClickRate":{"type":"number"},"youtubeAnnotationClicksCount":{"type":"string"},"youtubeAnnotationClickableImpressionsCount":{"type":"string"},"youtubeAnnotationClosesCount":{"type":"string"},"youtubeAnnotationClosableImpressionsCount":{"type":"string"},"youtubeAnnotationImpressionsCount":{"type":"string"},"youtubeAnnotationClickThroughRate":{"type":"number"},"youtubeAnnotationCloseRate":{"type":"number"}},"nullable":true},"history":{"type":"array","items":{"type":"object","properties":{"fetchedAt":{"description":"ISO 8601 timestamp when metrics were captured.","type":"string"},"metrics":{"type":"object","properties":{"clicksCount":{"type":"string"},"commentsCount":{"type":"string"},"followsCount":{"type":"string"},"impressionsCount":{"type":"string"},"interactionsSum":{"type":"string"},"likesCount":{"type":"string"},"navigationsCount":{"type":"string"},"playsCount":{"type":"string"},"profileActivityCount":{"type":"string"},"profileVisitsCount":{"type":"string"},"reachCount":{"type":"string"},"repliesCount":{"type":"string"},"savesCount":{"type":"string"},"sharesCount":{"type":"string"},"viewTimeMsSum":{"type":"string"},"viewsCount":{"type":"string"},"watchTimeMsAvg":{"type":"string"},"twitterRetweetsCount":{"type":"string"},"twitterQuotesCount":{"type":"string"},"blueskyRepostsCount":{"type":"string"},"blueskyQuotesCount":{"type":"string"},"threadsRepostsCount":{"type":"string"},"threadsQuotesCount":{"type":"string"},"linkedinFirstLevelCommentsCount":{"type":"string"},"linkedinReactionsByType":{"type":"object","additionalProperties":{"type":"string"}},"pinterestPinClicksCount":{"type":"string"},"pinterestReactionsCount":{"type":"string"},"pinterestVideoP95ViewsCount":{"type":"string"},"pinterestVideo10sViewsCount":{"type":"string"},"pinterestVideoMrcViewsCount":{"type":"string"},"pinterestVideoV50WatchTimeMsSum":{"type":"string"},"pinterestSaveRate":{"type":"number"},"twitterPerMediaVideoViewsCount":{"type":"array","items":{"type":"string","nullable":true}},"twitterPerMediaVideoPlaybackStartCount":{"type":"array","items":{"type":"string","nullable":true}},"twitterPerMediaVideoPlayback25Count":{"type":"array","items":{"type":"string","nullable":true}},"twitterPerMediaVideoPlayback50Count":{"type":"array","items":{"type":"string","nullable":true}},"twitterPerMediaVideoPlayback75Count":{"type":"array","items":{"type":"string","nullable":true}},"twitterPerMediaVideoPlaybackCompleteCount":{"type":"array","items":{"type":"string","nullable":true}},"facebookPostMediaViewsCount":{"type":"string"},"facebookPostMediaViewsUniqueCount":{"type":"string"},"facebookPostReactionsByType":{"type":"object","additionalProperties":{"type":"string"}},"facebookBlueReelsPlaysCount":{"type":"string"},"facebookFbReelsReplaysCount":{"type":"string"},"facebookFbReelsTotalPlaysCount":{"type":"string"},"facebookPostVideoWatchTimeMsAvg":{"type":"string"},"facebookPostVideoFollowersCount":{"type":"string"},"facebookPostVideoLikesByReactionType":{"type":"object","additionalProperties":{"type":"string"}},"facebookPostVideoSocialActionsByType":{"type":"object","additionalProperties":{"type":"string"}},"facebookPostVideoViewTimeMsSum":{"type":"string"},"facebookTotalVideoViewsCount":{"type":"string"},"facebookTotalVideoViewsUniqueCount":{"type":"string"},"facebookTotalVideoViewsAutoplayedCount":{"type":"string"},"facebookTotalVideoViewsClickedToPlayCount":{"type":"string"},"facebookTotalVideoViewsSoundOnCount":{"type":"string"},"facebookTotalVideoCompleteViewsCount":{"type":"string"},"facebookTotalVideoCompleteViewsUniqueCount":{"type":"string"},"facebookTotalVideoCompleteViewsAutoplayedCount":{"type":"string"},"facebookTotalVideoCompleteViewsClickedToPlayCount":{"type":"string"},"facebookTotalVideoCompleteViewsOrganicCount":{"type":"string"},"facebookTotalVideoCompleteViewsOrganicUniqueCount":{"type":"string"},"facebookTotalVideoCompleteViewsPaidCount":{"type":"string"},"facebookTotalVideoCompleteViewsPaidUniqueCount":{"type":"string"},"facebookTotalVideoViews10sCount":{"type":"string"},"facebookTotalVideoViews10sUniqueCount":{"type":"string"},"facebookTotalVideoViews10sAutoplayedCount":{"type":"string"},"facebookTotalVideoViews10sClickedToPlayCount":{"type":"string"},"facebookTotalVideoViews10sOrganicCount":{"type":"string"},"facebookTotalVideoViews10sPaidCount":{"type":"string"},"facebookTotalVideoViews10sSoundOnCount":{"type":"string"},"facebookTotalVideoViews15sCount":{"type":"string"},"facebookTotalVideoViews60sExcludesShorterCount":{"type":"string"},"facebookTotalVideoWatchTimeMsAvg":{"type":"string"},"facebookTotalVideoViewTimeMsSum":{"type":"string"},"facebookTotalVideoViewTimeOrganicMsSum":{"type":"string"},"facebookTotalVideoViewTimePaidMsSum":{"type":"string"},"facebookTotalVideoStoriesByActionType":{"type":"object","additionalProperties":{"type":"string"}},"facebookTotalVideoReactionsByType":{"type":"object","additionalProperties":{"type":"string"}},"facebookTotalVideoViewTimeMsByAgeBucketAndGender":{"type":"object","additionalProperties":{"type":"string"}},"facebookTotalVideoViewTimeMsByRegionId":{"type":"object","additionalProperties":{"type":"string"}},"facebookTotalVideoViewsByDistributionType":{"type":"object","additionalProperties":{"type":"string"}},"youtubeDislikesCount":{"type":"string"},"youtubeSubscribersLostCount":{"type":"string"},"youtubeVideosAddedToPlaylistsCount":{"type":"string"},"youtubeVideosRemovedFromPlaylistsCount":{"type":"string"},"youtubeRedViewsCount":{"type":"string"},"youtubeRedViewTimeMsSum":{"type":"string"},"youtubeEngagedViewsCount":{"type":"string"},"youtubeAverageViewPercentage":{"type":"number"},"youtubeCardClicksCount":{"type":"string"},"youtubeCardImpressionsCount":{"type":"string"},"youtubeCardClickRate":{"type":"number"},"youtubeCardTeaserClicksCount":{"type":"string"},"youtubeCardTeaserImpressionsCount":{"type":"string"},"youtubeCardTeaserClickRate":{"type":"number"},"youtubeAnnotationClicksCount":{"type":"string"},"youtubeAnnotationClickableImpressionsCount":{"type":"string"},"youtubeAnnotationClosesCount":{"type":"string"},"youtubeAnnotationClosableImpressionsCount":{"type":"string"},"youtubeAnnotationImpressionsCount":{"type":"string"},"youtubeAnnotationClickThroughRate":{"type":"number"},"youtubeAnnotationCloseRate":{"type":"number"}}}},"required":["fetchedAt","metrics"]}}},"required":["publishedPostId","platform","lastFetchedAt","lastError","metrics","history"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"description":"Not found","type":"object","properties":{"code":{"type":"number"},"reqId":{"description":"Request ID for tracking","type":"string"},"message":{"description":"Resource not found","type":"string"}},"required":["message"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"description":"Server error","type":"object","properties":{"code":{"type":"number"},"reqId":{"description":"Request ID for tracking","type":"string"},"message":{"description":"An error occurred","type":"string"}},"required":["message"]}}}}}}}}}
```

## List top performing posts

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

```json
{"openapi":"3.0.3","info":{"title":"Blotato API","version":"2.0.0"},"tags":[{"name":"analytics","description":"Endpoints related to social media analytics for published posts."}],"servers":[{"url":"https://backend.blotato.com","description":"Blotato API Server"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","name":"blotato-api-key","in":"header"}}},"paths":{"/v2/analytics":{"get":{"summary":"List top performing posts","tags":["analytics"],"description":"Returns the user's top performing published posts ordered by the requested metric over the given time range.","parameters":[{"schema":{"type":"string"},"in":"query","name":"since","required":false,"description":"Only include posts published on or after this ISO 8601 timestamp. Defaults to 30 days ago."},{"schema":{"type":"string"},"in":"query","name":"until","required":false,"description":"Only include posts published on or before this ISO 8601 timestamp. Defaults to now."},{"schema":{"type":"string"},"in":"query","name":"platform","required":false},{"schema":{"type":"string","enum":["likes_count","comments_count","views_count","reach_count"]},"in":"query","name":"sortBy","required":false},{"schema":{"minimum":1,"maximum":100,"default":20,"type":"integer"},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"postUrl":{"type":"string","nullable":true},"platform":{"description":"Social media platform","type":"string","enum":["twitter","instagram","linkedin","facebook","tiktok","pinterest","threads","bluesky","youtube","other"]},"createdAt":{"type":"string"},"mediaUrls":{"type":"array","items":{"type":"string"}},"latestMetrics":{"type":"object","properties":{"fetchedAt":{"description":"ISO 8601 timestamp when metrics were captured.","type":"string"},"metrics":{"type":"object","properties":{"clicksCount":{"type":"string"},"commentsCount":{"type":"string"},"followsCount":{"type":"string"},"impressionsCount":{"type":"string"},"interactionsSum":{"type":"string"},"likesCount":{"type":"string"},"navigationsCount":{"type":"string"},"playsCount":{"type":"string"},"profileActivityCount":{"type":"string"},"profileVisitsCount":{"type":"string"},"reachCount":{"type":"string"},"repliesCount":{"type":"string"},"savesCount":{"type":"string"},"sharesCount":{"type":"string"},"viewTimeMsSum":{"type":"string"},"viewsCount":{"type":"string"},"watchTimeMsAvg":{"type":"string"},"twitterRetweetsCount":{"type":"string"},"twitterQuotesCount":{"type":"string"},"blueskyRepostsCount":{"type":"string"},"blueskyQuotesCount":{"type":"string"},"threadsRepostsCount":{"type":"string"},"threadsQuotesCount":{"type":"string"},"linkedinFirstLevelCommentsCount":{"type":"string"},"linkedinReactionsByType":{"type":"object","additionalProperties":{"type":"string"}},"pinterestPinClicksCount":{"type":"string"},"pinterestReactionsCount":{"type":"string"},"pinterestVideoP95ViewsCount":{"type":"string"},"pinterestVideo10sViewsCount":{"type":"string"},"pinterestVideoMrcViewsCount":{"type":"string"},"pinterestVideoV50WatchTimeMsSum":{"type":"string"},"pinterestSaveRate":{"type":"number"},"twitterPerMediaVideoViewsCount":{"type":"array","items":{"type":"string","nullable":true}},"twitterPerMediaVideoPlaybackStartCount":{"type":"array","items":{"type":"string","nullable":true}},"twitterPerMediaVideoPlayback25Count":{"type":"array","items":{"type":"string","nullable":true}},"twitterPerMediaVideoPlayback50Count":{"type":"array","items":{"type":"string","nullable":true}},"twitterPerMediaVideoPlayback75Count":{"type":"array","items":{"type":"string","nullable":true}},"twitterPerMediaVideoPlaybackCompleteCount":{"type":"array","items":{"type":"string","nullable":true}},"facebookPostMediaViewsCount":{"type":"string"},"facebookPostMediaViewsUniqueCount":{"type":"string"},"facebookPostReactionsByType":{"type":"object","additionalProperties":{"type":"string"}},"facebookBlueReelsPlaysCount":{"type":"string"},"facebookFbReelsReplaysCount":{"type":"string"},"facebookFbReelsTotalPlaysCount":{"type":"string"},"facebookPostVideoWatchTimeMsAvg":{"type":"string"},"facebookPostVideoFollowersCount":{"type":"string"},"facebookPostVideoLikesByReactionType":{"type":"object","additionalProperties":{"type":"string"}},"facebookPostVideoSocialActionsByType":{"type":"object","additionalProperties":{"type":"string"}},"facebookPostVideoViewTimeMsSum":{"type":"string"},"facebookTotalVideoViewsCount":{"type":"string"},"facebookTotalVideoViewsUniqueCount":{"type":"string"},"facebookTotalVideoViewsAutoplayedCount":{"type":"string"},"facebookTotalVideoViewsClickedToPlayCount":{"type":"string"},"facebookTotalVideoViewsSoundOnCount":{"type":"string"},"facebookTotalVideoCompleteViewsCount":{"type":"string"},"facebookTotalVideoCompleteViewsUniqueCount":{"type":"string"},"facebookTotalVideoCompleteViewsAutoplayedCount":{"type":"string"},"facebookTotalVideoCompleteViewsClickedToPlayCount":{"type":"string"},"facebookTotalVideoCompleteViewsOrganicCount":{"type":"string"},"facebookTotalVideoCompleteViewsOrganicUniqueCount":{"type":"string"},"facebookTotalVideoCompleteViewsPaidCount":{"type":"string"},"facebookTotalVideoCompleteViewsPaidUniqueCount":{"type":"string"},"facebookTotalVideoViews10sCount":{"type":"string"},"facebookTotalVideoViews10sUniqueCount":{"type":"string"},"facebookTotalVideoViews10sAutoplayedCount":{"type":"string"},"facebookTotalVideoViews10sClickedToPlayCount":{"type":"string"},"facebookTotalVideoViews10sOrganicCount":{"type":"string"},"facebookTotalVideoViews10sPaidCount":{"type":"string"},"facebookTotalVideoViews10sSoundOnCount":{"type":"string"},"facebookTotalVideoViews15sCount":{"type":"string"},"facebookTotalVideoViews60sExcludesShorterCount":{"type":"string"},"facebookTotalVideoWatchTimeMsAvg":{"type":"string"},"facebookTotalVideoViewTimeMsSum":{"type":"string"},"facebookTotalVideoViewTimeOrganicMsSum":{"type":"string"},"facebookTotalVideoViewTimePaidMsSum":{"type":"string"},"facebookTotalVideoStoriesByActionType":{"type":"object","additionalProperties":{"type":"string"}},"facebookTotalVideoReactionsByType":{"type":"object","additionalProperties":{"type":"string"}},"facebookTotalVideoViewTimeMsByAgeBucketAndGender":{"type":"object","additionalProperties":{"type":"string"}},"facebookTotalVideoViewTimeMsByRegionId":{"type":"object","additionalProperties":{"type":"string"}},"facebookTotalVideoViewsByDistributionType":{"type":"object","additionalProperties":{"type":"string"}},"youtubeDislikesCount":{"type":"string"},"youtubeSubscribersLostCount":{"type":"string"},"youtubeVideosAddedToPlaylistsCount":{"type":"string"},"youtubeVideosRemovedFromPlaylistsCount":{"type":"string"},"youtubeRedViewsCount":{"type":"string"},"youtubeRedViewTimeMsSum":{"type":"string"},"youtubeEngagedViewsCount":{"type":"string"},"youtubeAverageViewPercentage":{"type":"number"},"youtubeCardClicksCount":{"type":"string"},"youtubeCardImpressionsCount":{"type":"string"},"youtubeCardClickRate":{"type":"number"},"youtubeCardTeaserClicksCount":{"type":"string"},"youtubeCardTeaserImpressionsCount":{"type":"string"},"youtubeCardTeaserClickRate":{"type":"number"},"youtubeAnnotationClicksCount":{"type":"string"},"youtubeAnnotationClickableImpressionsCount":{"type":"string"},"youtubeAnnotationClosesCount":{"type":"string"},"youtubeAnnotationClosableImpressionsCount":{"type":"string"},"youtubeAnnotationImpressionsCount":{"type":"string"},"youtubeAnnotationClickThroughRate":{"type":"number"},"youtubeAnnotationCloseRate":{"type":"number"}}}},"required":["fetchedAt","metrics"]},"metricsHistory":{"type":"array","items":{"type":"object","properties":{"fetchedAt":{"description":"ISO 8601 timestamp when metrics were captured.","type":"string"},"metrics":{"type":"object","properties":{"clicksCount":{"type":"string"},"commentsCount":{"type":"string"},"followsCount":{"type":"string"},"impressionsCount":{"type":"string"},"interactionsSum":{"type":"string"},"likesCount":{"type":"string"},"navigationsCount":{"type":"string"},"playsCount":{"type":"string"},"profileActivityCount":{"type":"string"},"profileVisitsCount":{"type":"string"},"reachCount":{"type":"string"},"repliesCount":{"type":"string"},"savesCount":{"type":"string"},"sharesCount":{"type":"string"},"viewTimeMsSum":{"type":"string"},"viewsCount":{"type":"string"},"watchTimeMsAvg":{"type":"string"},"twitterRetweetsCount":{"type":"string"},"twitterQuotesCount":{"type":"string"},"blueskyRepostsCount":{"type":"string"},"blueskyQuotesCount":{"type":"string"},"threadsRepostsCount":{"type":"string"},"threadsQuotesCount":{"type":"string"},"linkedinFirstLevelCommentsCount":{"type":"string"},"linkedinReactionsByType":{"type":"object","additionalProperties":{"type":"string"}},"pinterestPinClicksCount":{"type":"string"},"pinterestReactionsCount":{"type":"string"},"pinterestVideoP95ViewsCount":{"type":"string"},"pinterestVideo10sViewsCount":{"type":"string"},"pinterestVideoMrcViewsCount":{"type":"string"},"pinterestVideoV50WatchTimeMsSum":{"type":"string"},"pinterestSaveRate":{"type":"number"},"twitterPerMediaVideoViewsCount":{"type":"array","items":{"type":"string","nullable":true}},"twitterPerMediaVideoPlaybackStartCount":{"type":"array","items":{"type":"string","nullable":true}},"twitterPerMediaVideoPlayback25Count":{"type":"array","items":{"type":"string","nullable":true}},"twitterPerMediaVideoPlayback50Count":{"type":"array","items":{"type":"string","nullable":true}},"twitterPerMediaVideoPlayback75Count":{"type":"array","items":{"type":"string","nullable":true}},"twitterPerMediaVideoPlaybackCompleteCount":{"type":"array","items":{"type":"string","nullable":true}},"facebookPostMediaViewsCount":{"type":"string"},"facebookPostMediaViewsUniqueCount":{"type":"string"},"facebookPostReactionsByType":{"type":"object","additionalProperties":{"type":"string"}},"facebookBlueReelsPlaysCount":{"type":"string"},"facebookFbReelsReplaysCount":{"type":"string"},"facebookFbReelsTotalPlaysCount":{"type":"string"},"facebookPostVideoWatchTimeMsAvg":{"type":"string"},"facebookPostVideoFollowersCount":{"type":"string"},"facebookPostVideoLikesByReactionType":{"type":"object","additionalProperties":{"type":"string"}},"facebookPostVideoSocialActionsByType":{"type":"object","additionalProperties":{"type":"string"}},"facebookPostVideoViewTimeMsSum":{"type":"string"},"facebookTotalVideoViewsCount":{"type":"string"},"facebookTotalVideoViewsUniqueCount":{"type":"string"},"facebookTotalVideoViewsAutoplayedCount":{"type":"string"},"facebookTotalVideoViewsClickedToPlayCount":{"type":"string"},"facebookTotalVideoViewsSoundOnCount":{"type":"string"},"facebookTotalVideoCompleteViewsCount":{"type":"string"},"facebookTotalVideoCompleteViewsUniqueCount":{"type":"string"},"facebookTotalVideoCompleteViewsAutoplayedCount":{"type":"string"},"facebookTotalVideoCompleteViewsClickedToPlayCount":{"type":"string"},"facebookTotalVideoCompleteViewsOrganicCount":{"type":"string"},"facebookTotalVideoCompleteViewsOrganicUniqueCount":{"type":"string"},"facebookTotalVideoCompleteViewsPaidCount":{"type":"string"},"facebookTotalVideoCompleteViewsPaidUniqueCount":{"type":"string"},"facebookTotalVideoViews10sCount":{"type":"string"},"facebookTotalVideoViews10sUniqueCount":{"type":"string"},"facebookTotalVideoViews10sAutoplayedCount":{"type":"string"},"facebookTotalVideoViews10sClickedToPlayCount":{"type":"string"},"facebookTotalVideoViews10sOrganicCount":{"type":"string"},"facebookTotalVideoViews10sPaidCount":{"type":"string"},"facebookTotalVideoViews10sSoundOnCount":{"type":"string"},"facebookTotalVideoViews15sCount":{"type":"string"},"facebookTotalVideoViews60sExcludesShorterCount":{"type":"string"},"facebookTotalVideoWatchTimeMsAvg":{"type":"string"},"facebookTotalVideoViewTimeMsSum":{"type":"string"},"facebookTotalVideoViewTimeOrganicMsSum":{"type":"string"},"facebookTotalVideoViewTimePaidMsSum":{"type":"string"},"facebookTotalVideoStoriesByActionType":{"type":"object","additionalProperties":{"type":"string"}},"facebookTotalVideoReactionsByType":{"type":"object","additionalProperties":{"type":"string"}},"facebookTotalVideoViewTimeMsByAgeBucketAndGender":{"type":"object","additionalProperties":{"type":"string"}},"facebookTotalVideoViewTimeMsByRegionId":{"type":"object","additionalProperties":{"type":"string"}},"facebookTotalVideoViewsByDistributionType":{"type":"object","additionalProperties":{"type":"string"}},"youtubeDislikesCount":{"type":"string"},"youtubeSubscribersLostCount":{"type":"string"},"youtubeVideosAddedToPlaylistsCount":{"type":"string"},"youtubeVideosRemovedFromPlaylistsCount":{"type":"string"},"youtubeRedViewsCount":{"type":"string"},"youtubeRedViewTimeMsSum":{"type":"string"},"youtubeEngagedViewsCount":{"type":"string"},"youtubeAverageViewPercentage":{"type":"number"},"youtubeCardClicksCount":{"type":"string"},"youtubeCardImpressionsCount":{"type":"string"},"youtubeCardClickRate":{"type":"number"},"youtubeCardTeaserClicksCount":{"type":"string"},"youtubeCardTeaserImpressionsCount":{"type":"string"},"youtubeCardTeaserClickRate":{"type":"number"},"youtubeAnnotationClicksCount":{"type":"string"},"youtubeAnnotationClickableImpressionsCount":{"type":"string"},"youtubeAnnotationClosesCount":{"type":"string"},"youtubeAnnotationClosableImpressionsCount":{"type":"string"},"youtubeAnnotationImpressionsCount":{"type":"string"},"youtubeAnnotationClickThroughRate":{"type":"number"},"youtubeAnnotationCloseRate":{"type":"number"}}}},"required":["fetchedAt","metrics"]}}},"required":["id","content","postUrl","platform","createdAt","mediaUrls","metricsHistory"]}}},"required":["items"]}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"description":"Validation error","type":"object","properties":{"code":{"type":"number"},"reqId":{"description":"Request ID for tracking","type":"string"},"message":{"description":"Validation error","type":"string"}},"required":["message"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"description":"Server error","type":"object","properties":{"code":{"type":"number"},"reqId":{"description":"Request ID for tracking","type":"string"},"message":{"description":"An error occurred","type":"string"}},"required":["message"]}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.blotato.com/api/openapi-reference/analytics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.