Skip to content

Get Post Analytics API

The Get Post Analytics API retrieves live metrics for one published post or for a paginated set of published posts. Get post analytics is a post analytics API operation for retrieving live metrics for one published post or for a paginated set of published posts. Use GET {{API_BASE_URL}}/v1/analytics/ when you need current engagement and reach figures rather than stored summaries, and plan for a cost of 1 credit per call.

Get post analytics — GET {{API_BASE_URL}}/v1/analytics/

Get post analytics returns live analytics for a single post when postId is supplied. When postId is omitted, the same endpoint returns a paginated list of published posts for an account, using stored post metadata as the list source and then fetching metrics live for the returned page. Each call costs 1 credit, so list calls should be sized deliberately with limit and page rather than repeatedly fetching large pages. The date range defaults to the last 90 days when fromDate is omitted, ends today when toDate is omitted, and must not exceed 366 days.

Authorization

Authenticate every request with the x-access-key header. Send the token as the header value, for example x-access-key: <token>. If authentication fails, treat the response as an error case and check the header name and token value before changing any query parameters, because the endpoint contract identifies this header as the access key location.

Query Parameters

Choose the mode before building the query string. For a single post, supply postId, which may be a stored post ID or an external platform post ID that is auto-resolved. For a list, omit postId and supply accountId, which is the integration ID and is required for list requests. The source parameter selects lookup mode for a single post: source=platform is supported only with postId and also requires accountId, so sync external posts before listing them if they need to appear in list results. The platform parameter filters by one of twitter, instagram, youtube, tiktok, pinterest, linkedin, bluesky, facebook, threads, or googlebusiness when a platform-specific view is needed.

Input contract and conditional requirements

Use fromDate and toDate as inclusive YYYY-MM-DD dates, with fromDate defaulting to 90 days ago and toDate defaulting to today. Keep the range within 366 days. Use sortBy to sort list results by date, likes, comments, impressions, views, shares, saves, clicks, or engagement, with date as the default, and use order as asc or desc. Use limit for page size from 1 to 100 with a default of 50, and page starting at 1 with a default of 1. A common failure is requesting a list without accountId, or requesting source=platform without both postId and accountId; check those conditional requirements first when a request is rejected.

Response Body

A single-post 200 response contains success and a post object. The post object includes source, postId, content, publishedAt, aggregated metrics, and a platforms array, with origin, mediaType, and thumbnailUrl present when available. A paginated list 200 response instead contains success, total, page, limit, and a posts array whose items use the same post shape. Read aggregated for cross-platform totals and read each platforms entry for platform-specific metrics, platformPostId, and platformPostUrl.

Reading aggregated and per-platform metrics

Metric fields are nullable numbers, so handle null values explicitly instead of assuming every platform reports every metric. engagementRate is reported on a 0-1 scale and may be null when the platform does not report engagement. avgWatchTime, totalWatchTime, and skipRate are Instagram Reels fields: avgWatchTime is average watch time per view in seconds, totalWatchTime is total watch time in seconds including replays and may be null, and skipRate is the share of views that skipped past the reel and may be null for other media or platforms or when no value is available yet. mediaType, when present, is one of image, video, reel, or carousel, and publishedAt uses date-time format.

Error responses — 400, 402, 403, 404, 504

Error responses use the shape with success and message. The documented statuses are 400, 402, 403, 404, and 504, each returning application/json with that shape. Check the status first, then inspect message, and verify the conditional inputs for the mode you requested: postId for single-post lookups, accountId for lists and for source=platform, a valid platform enum value, dates within the 366-day maximum, and limit and page within their ranges.

Request examples

The request examples show the same GET {{API_BASE_URL}}/v1/analytics/ call in cURL, JavaScript, Go, Python, Java, and C#, with the x-access-key header and placeholders for the token and identifiers. Replace <token>, <postId>, and <accountId> with your own values, keep the trailing slash on /v1/analytics/, and add query parameters only for the mode you intend to call. For a single post, start with postId; for a list, start with accountId and add fromDate, toDate, sortBy, order, limit, and page as needed.

