---
title: "List top performing posts"
method: GET
path: "/v2/analytics"
tags: ["analytics"]
---

# List top performing posts

`GET /v2/analytics`

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

## Query parameters

- `since` string
- `until` string
- `platform` string
- `sortBy` 'likes_count' | 'comments_count' | 'views_count' | 'reach_count'
- `limit` integer

## Response `200`

Default Response

- object
  - `items` object[], required
    - `id` string, required
    - `content` string, required
    - `postUrl` string, nullable, required
    - `platform` 'twitter' | 'instagram' | 'linkedin' | 'facebook' | 'tiktok' | 'pinterest' | 'threads' | 'bluesky' | 'youtube' | 'other', required — Social media platform
    - `createdAt` string, required
    - `mediaUrls` string[], required
    - `latestMetrics` object
      - `fetchedAt` string, required — ISO 8601 timestamp when metrics were captured.
      - `metrics` object, required
        - `clicksCount` string
        - `commentsCount` string
        - `followsCount` string
        - `impressionsCount` string
        - `interactionsSum` string
        - `likesCount` string
        - `navigationsCount` string
        - `playsCount` string
        - `profileActivityCount` string
        - `profileVisitsCount` string
        - `reachCount` string
        - `repliesCount` string
        - `savesCount` string
        - `sharesCount` string
        - `viewTimeMsSum` string
        - `viewsCount` string
        - `watchTimeMsAvg` string
        - `twitterRetweetsCount` string
        - `twitterQuotesCount` string
        - `blueskyRepostsCount` string
        - `blueskyQuotesCount` string
        - `threadsRepostsCount` string
        - `threadsQuotesCount` string
        - `linkedinFirstLevelCommentsCount` string
        - `linkedinReactionsByType` object
        - `pinterestPinClicksCount` string
        - `pinterestReactionsCount` string
        - `pinterestVideoP95ViewsCount` string
        - `pinterestVideo10sViewsCount` string
        - `pinterestVideoMrcViewsCount` string
        - `pinterestVideoV50WatchTimeMsSum` string
        - `pinterestSaveRate` number
        - `twitterPerMediaVideoViewsCount` string[]
        - `twitterPerMediaVideoPlaybackStartCount` string[]
        - `twitterPerMediaVideoPlayback25Count` string[]
        - `twitterPerMediaVideoPlayback50Count` string[]
        - `twitterPerMediaVideoPlayback75Count` string[]
        - `twitterPerMediaVideoPlaybackCompleteCount` string[]
        - `facebookPostMediaViewsCount` string
        - `facebookPostMediaViewsUniqueCount` string
        - `facebookPostReactionsByType` object
        - `facebookBlueReelsPlaysCount` string
        - `facebookFbReelsReplaysCount` string
        - `facebookFbReelsTotalPlaysCount` string
        - `facebookPostVideoWatchTimeMsAvg` string
        - `facebookPostVideoFollowersCount` string
        - `facebookPostVideoLikesByReactionType` object
        - `facebookPostVideoSocialActionsByType` object
        - `facebookPostVideoViewTimeMsSum` string
        - `facebookTotalVideoViewsCount` string
        - `facebookTotalVideoViewsUniqueCount` string
        - `facebookTotalVideoViewsAutoplayedCount` string
        - `facebookTotalVideoViewsClickedToPlayCount` string
        - `facebookTotalVideoViewsSoundOnCount` string
        - `facebookTotalVideoCompleteViewsCount` string
        - `facebookTotalVideoCompleteViewsUniqueCount` string
        - `facebookTotalVideoCompleteViewsAutoplayedCount` string
        - `facebookTotalVideoCompleteViewsClickedToPlayCount` string
        - `facebookTotalVideoCompleteViewsOrganicCount` string
        - `facebookTotalVideoCompleteViewsOrganicUniqueCount` string
        - `facebookTotalVideoCompleteViewsPaidCount` string
        - `facebookTotalVideoCompleteViewsPaidUniqueCount` string
        - `facebookTotalVideoViews10sCount` string
        - `facebookTotalVideoViews10sUniqueCount` string
        - `facebookTotalVideoViews10sAutoplayedCount` string
        - `facebookTotalVideoViews10sClickedToPlayCount` string
        - `facebookTotalVideoViews10sOrganicCount` string
        - `facebookTotalVideoViews10sPaidCount` string
        - `facebookTotalVideoViews10sSoundOnCount` string
        - `facebookTotalVideoViews15sCount` string
        - `facebookTotalVideoViews60sExcludesShorterCount` string
        - `facebookTotalVideoWatchTimeMsAvg` string
        - `facebookTotalVideoViewTimeMsSum` string
        - `facebookTotalVideoViewTimeOrganicMsSum` string
        - `facebookTotalVideoViewTimePaidMsSum` string
        - `facebookTotalVideoStoriesByActionType` object
        - `facebookTotalVideoReactionsByType` object
        - `facebookTotalVideoViewTimeMsByAgeBucketAndGender` object
        - `facebookTotalVideoViewTimeMsByRegionId` object
        - `facebookTotalVideoViewsByDistributionType` object
        - `youtubeDislikesCount` string
        - `youtubeSubscribersLostCount` string
        - `youtubeVideosAddedToPlaylistsCount` string
        - `youtubeVideosRemovedFromPlaylistsCount` string
        - `youtubeRedViewsCount` string
        - `youtubeRedViewTimeMsSum` string
        - `youtubeEngagedViewsCount` string
        - `youtubeAverageViewPercentage` number
        - `youtubeCardClicksCount` string
        - `youtubeCardImpressionsCount` string
        - `youtubeCardClickRate` number
        - `youtubeCardTeaserClicksCount` string
        - `youtubeCardTeaserImpressionsCount` string
        - `youtubeCardTeaserClickRate` number
        - `youtubeAnnotationClicksCount` string
        - `youtubeAnnotationClickableImpressionsCount` string
        - `youtubeAnnotationClosesCount` string
        - `youtubeAnnotationClosableImpressionsCount` string
        - `youtubeAnnotationImpressionsCount` string
        - `youtubeAnnotationClickThroughRate` number
        - `youtubeAnnotationCloseRate` number
    - `metricsHistory` object[], required
      - `fetchedAt` string, required — ISO 8601 timestamp when metrics were captured.
      - `metrics` object, required
        - `clicksCount` string
        - `commentsCount` string
        - `followsCount` string
        - `impressionsCount` string
        - `interactionsSum` string
        - `likesCount` string
        - `navigationsCount` string
        - `playsCount` string
        - `profileActivityCount` string
        - `profileVisitsCount` string
        - `reachCount` string
        - `repliesCount` string
        - `savesCount` string
        - `sharesCount` string
        - `viewTimeMsSum` string
        - `viewsCount` string
        - `watchTimeMsAvg` string
        - `twitterRetweetsCount` string
        - `twitterQuotesCount` string
        - `blueskyRepostsCount` string
        - `blueskyQuotesCount` string
        - `threadsRepostsCount` string
        - `threadsQuotesCount` string
        - `linkedinFirstLevelCommentsCount` string
        - `linkedinReactionsByType` object
        - `pinterestPinClicksCount` string
        - `pinterestReactionsCount` string
        - `pinterestVideoP95ViewsCount` string
        - `pinterestVideo10sViewsCount` string
        - `pinterestVideoMrcViewsCount` string
        - `pinterestVideoV50WatchTimeMsSum` string
        - `pinterestSaveRate` number
        - `twitterPerMediaVideoViewsCount` string[]
        - `twitterPerMediaVideoPlaybackStartCount` string[]
        - `twitterPerMediaVideoPlayback25Count` string[]
        - `twitterPerMediaVideoPlayback50Count` string[]
        - `twitterPerMediaVideoPlayback75Count` string[]
        - `twitterPerMediaVideoPlaybackCompleteCount` string[]
        - `facebookPostMediaViewsCount` string
        - `facebookPostMediaViewsUniqueCount` string
        - `facebookPostReactionsByType` object
        - `facebookBlueReelsPlaysCount` string
        - `facebookFbReelsReplaysCount` string
        - `facebookFbReelsTotalPlaysCount` string
        - `facebookPostVideoWatchTimeMsAvg` string
        - `facebookPostVideoFollowersCount` string
        - `facebookPostVideoLikesByReactionType` object
        - `facebookPostVideoSocialActionsByType` object
        - `facebookPostVideoViewTimeMsSum` string
        - `facebookTotalVideoViewsCount` string
        - `facebookTotalVideoViewsUniqueCount` string
        - `facebookTotalVideoViewsAutoplayedCount` string
        - `facebookTotalVideoViewsClickedToPlayCount` string
        - `facebookTotalVideoViewsSoundOnCount` string
        - `facebookTotalVideoCompleteViewsCount` string
        - `facebookTotalVideoCompleteViewsUniqueCount` string
        - `facebookTotalVideoCompleteViewsAutoplayedCount` string
        - `facebookTotalVideoCompleteViewsClickedToPlayCount` string
        - `facebookTotalVideoCompleteViewsOrganicCount` string
        - `facebookTotalVideoCompleteViewsOrganicUniqueCount` string
        - `facebookTotalVideoCompleteViewsPaidCount` string
        - `facebookTotalVideoCompleteViewsPaidUniqueCount` string
        - `facebookTotalVideoViews10sCount` string
        - `facebookTotalVideoViews10sUniqueCount` string
        - `facebookTotalVideoViews10sAutoplayedCount` string
        - `facebookTotalVideoViews10sClickedToPlayCount` string
        - `facebookTotalVideoViews10sOrganicCount` string
        - `facebookTotalVideoViews10sPaidCount` string
        - `facebookTotalVideoViews10sSoundOnCount` string
        - `facebookTotalVideoViews15sCount` string
        - `facebookTotalVideoViews60sExcludesShorterCount` string
        - `facebookTotalVideoWatchTimeMsAvg` string
        - `facebookTotalVideoViewTimeMsSum` string
        - `facebookTotalVideoViewTimeOrganicMsSum` string
        - `facebookTotalVideoViewTimePaidMsSum` string
        - `facebookTotalVideoStoriesByActionType` object
        - `facebookTotalVideoReactionsByType` object
        - `facebookTotalVideoViewTimeMsByAgeBucketAndGender` object
        - `facebookTotalVideoViewTimeMsByRegionId` object
        - `facebookTotalVideoViewsByDistributionType` object
        - `youtubeDislikesCount` string
        - `youtubeSubscribersLostCount` string
        - `youtubeVideosAddedToPlaylistsCount` string
        - `youtubeVideosRemovedFromPlaylistsCount` string
        - `youtubeRedViewsCount` string
        - `youtubeRedViewTimeMsSum` string
        - `youtubeEngagedViewsCount` string
        - `youtubeAverageViewPercentage` number
        - `youtubeCardClicksCount` string
        - `youtubeCardImpressionsCount` string
        - `youtubeCardClickRate` number
        - `youtubeCardTeaserClicksCount` string
        - `youtubeCardTeaserImpressionsCount` string
        - `youtubeCardTeaserClickRate` number
        - `youtubeAnnotationClicksCount` string
        - `youtubeAnnotationClickableImpressionsCount` string
        - `youtubeAnnotationClosesCount` string
        - `youtubeAnnotationClosableImpressionsCount` string
        - `youtubeAnnotationImpressionsCount` string
        - `youtubeAnnotationClickThroughRate` number
        - `youtubeAnnotationCloseRate` number

## Other responses

- `403` — Forbidden
- `422` — Validation error
- `500` — Server error

---

[API](https://skmtc.net/blotato/apis/blotato-api.md) · [All operations](https://skmtc.net/blotato/apis/blotato-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blotato/blotato-api/revisions/c93447ba6b9d/schema)