Analytics

Get post analytics

Returns analytics for posts. With postId, returns a single post. Without it, returns a paginated list with overview stats. Accepts both Zernio Post IDs and External Post IDs (auto-resolved). fromDate defaults to 90 days ago if omitted, max range 366 days. Single post lookups may return 202 (sync pending) or 424 (all platforms failed). For follower stats, use /v1/accounts/follower-stats.

LinkedIn personal accounts: Analytics are only available for posts published through Zernio. LinkedIn's API only returns metrics for posts authored by the authenticated user. Organization/company page analytics work for all posts.

get/v1/analytics

Query parameters

postIdstring

Returns analytics for a single post. Accepts both Zernio Post IDs and External Post IDs. Zernio IDs are auto-resolved to External Post analytics.

platformstring

Filter by platform (default "all")

profileIdstring

Filter by profile ID (default "all")

accountIdstring

Filter by social account ID

source'all' | 'late' | 'external'

Filter by post source: late (posted via Zernio API), external (synced from platform), all (default)

fromDatestring date

Inclusive lower bound (YYYY-MM-DD). Defaults to 90 days ago if omitted. Max range is 366 days.

toDatestring date

Inclusive upper bound (YYYY-MM-DD). Defaults to today if omitted.

limitinteger

Page size (default 50)

pageinteger

Page number (default 1)

sortBy'date' | 'engagement' | 'impressions' | 'reach' | 'likes' | 'comments' | 'shares' | 'saves' | 'clicks' | 'views' | 'follows' | 'ig_reels_avg_watch_time' | 'ig_reels_video_view_total_time' | 'reposts' | 'reels_skip_rate'

Sort by date, engagement, or a specific metric. Instagram-only metrics (follows, reposts, reels_skip_rate, ig_reels_*) sort a null value as 0.

order'asc' | 'desc'

Sort order

Response

Analytics result

OR

Example response

{
  "analytics": {
    "reelsSkipRate": 48.8,
    "videoDurationSeconds": 30,
    "engagementRate": 6.59
  },
  "platformAnalytics": [
    {
      "analytics": {
        "reelsSkipRate": 48.8,
        "videoDurationSeconds": 30,
        "engagementRate": 6.59
      }
    }
  ]
}

Changes