Query parameters for GET {{API_BASE_URL}}/v1/analytics/
ParameterTypeRequiredDescription / constraints
postIdstringNoStored post ID or external platform post ID (auto-resolved). When omitted, returns a paginated list of all published posts with analytics.
platformstringNoOne of "twitter" | "instagram" | "youtube" | "tiktok" | "pinterest" | "linkedin" | "bluesky" | "facebook" | "threads" | "googlebusiness"
accountIdstringNoIntegration ID. Required for list requests and source=platform single-post requests.
sourcestringNoOne of "postpeer" | "platform". "platform" requires postId and accountId and is supported only with postId. List requests always fetch live metrics for stored post metadata and require accountId.
fromDatestringNoInclusive start date (YYYY-MM-DD), format date. Defaults to 90 days ago. Maximum range 366 days.
toDatestringNoInclusive end date (YYYY-MM-DD), format date. Defaults to today.
sortBystringNoDefault "date". One of "date" | "likes" | "comments" | "impressions" | "views" | "shares" | "saves" | "clicks" | "engagement"
orderstringNoOne of "asc" | "desc"
limitintegerNoPage size, default 50, range 1 <= value <= 100
pageintegerNoPage number for account-scoped stored post metadata, default 1, range 1 <= value. Metrics are fetched live for each returned page.

All query parameters are optional in the schema; accountId is conditionally required for list requests and for source=platform single-post requests.

Single-post response fields
FieldTypeRequiredNotes
successbooleanYesTop-level success flag
post.sourcestringYes"postpeer" | "platform"
post.originstringNo"postpeer" | "external". Where a stored post was originally published; present when source=postpeer.
post.postIdstring | nullYesStored post ID; external synced posts also receive an ID. Null only when source=platform is fetched live.
post.contentstring | nullYesPost content
post.publishedAtstring | null (date-time)YesPublish timestamp
post.mediaTypestring | nullNo"image" | "video" | "reel" | "carousel" | null. Normalized media type when the platform exposes it.
post.thumbnailUrlstring | nullNoPost thumbnail or representative media URL, if available
post.aggregatedobjectYesAggregated metrics object
post.platformsarray<object>YesPer-platform entries with platform, platformPostId, platformPostUrl, and metrics

Single-post response uses post; list response uses posts[] with the same item shape.

Paginated list response fields
FieldTypeRequiredNotes
successbooleanYesTop-level success flag
totalintegerYesTotal matched posts across all pages, 0 <= value
pageintegerYesCurrent page, 1 <= value
limitintegerYesPage size, 1 <= value
postsarray<object>YesPost objects with the same shape as the single-post post object

List variant of the 200 response when postId is omitted.

Metric fields in aggregated and per-platform metrics
FieldTypeRequiredNotes
impressionsnumber | nullYesImpressions
reachnumber | nullYesReach
likesnumber | nullYesLikes
commentsnumber | nullYesComments
sharesnumber | nullYesShares
savesnumber | nullYesSaves
clicksnumber | nullYesClicks
viewsnumber | nullYesViews
engagementRatenumber | nullYesEngagement rate (0-1). Null when the platform does not report engagement.
avgWatchTimenumber | nullNoInstagram Reels only. Average watch time per view, in seconds. Null for other media/platforms.
totalWatchTimenumber | nullNoInstagram Reels only. Total watch time in seconds, including replays. May be null.
skipRatenumber | nullNoInstagram Reels only. Share of views that skipped past the reel. Null for other media/platforms or when no value is available yet.

Same metric shape is used for aggregated and for each platforms[].metrics entry.

Error responses
StatusContent typeBody shape
400application/json{"success": true, "message": "string"}
402application/json{"success": true, "message": "string"}
403application/json{"success": true, "message": "string"}
404application/json{"success": true, "message": "string"}
504application/json{"success": true, "message": "string"}

Per-status message semantics are not specified in the source; do not infer them.

cURL request for Get post analytics
curl -X GET "{{API_BASE_URL}}/v1/analytics/" \
  -H "x-access-key: <token>"
cURL single-post request with postId
curl -X GET "{{API_BASE_URL}}/v1/analytics/?postId=<postId>" \
  -H "x-access-key: <token>"
cURL paginated list request with accountId
curl -X GET "{{API_BASE_URL}}/v1/analytics/?accountId=<accountId>&fromDate=2025-01-01&toDate=2025-03-31&sortBy=engagement&order=desc&limit=50&page=1" \
  -H "x-access-key: <token>"
200 single-post response example
{
  "success": true,
  "post": {
    "source": "postpeer",
    "origin": "postpeer",
    "postId": "string",
    "content": "string",
    "publishedAt": "2019-08-24T14:15:22Z",
    "mediaType": "image",
    "thumbnailUrl": "string",
    "aggregated": {
      "impressions": 0,
      "reach": 0,
      "likes": 0,
      "comments": 0,
      "shares": 0,
      "saves": 0,
      "clicks": 0,
      "views": 0,
      "engagementRate": 0,
      "avgWatchTime": 0,
      "totalWatchTime": 0,
      "skipRate": 0
    },
    "platforms": [
      {
        "platform": "twitter",
        "platformPostId": "string",
        "platformPostUrl": "string",
        "metrics": {
          "impressions": 0,
          "reach": 0,
          "likes": 0,
          "comments": 0,
          "shares": 0,
          "saves": 0,
          "clicks": 0,
          "views": 0,
          "engagementRate": 0,
          "avgWatchTime": 0,
          "totalWatchTime": 0,
          "skipRate": 0
        }
      }
    ]
  }
}
Error response shape for 400, 402, 403, 404 and 504
{
  "success": true,
  "message": "string"
}
Interface fields
ScopeFieldTypeType referenceRequiredDescriptionConstraints
postId#1postIdstring__0Nothe service post ID or external platform post ID (auto-resolved). When omitted, returns a paginated list of all published posts with analytics.
platform#2platformstring__0Nokind: schemaValueIn; value: "twitter" | "instagram" | "youtube" | "tiktok" | "pinterest" | "linkedin" | "bluesky" | "facebook" | "threads" | "googlebusiness"
accountId#3accountIdstring__0NoIntegration ID. Required for list requests and source=platform single-post requests.
source#4sourcestring__0NoSelects lookup mode for a single post. "platform" requires postId and accountId. List requests always fetch live metrics for stored post metadata and require accountId.kind: schemaValueIn; value: "postpeer" | "platform"
fromDate#5fromDatestring__0NoInclusive start date (YYYY-MM-DD). Defaults to 90 days ago.kind: schemaFormat; value: date
toDate#6toDatestring__0NoInclusive end date (YYYY-MM-DD). Defaults to today.kind: schemaFormat; value: date
sortBy#7sortBystring__0NoSort results by this metrickind: schemaDefault; value: "date" | kind: schemaValueIn; value: "date" | "likes" | "comments" | "impressions" | "views" | "shares" | "saves" | "clicks" | "engagement"
order#8orderstring__0Nokind: schemaValueIn; value: "asc" | "desc"
limit#9limitinteger__0NoPage size (1-100)kind: schemaDefault; value: 50 | kind: schemaRange; value: 1 <= value <= 100
page#10pageinteger__0NoPage number for account-scoped stored post metadata. Metrics are fetched live for each returned page.kind: schemaDefault; value: 1 | kind: schemaRange; value: 1 <= value
response#11responseobject__0Single-post response (when postId is supplied) or paginated list response.
response#11response[variant1]object__0_extends:__1Single-post response (when postId is supplied) or paginated list response.
response#11response[variant1].successboolean__2Yes
response#11response[variant1].postobject__3Yes
response#11response[variant1].post.sourcestring__4YesSelects lookup mode for a single post. "platform" requires postId and accountId. List requests always fetch live metrics for stored post metadata and require accountId.kind: schemaValueIn; value: "postpeer" | "platform"
response#11response[variant1].post.originstring__5NoWhere a stored post was originally published. Present when source=postpeer.
response#11response[variant1].post.origin[variant1]string__5_extends:__6Where a stored post was originally published. Present when source=postpeer.kind: schemaValueIn; value: "postpeer"
response#11response[variant1].post.origin[variant2]string__5_extends:__7Where a stored post was originally published. Present when source=postpeer.kind: schemaValueIn; value: "external"
response#11response[variant1].post.postIdstring | null__8Yesthe service post ID. External synced posts also receive an ID. null only when source=platform is fetched live.
response#11response[variant1].post.postId[variant1]string__8_type:stringthe service post ID. External synced posts also receive an ID. null only when source=platform is fetched live.
response#11response[variant1].post.postId[variant2]null__8_type:nullthe service post ID. External synced posts also receive an ID. null only when source=platform is fetched live.
response#11response[variant1].post.contentstring | null__9Yes
response#11response[variant1].post.content[variant1]string__9_type:string
response#11response[variant1].post.content[variant2]null__9_type:null
response#11response[variant1].post.publishedAtstring | null__10Yeskind: schemaFormat; value: date-time
response#11response[variant1].post.publishedAt[variant1]string__10_type:stringkind: schemaFormat; value: date-time
response#11response[variant1].post.publishedAt[variant2]null__10_type:nullkind: schemaFormat; value: date-time
response#11response[variant1].post.mediaTypestring | null__11NoNormalized media type when the platform exposes it.
response#11response[variant1].post.mediaType[variant1]string__11_extends:__12Normalized media type when the platform exposes it.kind: schemaValueIn; value: "image"
response#11response[variant1].post.mediaType[variant2]string__11_extends:__13Normalized media type when the platform exposes it.kind: schemaValueIn; value: "video"
response#11response[variant1].post.mediaType[variant3]string__11_extends:__14Normalized media type when the platform exposes it.kind: schemaValueIn; value: "reel"
response#11response[variant1].post.mediaType[variant4]string__11_extends:__15Normalized media type when the platform exposes it.kind: schemaValueIn; value: "carousel"
response#11response[variant1].post.mediaType[variant5]null__11_extends:__16Normalized media type when the platform exposes it.
response#11response[variant1].post.thumbnailUrlstring | null__17NoPost thumbnail or representative media URL, if available.
response#11response[variant1].post.thumbnailUrl[variant1]string__17_type:stringPost thumbnail or representative media URL, if available.
response#11response[variant1].post.thumbnailUrl[variant2]null__17_type:nullPost thumbnail or representative media URL, if available.
response#11response[variant1].post.aggregatedobject__18Yes
response#11response[variant1].post.aggregated.impressionsnumber | null__19Yes
response#11response[variant1].post.aggregated.impressions[variant1]number__19_type:number
response#11response[variant1].post.aggregated.impressions[variant2]null__19_type:null
response#11response[variant1].post.aggregated.reachnumber | null__20Yes
response#11response[variant1].post.aggregated.reach[variant1]number__20_type:number
response#11response[variant1].post.aggregated.reach[variant2]null__20_type:null
response#11response[variant1].post.aggregated.likesnumber | null__21Yes
response#11response[variant1].post.aggregated.likes[variant1]number__21_type:number
response#11response[variant1].post.aggregated.likes[variant2]null__21_type:null
response#11response[variant1].post.aggregated.commentsnumber | null__22Yes
response#11response[variant1].post.aggregated.comments[variant1]number__22_type:number
response#11response[variant1].post.aggregated.comments[variant2]null__22_type:null
response#11response[variant1].post.aggregated.sharesnumber | null__23Yes
response#11response[variant1].post.aggregated.shares[variant1]number__23_type:number
response#11response[variant1].post.aggregated.shares[variant2]null__23_type:null
response#11response[variant1].post.aggregated.savesnumber | null__24Yes
response#11response[variant1].post.aggregated.saves[variant1]number__24_type:number
response#11response[variant1].post.aggregated.saves[variant2]null__24_type:null
response#11response[variant1].post.aggregated.clicksnumber | null__25Yes
response#11response[variant1].post.aggregated.clicks[variant1]number__25_type:number
response#11response[variant1].post.aggregated.clicks[variant2]null__25_type:null
response#11response[variant1].post.aggregated.viewsnumber | null__26Yes
response#11response[variant1].post.aggregated.views[variant1]number__26_type:number
response#11response[variant1].post.aggregated.views[variant2]null__26_type:null
response#11response[variant1].post.aggregated.engagementRatenumber | null__27YesEngagement rate (0-1). null when the platform does not report engagement.
response#11response[variant1].post.aggregated.engagementRate[variant1]number__27_type:numberEngagement rate (0-1). null when the platform does not report engagement.
response#11response[variant1].post.aggregated.engagementRate[variant2]null__27_type:nullEngagement rate (0-1). null when the platform does not report engagement.
response#11response[variant1].post.aggregated.avgWatchTimenumber | null__28NoInstagram Reels only. Average watch time per view, in seconds. null for other media/platforms.
response#11response[variant1].post.aggregated.avgWatchTime[variant1]number__28_type:numberInstagram Reels only. Average watch time per view, in seconds. null for other media/platforms.
response#11response[variant1].post.aggregated.avgWatchTime[variant2]null__28_type:nullInstagram Reels only. Average watch time per view, in seconds. null for other media/platforms.
response#11response[variant1].post.aggregated.totalWatchTimenumber | null__29NoInstagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null.
response#11response[variant1].post.aggregated.totalWatchTime[variant1]number__29_type:numberInstagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null.
response#11response[variant1].post.aggregated.totalWatchTime[variant2]null__29_type:nullInstagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null.
response#11response[variant1].post.aggregated.skipRatenumber | null__30NoInstagram Reels only. Reels skip rate as reported by Meta (reels_skip_rate, added Dec 2025) — the share of views that skipped past the reel. null for other media/platforms or when Meta has no value yet.
response#11response[variant1].post.aggregated.skipRate[variant1]number__30_type:numberInstagram Reels only. Reels skip rate as reported by Meta (reels_skip_rate, added Dec 2025) — the share of views that skipped past the reel. null for other media/platforms or when Meta has no value yet.
response#11response[variant1].post.aggregated.skipRate[variant2]null__30_type:nullInstagram Reels only. Reels skip rate as reported by Meta (reels_skip_rate, added Dec 2025) — the share of views that skipped past the reel. null for other media/platforms or when Meta has no value yet.
response#11response[variant1].post.platformsarray<object>__31Yes
response#11response[variant1].post.platforms[]object__32
response#11response[variant1].post.platforms[].platformstring#/components/schemas/PlatformYeskind: ; value: "twitter" | "instagram" | "youtube" | "tiktok" | "pinterest" | "linkedin" | "bluesky" | "facebook" | "threads" | "googlebusiness"
response#11response[variant1].post.platforms[].platformPostIdstring__33YesNative post ID on the platform
response#11response[variant1].post.platforms[].platformPostUrlstring | null__34YesDirect URL to the published post, if known
response#11response[variant1].post.platforms[].platformPostUrl[variant1]string__34_type:stringDirect URL to the published post, if known
response#11response[variant1].post.platforms[].platformPostUrl[variant2]null__34_type:nullDirect URL to the published post, if known
response#11response[variant1].post.platforms[].metricsobject__35Yes
response#11response[variant1].post.platforms[].metrics.impressionsnumber | null__36Yes
response#11response[variant1].post.platforms[].metrics.impressions[variant1]number__36_type:number
response#11response[variant1].post.platforms[].metrics.impressions[variant2]null__36_type:null
response#11response[variant1].post.platforms[].metrics.reachnumber | null__37Yes
response#11response[variant1].post.platforms[].metrics.reach[variant1]number__37_type:number
response#11response[variant1].post.platforms[].metrics.reach[variant2]null__37_type:null
response#11response[variant1].post.platforms[].metrics.likesnumber | null__38Yes
response#11response[variant1].post.platforms[].metrics.likes[variant1]number__38_type:number
response#11response[variant1].post.platforms[].metrics.likes[variant2]null__38_type:null
response#11response[variant1].post.platforms[].metrics.commentsnumber | null__39Yes
response#11response[variant1].post.platforms[].metrics.comments[variant1]number__39_type:number
response#11response[variant1].post.platforms[].metrics.comments[variant2]null__39_type:null
response#11response[variant1].post.platforms[].metrics.sharesnumber | null__40Yes
response#11response[variant1].post.platforms[].metrics.shares[variant1]number__40_type:number
response#11response[variant1].post.platforms[].metrics.shares[variant2]null__40_type:null
response#11response[variant1].post.platforms[].metrics.savesnumber | null__41Yes
response#11response[variant1].post.platforms[].metrics.saves[variant1]number__41_type:number
response#11response[variant1].post.platforms[].metrics.saves[variant2]null__41_type:null
response#11response[variant1].post.platforms[].metrics.clicksnumber | null__42Yes
response#11response[variant1].post.platforms[].metrics.clicks[variant1]number__42_type:number
response#11response[variant1].post.platforms[].metrics.clicks[variant2]null__42_type:null
response#11response[variant1].post.platforms[].metrics.viewsnumber | null__43Yes
response#11response[variant1].post.platforms[].metrics.views[variant1]number__43_type:number
response#11response[variant1].post.platforms[].metrics.views[variant2]null__43_type:null
response#11response[variant1].post.platforms[].metrics.engagementRatenumber | null__44YesEngagement rate (0-1). null when the platform does not report engagement.
response#11response[variant1].post.platforms[].metrics.engagementRate[variant1]number__44_type:numberEngagement rate (0-1). null when the platform does not report engagement.
response#11response[variant1].post.platforms[].metrics.engagementRate[variant2]null__44_type:nullEngagement rate (0-1). null when the platform does not report engagement.
response#11response[variant1].post.platforms[].metrics.avgWatchTimenumber | null__45NoInstagram Reels only. Average watch time per view, in seconds. null for other media/platforms.
response#11response[variant1].post.platforms[].metrics.avgWatchTime[variant1]number__45_type:numberInstagram Reels only. Average watch time per view, in seconds. null for other media/platforms.
response#11response[variant1].post.platforms[].metrics.avgWatchTime[variant2]null__45_type:nullInstagram Reels only. Average watch time per view, in seconds. null for other media/platforms.
response#11response[variant1].post.platforms[].metrics.totalWatchTimenumber | null__46NoInstagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null.
response#11response[variant1].post.platforms[].metrics.totalWatchTime[variant1]number__46_type:numberInstagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null.
response#11response[variant1].post.platforms[].metrics.totalWatchTime[variant2]null__46_type:nullInstagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null.
response#11response[variant1].post.platforms[].metrics.skipRatenumber | null__47NoInstagram Reels only. Reels skip rate as reported by Meta (reels_skip_rate, added Dec 2025) — the share of views that skipped past the reel. null for other media/platforms or when Meta has no value yet.
response#11response[variant1].post.platforms[].metrics.skipRate[variant1]number__47_type:numberInstagram Reels only. Reels skip rate as reported by Meta (reels_skip_rate, added Dec 2025) — the share of views that skipped past the reel. null for other media/platforms or when Meta has no value yet.
response#11response[variant1].post.platforms[].metrics.skipRate[variant2]null__47_type:nullInstagram Reels only. Reels skip rate as reported by Meta (reels_skip_rate, added Dec 2025) — the share of views that skipped past the reel. null for other media/platforms or when Meta has no value yet.
response#11response[variant2]object__0_extends:__48Single-post response (when postId is supplied) or paginated list response.
response#11response[variant2].successboolean__49Yes
response#11response[variant2].totalinteger__50YesTotal matched posts across all pageskind: ; value: 0 <= value
response#11response[variant2].pageinteger__51Yeskind: ; value: 1 <= value
response#11response[variant2].limitinteger__52Yeskind: ; value: 1 <= value
response#11response[variant2].postsarray<object>__53Yes
response#11response[variant2].posts[]object__54
response#11response[variant2].posts[].sourcestring__55YesSelects lookup mode for a single post. "platform" requires postId and accountId. List requests always fetch live metrics for stored post metadata and require accountId.kind: ; value: "postpeer" | "platform"
response#11response[variant2].posts[].originstring__56NoWhere a stored post was originally published. Present when source=postpeer.
response#11response[variant2].posts[].origin[variant1]string__56_extends:__57Where a stored post was originally published. Present when source=postpeer.kind: ; value: "postpeer"
response#11response[variant2].posts[].origin[variant2]string__56_extends:__58Where a stored post was originally published. Present when source=postpeer.kind: ; value: "external"
response#11response[variant2].posts[].postIdstring | null__59Yesthe service post ID. External synced posts also receive an ID. null only when source=platform is fetched live.
response#11response[variant2].posts[].postId[variant1]string__59_type:stringthe service post ID. External synced posts also receive an ID. null only when source=platform is fetched live.
response#11response[variant2].posts[].postId[variant2]null__59_type:nullthe service post ID. External synced posts also receive an ID. null only when source=platform is fetched live.
response#11response[variant2].posts[].contentstring | null__60Yes
response#11response[variant2].posts[].content[variant1]string__60_type:string
response#11response[variant2].posts[].content[variant2]null__60_type:null
response#11response[variant2].posts[].publishedAtstring | null__61Yeskind: ; value: date-time
response#11response[variant2].posts[].publishedAt[variant1]string__61_type:stringkind: ; value: date-time
response#11response[variant2].posts[].publishedAt[variant2]null__61_type:nullkind: ; value: date-time
response#11response[variant2].posts[].mediaTypestring | null__62NoNormalized media type when the platform exposes it.
response#11response[variant2].posts[].mediaType[variant1]string__62_extends:__63Normalized media type when the platform exposes it.kind: ; value: "image"
response#11response[variant2].posts[].mediaType[variant2]string__62_extends:__64Normalized media type when the platform exposes it.kind: ; value: "video"
response#11response[variant2].posts[].mediaType[variant3]string__62_extends:__65Normalized media type when the platform exposes it.kind: ; value: "reel"
response#11response[variant2].posts[].mediaType[variant4]string__62_extends:__66Normalized media type when the platform exposes it.kind: ; value: "carousel"
response#11response[variant2].posts[].mediaType[variant5]null__62_extends:__67Normalized media type when the platform exposes it.
response#11response[variant2].posts[].thumbnailUrlstring | null__68NoPost thumbnail or representative media URL, if available.
response#11response[variant2].posts[].thumbnailUrl[variant1]string__68_type:stringPost thumbnail or representative media URL, if available.
response#11response[variant2].posts[].thumbnailUrl[variant2]null__68_type:nullPost thumbnail or representative media URL, if available.
response#11response[variant2].posts[].aggregatedobject__69Yes
response#11response[variant2].posts[].aggregated.impressionsnumber | null__70Yes
response#11response[variant2].posts[].aggregated.impressions[variant1]number__70_type:number
response#11response[variant2].posts[].aggregated.impressions[variant2]null__70_type:null
response#11response[variant2].posts[].aggregated.reachnumber | null__71Yes
response#11response[variant2].posts[].aggregated.reach[variant1]number__71_type:number
response#11response[variant2].posts[].aggregated.reach[variant2]null__71_type:null
response#11response[variant2].posts[].aggregated.likesnumber | null__72Yes
response#11response[variant2].posts[].aggregated.likes[variant1]number__72_type:number
response#11response[variant2].posts[].aggregated.likes[variant2]null__72_type:null
response#11response[variant2].posts[].aggregated.commentsnumber | null__73Yes
response#11response[variant2].posts[].aggregated.comments[variant1]number__73_type:number
response#11response[variant2].posts[].aggregated.comments[variant2]null__73_type:null
response#11response[variant2].posts[].aggregated.sharesnumber | null__74Yes
response#11response[variant2].posts[].aggregated.shares[variant1]number__74_type:number
response#11response[variant2].posts[].aggregated.shares[variant2]null__74_type:null
response#11response[variant2].posts[].aggregated.savesnumber | null__75Yes
response#11response[variant2].posts[].aggregated.saves[variant1]number__75_type:number
response#11response[variant2].posts[].aggregated.saves[variant2]null__75_type:null
response#11response[variant2].posts[].aggregated.clicksnumber | null__76Yes
response#11response[variant2].posts[].aggregated.clicks[variant1]number__76_type:number
response#11response[variant2].posts[].aggregated.clicks[variant2]null__76_type:null
response#11response[variant2].posts[].aggregated.viewsnumber | null__77Yes
response#11response[variant2].posts[].aggregated.views[variant1]number__77_type:number
response#11response[variant2].posts[].aggregated.views[variant2]null__77_type:null
response#11response[variant2].posts[].aggregated.engagementRatenumber | null__78YesEngagement rate (0-1). null when the platform does not report engagement.
response#11response[variant2].posts[].aggregated.engagementRate[variant1]number__78_type:numberEngagement rate (0-1). null when the platform does not report engagement.
response#11response[variant2].posts[].aggregated.engagementRate[variant2]null__78_type:nullEngagement rate (0-1). null when the platform does not report engagement.
response#11response[variant2].posts[].aggregated.avgWatchTimenumber | null__79NoInstagram Reels only. Average watch time per view, in seconds. null for other media/platforms.
response#11response[variant2].posts[].aggregated.avgWatchTime[variant1]number__79_type:numberInstagram Reels only. Average watch time per view, in seconds. null for other media/platforms.
response#11response[variant2].posts[].aggregated.avgWatchTime[variant2]null__79_type:nullInstagram Reels only. Average watch time per view, in seconds. null for other media/platforms.
response#11response[variant2].posts[].aggregated.totalWatchTimenumber | null__80NoInstagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null.
response#11response[variant2].posts[].aggregated.totalWatchTime[variant1]number__80_type:numberInstagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null.
response#11response[variant2].posts[].aggregated.totalWatchTime[variant2]null__80_type:nullInstagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null.
response#11response[variant2].posts[].aggregated.skipRatenumber | null__81NoInstagram Reels only. Reels skip rate as reported by Meta (reels_skip_rate, added Dec 2025) — the share of views that skipped past the reel. null for other media/platforms or when Meta has no value yet.
response#11response[variant2].posts[].aggregated.skipRate[variant1]number__81_type:numberInstagram Reels only. Reels skip rate as reported by Meta (reels_skip_rate, added Dec 2025) — the share of views that skipped past the reel. null for other media/platforms or when Meta has no value yet.
response#11response[variant2].posts[].aggregated.skipRate[variant2]null__81_type:nullInstagram Reels only. Reels skip rate as reported by Meta (reels_skip_rate, added Dec 2025) — the share of views that skipped past the reel. null for other media/platforms or when Meta has no value yet.
response#11response[variant2].posts[].platformsarray<object>__82Yes
response#11response[variant2].posts[].platforms[]object__83
response#11response[variant2].posts[].platforms[].platformstring#/components/schemas/PlatformYeskind: ; value: "twitter" | "instagram" | "youtube" | "tiktok" | "pinterest" | "linkedin" | "bluesky" | "facebook" | "threads" | "googlebusiness"
response#11response[variant2].posts[].platforms[].platformPostIdstring__84YesNative post ID on the platform
response#11response[variant2].posts[].platforms[].platformPostUrlstring | null__85YesDirect URL to the published post, if known
response#11response[variant2].posts[].platforms[].platformPostUrl[variant1]string__85_type:stringDirect URL to the published post, if known
response#11response[variant2].posts[].platforms[].platformPostUrl[variant2]null__85_type:nullDirect URL to the published post, if known
response#11response[variant2].posts[].platforms[].metricsobject__86Yes
response#11response[variant2].posts[].platforms[].metrics.impressionsnumber | null__87Yes
response#11response[variant2].posts[].platforms[].metrics.impressions[variant1]number__87_type:number
response#11response[variant2].posts[].platforms[].metrics.impressions[variant2]null__87_type:null
response#11response[variant2].posts[].platforms[].metrics.reachnumber | null__88Yes
response#11response[variant2].posts[].platforms[].metrics.reach[variant1]number__88_type:number
response#11response[variant2].posts[].platforms[].metrics.reach[variant2]null__88_type:null
response#11response[variant2].posts[].platforms[].metrics.likesnumber | null__89Yes
response#11response[variant2].posts[].platforms[].metrics.likes[variant1]number__89_type:number
response#11response[variant2].posts[].platforms[].metrics.likes[variant2]null__89_type:null
response#11response[variant2].posts[].platforms[].metrics.commentsnumber | null__90Yes
response#11response[variant2].posts[].platforms[].metrics.comments[variant1]number__90_type:number
response#11response[variant2].posts[].platforms[].metrics.comments[variant2]null__90_type:null
response#11response[variant2].posts[].platforms[].metrics.sharesnumber | null__91Yes
response#11response[variant2].posts[].platforms[].metrics.shares[variant1]number__91_type:number
response#11response[variant2].posts[].platforms[].metrics.shares[variant2]null__91_type:null
response#11response[variant2].posts[].platforms[].metrics.savesnumber | null__92Yes
response#11response[variant2].posts[].platforms[].metrics.saves[variant1]number__92_type:number
response#11response[variant2].posts[].platforms[].metrics.saves[variant2]null__92_type:null
response#11response[variant2].posts[].platforms[].metrics.clicksnumber | null__93Yes
response#11response[variant2].posts[].platforms[].metrics.clicks[variant1]number__93_type:number
response#11response[variant2].posts[].platforms[].metrics.clicks[variant2]null__93_type:null
response#11response[variant2].posts[].platforms[].metrics.viewsnumber | null__94Yes
response#11response[variant2].posts[].platforms[].metrics.views[variant1]number__94_type:number
response#11response[variant2].posts[].platforms[].metrics.views[variant2]null__94_type:null
response#11response[variant2].posts[].platforms[].metrics.engagementRatenumber | null__95YesEngagement rate (0-1). null when the platform does not report engagement.
response#11response[variant2].posts[].platforms[].metrics.engagementRate[variant1]number__95_type:numberEngagement rate (0-1). null when the platform does not report engagement.
response#11response[variant2].posts[].platforms[].metrics.engagementRate[variant2]null__95_type:nullEngagement rate (0-1). null when the platform does not report engagement.
response#11response[variant2].posts[].platforms[].metrics.avgWatchTimenumber | null__96NoInstagram Reels only. Average watch time per view, in seconds. null for other media/platforms.
response#11response[variant2].posts[].platforms[].metrics.avgWatchTime[variant1]number__96_type:numberInstagram Reels only. Average watch time per view, in seconds. null for other media/platforms.
response#11response[variant2].posts[].platforms[].metrics.avgWatchTime[variant2]null__96_type:nullInstagram Reels only. Average watch time per view, in seconds. null for other media/platforms.
response#11response[variant2].posts[].platforms[].metrics.totalWatchTimenumber | null__97NoInstagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null.
response#11response[variant2].posts[].platforms[].metrics.totalWatchTime[variant1]number__97_type:numberInstagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null.
response#11response[variant2].posts[].platforms[].metrics.totalWatchTime[variant2]null__97_type:nullInstagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null.
response#11response[variant2].posts[].platforms[].metrics.skipRatenumber | null__98NoInstagram Reels only. Reels skip rate as reported by Meta (reels_skip_rate, added Dec 2025) — the share of views that skipped past the reel. null for other media/platforms or when Meta has no value yet.
response#11response[variant2].posts[].platforms[].metrics.skipRate[variant1]number__98_type:numberInstagram Reels only. Reels skip rate as reported by Meta (reels_skip_rate, added Dec 2025) — the share of views that skipped past the reel. null for other media/platforms or when Meta has no value yet.
response#11response[variant2].posts[].platforms[].metrics.skipRate[variant2]null__98_type:nullInstagram Reels only. Reels skip rate as reported by Meta (reels_skip_rate, added Dec 2025) — the share of views that skipped past the reel. null for other media/platforms or when Meta has no value yet.
response#12responseobject__0
response#12response.successboolean__1Yes
response#12response.messagestring__2Yes