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.
| Parameter | Type | Required | Description / constraints |
|---|---|---|---|
| postId | string | No | Stored post ID or external platform post ID (auto-resolved). When omitted, returns a paginated list of all published posts with analytics. |
| platform | string | No | One of "twitter" | "instagram" | "youtube" | "tiktok" | "pinterest" | "linkedin" | "bluesky" | "facebook" | "threads" | "googlebusiness" |
| accountId | string | No | Integration ID. Required for list requests and source=platform single-post requests. |
| source | string | No | One 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. |
| fromDate | string | No | Inclusive start date (YYYY-MM-DD), format date. Defaults to 90 days ago. Maximum range 366 days. |
| toDate | string | No | Inclusive end date (YYYY-MM-DD), format date. Defaults to today. |
| sortBy | string | No | Default "date". One of "date" | "likes" | "comments" | "impressions" | "views" | "shares" | "saves" | "clicks" | "engagement" |
| order | string | No | One of "asc" | "desc" |
| limit | integer | No | Page size, default 50, range 1 <= value <= 100 |
| page | integer | No | Page 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.
| Field | Type | Required | Notes |
|---|---|---|---|
| success | boolean | Yes | Top-level success flag |
| post.source | string | Yes | "postpeer" | "platform" |
| post.origin | string | No | "postpeer" | "external". Where a stored post was originally published; present when source=postpeer. |
| post.postId | string | null | Yes | Stored post ID; external synced posts also receive an ID. Null only when source=platform is fetched live. |
| post.content | string | null | Yes | Post content |
| post.publishedAt | string | null (date-time) | Yes | Publish timestamp |
| post.mediaType | string | null | No | "image" | "video" | "reel" | "carousel" | null. Normalized media type when the platform exposes it. |
| post.thumbnailUrl | string | null | No | Post thumbnail or representative media URL, if available |
| post.aggregated | object | Yes | Aggregated metrics object |
| post.platforms | array<object> | Yes | Per-platform entries with platform, platformPostId, platformPostUrl, and metrics |
Single-post response uses post; list response uses posts[] with the same item shape.
| Field | Type | Required | Notes |
|---|---|---|---|
| success | boolean | Yes | Top-level success flag |
| total | integer | Yes | Total matched posts across all pages, 0 <= value |
| page | integer | Yes | Current page, 1 <= value |
| limit | integer | Yes | Page size, 1 <= value |
| posts | array<object> | Yes | Post objects with the same shape as the single-post post object |
List variant of the 200 response when postId is omitted.
| Field | Type | Required | Notes |
|---|---|---|---|
| impressions | number | null | Yes | Impressions |
| reach | number | null | Yes | Reach |
| likes | number | null | Yes | Likes |
| comments | number | null | Yes | Comments |
| shares | number | null | Yes | Shares |
| saves | number | null | Yes | Saves |
| clicks | number | null | Yes | Clicks |
| views | number | null | Yes | Views |
| engagementRate | number | null | Yes | Engagement rate (0-1). Null when the platform does not report engagement. |
| avgWatchTime | number | null | No | Instagram Reels only. Average watch time per view, in seconds. Null for other media/platforms. |
| totalWatchTime | number | null | No | Instagram Reels only. Total watch time in seconds, including replays. May be null. |
| skipRate | number | null | No | Instagram 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.
| Status | Content type | Body shape |
|---|---|---|
| 400 | application/json | {"success": true, "message": "string"} |
| 402 | application/json | {"success": true, "message": "string"} |
| 403 | application/json | {"success": true, "message": "string"} |
| 404 | application/json | {"success": true, "message": "string"} |
| 504 | application/json | {"success": true, "message": "string"} |
Per-status message semantics are not specified in the source; do not infer them.
curl -X GET "{{API_BASE_URL}}/v1/analytics/" \
-H "x-access-key: <token>"curl -X GET "{{API_BASE_URL}}/v1/analytics/?postId=<postId>" \
-H "x-access-key: <token>"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>"{
"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
}
}
]
}
}{
"success": true,
"message": "string"
}| Scope | Field | Type | Type reference | Required | Description | Constraints |
|---|---|---|---|---|---|---|
| postId#1 | postId | string | __0 | No | the service post ID or external platform post ID (auto-resolved). When omitted, returns a paginated list of all published posts with analytics. | |
| platform#2 | platform | string | __0 | No | kind: schemaValueIn; value: "twitter" | "instagram" | "youtube" | "tiktok" | "pinterest" | "linkedin" | "bluesky" | "facebook" | "threads" | "googlebusiness" | |
| accountId#3 | accountId | string | __0 | No | Integration ID. Required for list requests and source=platform single-post requests. | |
| source#4 | source | string | __0 | No | Selects 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#5 | fromDate | string | __0 | No | Inclusive start date (YYYY-MM-DD). Defaults to 90 days ago. | kind: schemaFormat; value: date |
| toDate#6 | toDate | string | __0 | No | Inclusive end date (YYYY-MM-DD). Defaults to today. | kind: schemaFormat; value: date |
| sortBy#7 | sortBy | string | __0 | No | Sort results by this metric | kind: schemaDefault; value: "date" | kind: schemaValueIn; value: "date" | "likes" | "comments" | "impressions" | "views" | "shares" | "saves" | "clicks" | "engagement" |
| order#8 | order | string | __0 | No | kind: schemaValueIn; value: "asc" | "desc" | |
| limit#9 | limit | integer | __0 | No | Page size (1-100) | kind: schemaDefault; value: 50 | kind: schemaRange; value: 1 <= value <= 100 |
| page#10 | page | integer | __0 | No | Page 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#11 | response | object | __0 | Single-post response (when postId is supplied) or paginated list response. | ||
| response#11 | response[variant1] | object | __0_extends:__1 | Single-post response (when postId is supplied) or paginated list response. | ||
| response#11 | response[variant1].success | boolean | __2 | Yes | ||
| response#11 | response[variant1].post | object | __3 | Yes | ||
| response#11 | response[variant1].post.source | string | __4 | Yes | Selects 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#11 | response[variant1].post.origin | string | __5 | No | Where a stored post was originally published. Present when source=postpeer. | |
| response#11 | response[variant1].post.origin[variant1] | string | __5_extends:__6 | Where a stored post was originally published. Present when source=postpeer. | kind: schemaValueIn; value: "postpeer" | |
| response#11 | response[variant1].post.origin[variant2] | string | __5_extends:__7 | Where a stored post was originally published. Present when source=postpeer. | kind: schemaValueIn; value: "external" | |
| response#11 | response[variant1].post.postId | string | null | __8 | Yes | the service post ID. External synced posts also receive an ID. null only when source=platform is fetched live. | |
| response#11 | response[variant1].post.postId[variant1] | string | __8_type:string | the service post ID. External synced posts also receive an ID. null only when source=platform is fetched live. | ||
| response#11 | response[variant1].post.postId[variant2] | null | __8_type:null | the service post ID. External synced posts also receive an ID. null only when source=platform is fetched live. | ||
| response#11 | response[variant1].post.content | string | null | __9 | Yes | ||
| response#11 | response[variant1].post.content[variant1] | string | __9_type:string | |||
| response#11 | response[variant1].post.content[variant2] | null | __9_type:null | |||
| response#11 | response[variant1].post.publishedAt | string | null | __10 | Yes | kind: schemaFormat; value: date-time | |
| response#11 | response[variant1].post.publishedAt[variant1] | string | __10_type:string | kind: schemaFormat; value: date-time | ||
| response#11 | response[variant1].post.publishedAt[variant2] | null | __10_type:null | kind: schemaFormat; value: date-time | ||
| response#11 | response[variant1].post.mediaType | string | null | __11 | No | Normalized media type when the platform exposes it. | |
| response#11 | response[variant1].post.mediaType[variant1] | string | __11_extends:__12 | Normalized media type when the platform exposes it. | kind: schemaValueIn; value: "image" | |
| response#11 | response[variant1].post.mediaType[variant2] | string | __11_extends:__13 | Normalized media type when the platform exposes it. | kind: schemaValueIn; value: "video" | |
| response#11 | response[variant1].post.mediaType[variant3] | string | __11_extends:__14 | Normalized media type when the platform exposes it. | kind: schemaValueIn; value: "reel" | |
| response#11 | response[variant1].post.mediaType[variant4] | string | __11_extends:__15 | Normalized media type when the platform exposes it. | kind: schemaValueIn; value: "carousel" | |
| response#11 | response[variant1].post.mediaType[variant5] | null | __11_extends:__16 | Normalized media type when the platform exposes it. | ||
| response#11 | response[variant1].post.thumbnailUrl | string | null | __17 | No | Post thumbnail or representative media URL, if available. | |
| response#11 | response[variant1].post.thumbnailUrl[variant1] | string | __17_type:string | Post thumbnail or representative media URL, if available. | ||
| response#11 | response[variant1].post.thumbnailUrl[variant2] | null | __17_type:null | Post thumbnail or representative media URL, if available. | ||
| response#11 | response[variant1].post.aggregated | object | __18 | Yes | ||
| response#11 | response[variant1].post.aggregated.impressions | number | null | __19 | Yes | ||
| response#11 | response[variant1].post.aggregated.impressions[variant1] | number | __19_type:number | |||
| response#11 | response[variant1].post.aggregated.impressions[variant2] | null | __19_type:null | |||
| response#11 | response[variant1].post.aggregated.reach | number | null | __20 | Yes | ||
| response#11 | response[variant1].post.aggregated.reach[variant1] | number | __20_type:number | |||
| response#11 | response[variant1].post.aggregated.reach[variant2] | null | __20_type:null | |||
| response#11 | response[variant1].post.aggregated.likes | number | null | __21 | Yes | ||
| response#11 | response[variant1].post.aggregated.likes[variant1] | number | __21_type:number | |||
| response#11 | response[variant1].post.aggregated.likes[variant2] | null | __21_type:null | |||
| response#11 | response[variant1].post.aggregated.comments | number | null | __22 | Yes | ||
| response#11 | response[variant1].post.aggregated.comments[variant1] | number | __22_type:number | |||
| response#11 | response[variant1].post.aggregated.comments[variant2] | null | __22_type:null | |||
| response#11 | response[variant1].post.aggregated.shares | number | null | __23 | Yes | ||
| response#11 | response[variant1].post.aggregated.shares[variant1] | number | __23_type:number | |||
| response#11 | response[variant1].post.aggregated.shares[variant2] | null | __23_type:null | |||
| response#11 | response[variant1].post.aggregated.saves | number | null | __24 | Yes | ||
| response#11 | response[variant1].post.aggregated.saves[variant1] | number | __24_type:number | |||
| response#11 | response[variant1].post.aggregated.saves[variant2] | null | __24_type:null | |||
| response#11 | response[variant1].post.aggregated.clicks | number | null | __25 | Yes | ||
| response#11 | response[variant1].post.aggregated.clicks[variant1] | number | __25_type:number | |||
| response#11 | response[variant1].post.aggregated.clicks[variant2] | null | __25_type:null | |||
| response#11 | response[variant1].post.aggregated.views | number | null | __26 | Yes | ||
| response#11 | response[variant1].post.aggregated.views[variant1] | number | __26_type:number | |||
| response#11 | response[variant1].post.aggregated.views[variant2] | null | __26_type:null | |||
| response#11 | response[variant1].post.aggregated.engagementRate | number | null | __27 | Yes | Engagement rate (0-1). null when the platform does not report engagement. | |
| response#11 | response[variant1].post.aggregated.engagementRate[variant1] | number | __27_type:number | Engagement rate (0-1). null when the platform does not report engagement. | ||
| response#11 | response[variant1].post.aggregated.engagementRate[variant2] | null | __27_type:null | Engagement rate (0-1). null when the platform does not report engagement. | ||
| response#11 | response[variant1].post.aggregated.avgWatchTime | number | null | __28 | No | Instagram Reels only. Average watch time per view, in seconds. null for other media/platforms. | |
| response#11 | response[variant1].post.aggregated.avgWatchTime[variant1] | number | __28_type:number | Instagram Reels only. Average watch time per view, in seconds. null for other media/platforms. | ||
| response#11 | response[variant1].post.aggregated.avgWatchTime[variant2] | null | __28_type:null | Instagram Reels only. Average watch time per view, in seconds. null for other media/platforms. | ||
| response#11 | response[variant1].post.aggregated.totalWatchTime | number | null | __29 | No | Instagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null. | |
| response#11 | response[variant1].post.aggregated.totalWatchTime[variant1] | number | __29_type:number | Instagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null. | ||
| response#11 | response[variant1].post.aggregated.totalWatchTime[variant2] | null | __29_type:null | Instagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null. | ||
| response#11 | response[variant1].post.aggregated.skipRate | number | null | __30 | No | Instagram 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#11 | response[variant1].post.aggregated.skipRate[variant1] | number | __30_type:number | Instagram 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#11 | response[variant1].post.aggregated.skipRate[variant2] | null | __30_type:null | Instagram 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#11 | response[variant1].post.platforms | array<object> | __31 | Yes | ||
| response#11 | response[variant1].post.platforms[] | object | __32 | |||
| response#11 | response[variant1].post.platforms[].platform | string | #/components/schemas/Platform | Yes | kind: ; value: "twitter" | "instagram" | "youtube" | "tiktok" | "pinterest" | "linkedin" | "bluesky" | "facebook" | "threads" | "googlebusiness" | |
| response#11 | response[variant1].post.platforms[].platformPostId | string | __33 | Yes | Native post ID on the platform | |
| response#11 | response[variant1].post.platforms[].platformPostUrl | string | null | __34 | Yes | Direct URL to the published post, if known | |
| response#11 | response[variant1].post.platforms[].platformPostUrl[variant1] | string | __34_type:string | Direct URL to the published post, if known | ||
| response#11 | response[variant1].post.platforms[].platformPostUrl[variant2] | null | __34_type:null | Direct URL to the published post, if known | ||
| response#11 | response[variant1].post.platforms[].metrics | object | __35 | Yes | ||
| response#11 | response[variant1].post.platforms[].metrics.impressions | number | null | __36 | Yes | ||
| response#11 | response[variant1].post.platforms[].metrics.impressions[variant1] | number | __36_type:number | |||
| response#11 | response[variant1].post.platforms[].metrics.impressions[variant2] | null | __36_type:null | |||
| response#11 | response[variant1].post.platforms[].metrics.reach | number | null | __37 | Yes | ||
| response#11 | response[variant1].post.platforms[].metrics.reach[variant1] | number | __37_type:number | |||
| response#11 | response[variant1].post.platforms[].metrics.reach[variant2] | null | __37_type:null | |||
| response#11 | response[variant1].post.platforms[].metrics.likes | number | null | __38 | Yes | ||
| response#11 | response[variant1].post.platforms[].metrics.likes[variant1] | number | __38_type:number | |||
| response#11 | response[variant1].post.platforms[].metrics.likes[variant2] | null | __38_type:null | |||
| response#11 | response[variant1].post.platforms[].metrics.comments | number | null | __39 | Yes | ||
| response#11 | response[variant1].post.platforms[].metrics.comments[variant1] | number | __39_type:number | |||
| response#11 | response[variant1].post.platforms[].metrics.comments[variant2] | null | __39_type:null | |||
| response#11 | response[variant1].post.platforms[].metrics.shares | number | null | __40 | Yes | ||
| response#11 | response[variant1].post.platforms[].metrics.shares[variant1] | number | __40_type:number | |||
| response#11 | response[variant1].post.platforms[].metrics.shares[variant2] | null | __40_type:null | |||
| response#11 | response[variant1].post.platforms[].metrics.saves | number | null | __41 | Yes | ||
| response#11 | response[variant1].post.platforms[].metrics.saves[variant1] | number | __41_type:number | |||
| response#11 | response[variant1].post.platforms[].metrics.saves[variant2] | null | __41_type:null | |||
| response#11 | response[variant1].post.platforms[].metrics.clicks | number | null | __42 | Yes | ||
| response#11 | response[variant1].post.platforms[].metrics.clicks[variant1] | number | __42_type:number | |||
| response#11 | response[variant1].post.platforms[].metrics.clicks[variant2] | null | __42_type:null | |||
| response#11 | response[variant1].post.platforms[].metrics.views | number | null | __43 | Yes | ||
| response#11 | response[variant1].post.platforms[].metrics.views[variant1] | number | __43_type:number | |||
| response#11 | response[variant1].post.platforms[].metrics.views[variant2] | null | __43_type:null | |||
| response#11 | response[variant1].post.platforms[].metrics.engagementRate | number | null | __44 | Yes | Engagement rate (0-1). null when the platform does not report engagement. | |
| response#11 | response[variant1].post.platforms[].metrics.engagementRate[variant1] | number | __44_type:number | Engagement rate (0-1). null when the platform does not report engagement. | ||
| response#11 | response[variant1].post.platforms[].metrics.engagementRate[variant2] | null | __44_type:null | Engagement rate (0-1). null when the platform does not report engagement. | ||
| response#11 | response[variant1].post.platforms[].metrics.avgWatchTime | number | null | __45 | No | Instagram Reels only. Average watch time per view, in seconds. null for other media/platforms. | |
| response#11 | response[variant1].post.platforms[].metrics.avgWatchTime[variant1] | number | __45_type:number | Instagram Reels only. Average watch time per view, in seconds. null for other media/platforms. | ||
| response#11 | response[variant1].post.platforms[].metrics.avgWatchTime[variant2] | null | __45_type:null | Instagram Reels only. Average watch time per view, in seconds. null for other media/platforms. | ||
| response#11 | response[variant1].post.platforms[].metrics.totalWatchTime | number | null | __46 | No | Instagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null. | |
| response#11 | response[variant1].post.platforms[].metrics.totalWatchTime[variant1] | number | __46_type:number | Instagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null. | ||
| response#11 | response[variant1].post.platforms[].metrics.totalWatchTime[variant2] | null | __46_type:null | Instagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null. | ||
| response#11 | response[variant1].post.platforms[].metrics.skipRate | number | null | __47 | No | Instagram 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#11 | response[variant1].post.platforms[].metrics.skipRate[variant1] | number | __47_type:number | Instagram 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#11 | response[variant1].post.platforms[].metrics.skipRate[variant2] | null | __47_type:null | Instagram 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#11 | response[variant2] | object | __0_extends:__48 | Single-post response (when postId is supplied) or paginated list response. | ||
| response#11 | response[variant2].success | boolean | __49 | Yes | ||
| response#11 | response[variant2].total | integer | __50 | Yes | Total matched posts across all pages | kind: ; value: 0 <= value |
| response#11 | response[variant2].page | integer | __51 | Yes | kind: ; value: 1 <= value | |
| response#11 | response[variant2].limit | integer | __52 | Yes | kind: ; value: 1 <= value | |
| response#11 | response[variant2].posts | array<object> | __53 | Yes | ||
| response#11 | response[variant2].posts[] | object | __54 | |||
| response#11 | response[variant2].posts[].source | string | __55 | Yes | Selects 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#11 | response[variant2].posts[].origin | string | __56 | No | Where a stored post was originally published. Present when source=postpeer. | |
| response#11 | response[variant2].posts[].origin[variant1] | string | __56_extends:__57 | Where a stored post was originally published. Present when source=postpeer. | kind: ; value: "postpeer" | |
| response#11 | response[variant2].posts[].origin[variant2] | string | __56_extends:__58 | Where a stored post was originally published. Present when source=postpeer. | kind: ; value: "external" | |
| response#11 | response[variant2].posts[].postId | string | null | __59 | Yes | the service post ID. External synced posts also receive an ID. null only when source=platform is fetched live. | |
| response#11 | response[variant2].posts[].postId[variant1] | string | __59_type:string | the service post ID. External synced posts also receive an ID. null only when source=platform is fetched live. | ||
| response#11 | response[variant2].posts[].postId[variant2] | null | __59_type:null | the service post ID. External synced posts also receive an ID. null only when source=platform is fetched live. | ||
| response#11 | response[variant2].posts[].content | string | null | __60 | Yes | ||
| response#11 | response[variant2].posts[].content[variant1] | string | __60_type:string | |||
| response#11 | response[variant2].posts[].content[variant2] | null | __60_type:null | |||
| response#11 | response[variant2].posts[].publishedAt | string | null | __61 | Yes | kind: ; value: date-time | |
| response#11 | response[variant2].posts[].publishedAt[variant1] | string | __61_type:string | kind: ; value: date-time | ||
| response#11 | response[variant2].posts[].publishedAt[variant2] | null | __61_type:null | kind: ; value: date-time | ||
| response#11 | response[variant2].posts[].mediaType | string | null | __62 | No | Normalized media type when the platform exposes it. | |
| response#11 | response[variant2].posts[].mediaType[variant1] | string | __62_extends:__63 | Normalized media type when the platform exposes it. | kind: ; value: "image" | |
| response#11 | response[variant2].posts[].mediaType[variant2] | string | __62_extends:__64 | Normalized media type when the platform exposes it. | kind: ; value: "video" | |
| response#11 | response[variant2].posts[].mediaType[variant3] | string | __62_extends:__65 | Normalized media type when the platform exposes it. | kind: ; value: "reel" | |
| response#11 | response[variant2].posts[].mediaType[variant4] | string | __62_extends:__66 | Normalized media type when the platform exposes it. | kind: ; value: "carousel" | |
| response#11 | response[variant2].posts[].mediaType[variant5] | null | __62_extends:__67 | Normalized media type when the platform exposes it. | ||
| response#11 | response[variant2].posts[].thumbnailUrl | string | null | __68 | No | Post thumbnail or representative media URL, if available. | |
| response#11 | response[variant2].posts[].thumbnailUrl[variant1] | string | __68_type:string | Post thumbnail or representative media URL, if available. | ||
| response#11 | response[variant2].posts[].thumbnailUrl[variant2] | null | __68_type:null | Post thumbnail or representative media URL, if available. | ||
| response#11 | response[variant2].posts[].aggregated | object | __69 | Yes | ||
| response#11 | response[variant2].posts[].aggregated.impressions | number | null | __70 | Yes | ||
| response#11 | response[variant2].posts[].aggregated.impressions[variant1] | number | __70_type:number | |||
| response#11 | response[variant2].posts[].aggregated.impressions[variant2] | null | __70_type:null | |||
| response#11 | response[variant2].posts[].aggregated.reach | number | null | __71 | Yes | ||
| response#11 | response[variant2].posts[].aggregated.reach[variant1] | number | __71_type:number | |||
| response#11 | response[variant2].posts[].aggregated.reach[variant2] | null | __71_type:null | |||
| response#11 | response[variant2].posts[].aggregated.likes | number | null | __72 | Yes | ||
| response#11 | response[variant2].posts[].aggregated.likes[variant1] | number | __72_type:number | |||
| response#11 | response[variant2].posts[].aggregated.likes[variant2] | null | __72_type:null | |||
| response#11 | response[variant2].posts[].aggregated.comments | number | null | __73 | Yes | ||
| response#11 | response[variant2].posts[].aggregated.comments[variant1] | number | __73_type:number | |||
| response#11 | response[variant2].posts[].aggregated.comments[variant2] | null | __73_type:null | |||
| response#11 | response[variant2].posts[].aggregated.shares | number | null | __74 | Yes | ||
| response#11 | response[variant2].posts[].aggregated.shares[variant1] | number | __74_type:number | |||
| response#11 | response[variant2].posts[].aggregated.shares[variant2] | null | __74_type:null | |||
| response#11 | response[variant2].posts[].aggregated.saves | number | null | __75 | Yes | ||
| response#11 | response[variant2].posts[].aggregated.saves[variant1] | number | __75_type:number | |||
| response#11 | response[variant2].posts[].aggregated.saves[variant2] | null | __75_type:null | |||
| response#11 | response[variant2].posts[].aggregated.clicks | number | null | __76 | Yes | ||
| response#11 | response[variant2].posts[].aggregated.clicks[variant1] | number | __76_type:number | |||
| response#11 | response[variant2].posts[].aggregated.clicks[variant2] | null | __76_type:null | |||
| response#11 | response[variant2].posts[].aggregated.views | number | null | __77 | Yes | ||
| response#11 | response[variant2].posts[].aggregated.views[variant1] | number | __77_type:number | |||
| response#11 | response[variant2].posts[].aggregated.views[variant2] | null | __77_type:null | |||
| response#11 | response[variant2].posts[].aggregated.engagementRate | number | null | __78 | Yes | Engagement rate (0-1). null when the platform does not report engagement. | |
| response#11 | response[variant2].posts[].aggregated.engagementRate[variant1] | number | __78_type:number | Engagement rate (0-1). null when the platform does not report engagement. | ||
| response#11 | response[variant2].posts[].aggregated.engagementRate[variant2] | null | __78_type:null | Engagement rate (0-1). null when the platform does not report engagement. | ||
| response#11 | response[variant2].posts[].aggregated.avgWatchTime | number | null | __79 | No | Instagram Reels only. Average watch time per view, in seconds. null for other media/platforms. | |
| response#11 | response[variant2].posts[].aggregated.avgWatchTime[variant1] | number | __79_type:number | Instagram Reels only. Average watch time per view, in seconds. null for other media/platforms. | ||
| response#11 | response[variant2].posts[].aggregated.avgWatchTime[variant2] | null | __79_type:null | Instagram Reels only. Average watch time per view, in seconds. null for other media/platforms. | ||
| response#11 | response[variant2].posts[].aggregated.totalWatchTime | number | null | __80 | No | Instagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null. | |
| response#11 | response[variant2].posts[].aggregated.totalWatchTime[variant1] | number | __80_type:number | Instagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null. | ||
| response#11 | response[variant2].posts[].aggregated.totalWatchTime[variant2] | null | __80_type:null | Instagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null. | ||
| response#11 | response[variant2].posts[].aggregated.skipRate | number | null | __81 | No | Instagram 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#11 | response[variant2].posts[].aggregated.skipRate[variant1] | number | __81_type:number | Instagram 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#11 | response[variant2].posts[].aggregated.skipRate[variant2] | null | __81_type:null | Instagram 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#11 | response[variant2].posts[].platforms | array<object> | __82 | Yes | ||
| response#11 | response[variant2].posts[].platforms[] | object | __83 | |||
| response#11 | response[variant2].posts[].platforms[].platform | string | #/components/schemas/Platform | Yes | kind: ; value: "twitter" | "instagram" | "youtube" | "tiktok" | "pinterest" | "linkedin" | "bluesky" | "facebook" | "threads" | "googlebusiness" | |
| response#11 | response[variant2].posts[].platforms[].platformPostId | string | __84 | Yes | Native post ID on the platform | |
| response#11 | response[variant2].posts[].platforms[].platformPostUrl | string | null | __85 | Yes | Direct URL to the published post, if known | |
| response#11 | response[variant2].posts[].platforms[].platformPostUrl[variant1] | string | __85_type:string | Direct URL to the published post, if known | ||
| response#11 | response[variant2].posts[].platforms[].platformPostUrl[variant2] | null | __85_type:null | Direct URL to the published post, if known | ||
| response#11 | response[variant2].posts[].platforms[].metrics | object | __86 | Yes | ||
| response#11 | response[variant2].posts[].platforms[].metrics.impressions | number | null | __87 | Yes | ||
| response#11 | response[variant2].posts[].platforms[].metrics.impressions[variant1] | number | __87_type:number | |||
| response#11 | response[variant2].posts[].platforms[].metrics.impressions[variant2] | null | __87_type:null | |||
| response#11 | response[variant2].posts[].platforms[].metrics.reach | number | null | __88 | Yes | ||
| response#11 | response[variant2].posts[].platforms[].metrics.reach[variant1] | number | __88_type:number | |||
| response#11 | response[variant2].posts[].platforms[].metrics.reach[variant2] | null | __88_type:null | |||
| response#11 | response[variant2].posts[].platforms[].metrics.likes | number | null | __89 | Yes | ||
| response#11 | response[variant2].posts[].platforms[].metrics.likes[variant1] | number | __89_type:number | |||
| response#11 | response[variant2].posts[].platforms[].metrics.likes[variant2] | null | __89_type:null | |||
| response#11 | response[variant2].posts[].platforms[].metrics.comments | number | null | __90 | Yes | ||
| response#11 | response[variant2].posts[].platforms[].metrics.comments[variant1] | number | __90_type:number | |||
| response#11 | response[variant2].posts[].platforms[].metrics.comments[variant2] | null | __90_type:null | |||
| response#11 | response[variant2].posts[].platforms[].metrics.shares | number | null | __91 | Yes | ||
| response#11 | response[variant2].posts[].platforms[].metrics.shares[variant1] | number | __91_type:number | |||
| response#11 | response[variant2].posts[].platforms[].metrics.shares[variant2] | null | __91_type:null | |||
| response#11 | response[variant2].posts[].platforms[].metrics.saves | number | null | __92 | Yes | ||
| response#11 | response[variant2].posts[].platforms[].metrics.saves[variant1] | number | __92_type:number | |||
| response#11 | response[variant2].posts[].platforms[].metrics.saves[variant2] | null | __92_type:null | |||
| response#11 | response[variant2].posts[].platforms[].metrics.clicks | number | null | __93 | Yes | ||
| response#11 | response[variant2].posts[].platforms[].metrics.clicks[variant1] | number | __93_type:number | |||
| response#11 | response[variant2].posts[].platforms[].metrics.clicks[variant2] | null | __93_type:null | |||
| response#11 | response[variant2].posts[].platforms[].metrics.views | number | null | __94 | Yes | ||
| response#11 | response[variant2].posts[].platforms[].metrics.views[variant1] | number | __94_type:number | |||
| response#11 | response[variant2].posts[].platforms[].metrics.views[variant2] | null | __94_type:null | |||
| response#11 | response[variant2].posts[].platforms[].metrics.engagementRate | number | null | __95 | Yes | Engagement rate (0-1). null when the platform does not report engagement. | |
| response#11 | response[variant2].posts[].platforms[].metrics.engagementRate[variant1] | number | __95_type:number | Engagement rate (0-1). null when the platform does not report engagement. | ||
| response#11 | response[variant2].posts[].platforms[].metrics.engagementRate[variant2] | null | __95_type:null | Engagement rate (0-1). null when the platform does not report engagement. | ||
| response#11 | response[variant2].posts[].platforms[].metrics.avgWatchTime | number | null | __96 | No | Instagram Reels only. Average watch time per view, in seconds. null for other media/platforms. | |
| response#11 | response[variant2].posts[].platforms[].metrics.avgWatchTime[variant1] | number | __96_type:number | Instagram Reels only. Average watch time per view, in seconds. null for other media/platforms. | ||
| response#11 | response[variant2].posts[].platforms[].metrics.avgWatchTime[variant2] | null | __96_type:null | Instagram Reels only. Average watch time per view, in seconds. null for other media/platforms. | ||
| response#11 | response[variant2].posts[].platforms[].metrics.totalWatchTime | number | null | __97 | No | Instagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null. | |
| response#11 | response[variant2].posts[].platforms[].metrics.totalWatchTime[variant1] | number | __97_type:number | Instagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null. | ||
| response#11 | response[variant2].posts[].platforms[].metrics.totalWatchTime[variant2] | null | __97_type:null | Instagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null. | ||
| response#11 | response[variant2].posts[].platforms[].metrics.skipRate | number | null | __98 | No | Instagram 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#11 | response[variant2].posts[].platforms[].metrics.skipRate[variant1] | number | __98_type:number | Instagram 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#11 | response[variant2].posts[].platforms[].metrics.skipRate[variant2] | null | __98_type:null | Instagram 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#12 | response | object | __0 | |||
| response#12 | response.success | boolean | __1 | Yes | ||
| response#12 | response.message | string | __2 | Yes |