Changed in 6 of the 26 revisions of this API.14642

    • the response property analytics/follows became nullable for the status 202

      response-property-became-nullable

    • the response property analytics/follows became nullable for the status 424

      response-property-became-nullable

    • the response property oneOf[AnalyticsListResponse]/posts/items/analytics/follows became nullable for the status 200

      response-property-became-nullable

    • the response property oneOf[AnalyticsListResponse]/posts/items/platforms/items/analytics/anyOf[PostAnalytics]/follows became nullable for the status 200

      response-property-became-nullable

    • the response property oneOf[AnalyticsSinglePostResponse]/analytics/follows became nullable for the status 200

      response-property-became-nullable

    • the response property oneOf[AnalyticsSinglePostResponse]/platformAnalytics/items/analytics/anyOf[PostAnalytics]/follows became nullable for the status 200

      response-property-became-nullable

    • the response property platformAnalytics/items/analytics/anyOf[PostAnalytics]/follows became nullable for the status 202

      response-property-became-nullable

    • the response property platformAnalytics/items/analytics/anyOf[PostAnalytics]/follows became nullable for the status 424

      response-property-became-nullable

    • added the new enum value ig_reels_avg_watch_time to the query request parameter sortBy

      request-parameter-enum-value-added

    • added the new enum value ig_reels_video_view_total_time to the query request parameter sortBy

      request-parameter-enum-value-added

    • added the new enum value reels_skip_rate to the query request parameter sortBy

      request-parameter-enum-value-added

    • added the new enum value reposts to the query request parameter sortBy

      request-parameter-enum-value-added

    • added the optional property analytics/reelsSkipRate to the response with the 202 status

      response-optional-property-added

    • added the optional property analytics/reelsSkipRate to the response with the 424 status

      response-optional-property-added

    • added the optional property analytics/reposts to the response with the 202 status

      response-optional-property-added

    • added the optional property analytics/reposts to the response with the 424 status

      response-optional-property-added

    • added the optional property oneOf[AnalyticsListResponse]/posts/items/analytics/reelsSkipRate to the response with the 200 status

      response-optional-property-added

    • added the optional property oneOf[AnalyticsListResponse]/posts/items/analytics/reposts to the response with the 200 status

      response-optional-property-added

    • added the optional property oneOf[AnalyticsListResponse]/posts/items/platforms/items/analytics/anyOf[PostAnalytics]/reelsSkipRate to the response with the 200 status

      response-optional-property-added

    • added the optional property oneOf[AnalyticsListResponse]/posts/items/platforms/items/analytics/anyOf[PostAnalytics]/reposts to the response with the 200 status

      response-optional-property-added

    • added the optional property oneOf[AnalyticsSinglePostResponse]/analytics/reelsSkipRate to the response with the 200 status

      response-optional-property-added

    • added the optional property oneOf[AnalyticsSinglePostResponse]/analytics/reposts to the response with the 200 status

      response-optional-property-added

    • added the optional property oneOf[AnalyticsSinglePostResponse]/platformAnalytics/items/analytics/anyOf[PostAnalytics]/reelsSkipRate to the response with the 200 status

      response-optional-property-added

    • added the optional property oneOf[AnalyticsSinglePostResponse]/platformAnalytics/items/analytics/anyOf[PostAnalytics]/reposts to the response with the 200 status

      response-optional-property-added

    • added the optional property platformAnalytics/items/analytics/anyOf[PostAnalytics]/reelsSkipRate to the response with the 202 status

      response-optional-property-added

    • added the optional property platformAnalytics/items/analytics/anyOf[PostAnalytics]/reelsSkipRate to the response with the 424 status

      response-optional-property-added

    • added the optional property platformAnalytics/items/analytics/anyOf[PostAnalytics]/reposts to the response with the 202 status

      response-optional-property-added

    • added the optional property platformAnalytics/items/analytics/anyOf[PostAnalytics]/reposts to the response with the 424 status

      response-optional-property-added

    • added the optional property isAiGenerated to the response with the 202 status

      response-optional-property-added

    • added the optional property isAiGenerated to the response with the 424 status

      response-optional-property-added

    • added the optional property isSharedToFeed to the response with the 202 status

      response-optional-property-added

    • added the optional property isSharedToFeed to the response with the 424 status

      response-optional-property-added

    • added the optional property mediaAudioType to the response with the 202 status

      response-optional-property-added

    • added the optional property mediaAudioType to the response with the 424 status

      response-optional-property-added

    • added the optional property mediaProductType to the response with the 202 status

      response-optional-property-added

    • added the optional property mediaProductType to the response with the 424 status

      response-optional-property-added

    • added the optional property oneOf[AnalyticsListResponse]/posts/items/isAiGenerated to the response with the 200 status

      response-optional-property-added

    • added the optional property oneOf[AnalyticsListResponse]/posts/items/isSharedToFeed to the response with the 200 status

      response-optional-property-added

    • added the optional property oneOf[AnalyticsListResponse]/posts/items/mediaAudioType to the response with the 200 status

      response-optional-property-added

    • added the optional property oneOf[AnalyticsListResponse]/posts/items/mediaProductType to the response with the 200 status

      response-optional-property-added

    • added the optional property oneOf[AnalyticsSinglePostResponse]/isAiGenerated to the response with the 200 status

      response-optional-property-added

    • added the optional property oneOf[AnalyticsSinglePostResponse]/isSharedToFeed to the response with the 200 status

      response-optional-property-added

    • added the optional property oneOf[AnalyticsSinglePostResponse]/mediaAudioType to the response with the 200 status

      response-optional-property-added

    • added the optional property oneOf[AnalyticsSinglePostResponse]/mediaProductType to the response with the 200 status

      response-optional-property-added

    • added the new available enum value to the mediaItems/items/mediaStatus response property for the response status 202

      response-property-enum-value-added

    • added the new available enum value to the mediaItems/items/mediaStatus response property for the response status 424

      response-property-enum-value-added

    • added the new available enum value to the oneOf[AnalyticsSinglePostResponse]/mediaItems/items/mediaStatus response property for the response status 200

      response-property-enum-value-added

    • added the new phone enum value to the oneOf[AnalyticsListResponse]/accounts/items/platform response property for the response status 200

      response-property-enum-value-added

    • added the new rcs enum value to the oneOf[AnalyticsListResponse]/accounts/items/platform response property for the response status 200

      response-property-enum-value-added

    • added the new sms enum value to the oneOf[AnalyticsListResponse]/accounts/items/platform response property for the response status 200

      response-property-enum-value-added

  • 5b168c06d50566See the full diff
    • the response property mediaItems/items/thumbnail became nullable for the status 202

      response-property-became-nullable

    • the response property mediaItems/items/thumbnail became nullable for the status 424

      response-property-became-nullable

    • the response property mediaItems/items/url became nullable for the status 202

      response-property-became-nullable

    • the response property mediaItems/items/url became nullable for the status 424

      response-property-became-nullable

    • the response property oneOf[AnalyticsSinglePostResponse]/mediaItems/items/thumbnail became nullable for the status 200

      response-property-became-nullable

    • the response property oneOf[AnalyticsSinglePostResponse]/mediaItems/items/url became nullable for the status 200

      response-property-became-nullable

    • added the optional property mediaItems/items/mediaStatus to the response with the 202 status

      response-optional-property-added

    • added the optional property mediaItems/items/mediaStatus to the response with the 424 status

      response-optional-property-added

    • added the optional property mediaItems/items/unavailableReason to the response with the 202 status

      response-optional-property-added

    • added the optional property mediaItems/items/unavailableReason to the response with the 424 status

      response-optional-property-added

    • added the optional property oneOf[AnalyticsSinglePostResponse]/mediaItems/items/mediaStatus to the response with the 200 status

      response-optional-property-added

    • added the optional property oneOf[AnalyticsSinglePostResponse]/mediaItems/items/unavailableReason to the response with the 200 status

      response-optional-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog