Sync External Posts API
The Sync External Posts API imports recent posts published outside the system into a unified post store. It fetches at most the 50 most recent posts live from one connected account, stores post metadata, and updates existing posts instead of duplicating them. Analytics are returned live in the response but are never persisted. You can sync a whole recent set or verify one post by providing url or postId, and YouTube results can be filtered by visibility.
Sync External Posts API: POST {{API_BASE_URL}}/v1/posts/sync-external
Use POST {{API_BASE_URL}}/v1/posts/sync-external to sync external posts from one connected account. The operation fetches at most the 50 most recent posts live from that account and stores their metadata. If a matching post already exists, it is updated instead of duplicated, so repeated syncs refresh the same records rather than creating copies. Supported accounts in the prose description are Twitter, YouTube, Pinterest, LinkedIn organization pages, TikTok, Facebook, Instagram, Threads, and Google Business. The response platform enum also includes bluesky, which is preserved exactly in the response field map below. Analytics in the response are live values for this request only and are not persisted on the post. Before calling, confirm the accountId belongs to a connected account, decide whether you need a full recent sync or a single-post verification, and for YouTube decide whether to apply a visibility filter. After the call, read postsFound as the number of recent posts matching the request, capped at 50, and postsSynced as the number inserted or refreshed, and inspect the returned posts array for the synced post objects.
Authorization with x-access-key header
Send the access key in the x-access-key header on every request. The header name is exactly x-access-key and the value is a token placeholder in the examples. Do not put the token in the JSON body, and do not reuse a token from a different environment. If a request fails for authorization reasons, first verify that the header name is spelled exactly, that no extra whitespace was added to the token, and that the token matches the environment of the base URL you are calling.
Request body field map: accountId, url, postId, visibility
The request body is application/json and requires accountId, the connected integration ID whose recent posts to sync. Provide at most one of url or postId: url locates a platform post URL among the account's recent posts, and postId locates a native platform post ID. Both optional locator fields must have length of at least 1 when present. The optional visibility field returns only YouTube videos with that visibility and is currently supported for YouTube accounts; its values are public, private, or unlisted. A common failure is sending both url and postId, sending an empty string for a locator, or sending visibility for a non-YouTube account and expecting filtering. The worked examples in the Sync external posts request example and Verify one post by postId example show the minimal and single-post forms; see the Request body field map table for exact types and requiredness.
Response body field map: synced, found, post, posts and analytics
A successful response contains success set to true and a synced object with postsFound, postsSynced, and skipped. postsFound is the number of recent posts matching the request, capped at 50, and postsSynced is the number inserted or refreshed. skipped is a boolean retained for response compatibility. When a single post is verified, found and post identify the located post, with post allowed to be null. The posts array contains the synced post objects. Each post object includes postId, origin, isExternal, platform, accountId, platformPostId, platformPostUrl, content, publishedAt, mediaType, thumbnailUrl, platformSpecificData, and analytics. isExternal is true when the post was originally published outside the system, and platformPostId is the native platform post ID. platformSpecificData may include visibility for YouTube, matching the regular post structure. The analytics object is returned live and not persisted, and includes impressions, reach, likes, comments, shares, saves, clicks, views, and engagementRate, with avgWatchTime, totalWatchTime, and skipRate as optional Instagram Reels fields. engagementRate is a number from 0 to 1 and is null when the platform does not report engagement. Nullable fields such as platformPostUrl, publishedAt, mediaType, and thumbnailUrl must be handled as string or null in client code. See the Successful sync response example and the Response body field map table for the full shape.
Status codes 200, 400, 404, 409, 502 and 503
The endpoint documents 200, 400, 404, 409, 502, and 503 responses, all as application/json. The 200 response uses the synced, found, post, and posts shape described above. The non-200 responses share a success and message shape, and the supplied contract does not describe the specific trigger for each non-200 status, so client code should branch on the status code and surface message without assuming a cause. In practice, check the status first, then read message, and only parse synced or posts on a 200 response. See the Status codes table and the Non-200 response shape example for the exact documented shapes.
Worked cURL example and interpretation of postsFound, postsSynced and skipped
Start with the minimal request in the Sync external posts request example, sending only accountId, then read postsFound and postsSynced from the synced object in the response. If you need to verify one specific post, use the Verify one post by postId example with exactly one of postId or url, and check found and post in the response. For YouTube, add visibility with one of public, private, or unlisted and confirm that returned platformSpecificData.visibility matches the filter. Finally, do not store analytics from the response as if they were persisted post data; fetch them live again on the next sync if you need current values.
| Field | Type | Required | Constraints / values | Description |
|---|---|---|---|---|
| accountId | string | Yes | - | Connected integration ID whose recent posts to sync. |
| url | string | No | 1 <= length | Platform post URL to locate among the account's recent posts. |
| postId | string | No | 1 <= length | Native platform post ID to locate. |
| visibility | string | No | "public" | "private" | "unlisted" | Return only YouTube videos with this visibility. Visibility filtering is currently supported for YouTube accounts. |
Exact request contract; at most one of url or postId.
| Field | Type | Required | Constraints / values | Description |
|---|---|---|---|---|
| success | boolean | Yes | true | - |
| synced | object | Yes | - | - |
| synced.postsFound | integer | Yes | 0 <= value | Number of recent posts matching the request, capped at 50. |
| synced.postsSynced | integer | Yes | 0 <= value | Number of posts inserted or refreshed. |
| synced.skipped | boolean | Yes | - | Always false; retained for response compatibility. |
| found | boolean | No | - | - |
| post | object | null | No | - | - |
| post.postId | string | Yes | - | Stable post ID. |
| post.origin | string | Yes | "postpeer" | "external" | Where the post was originally published. |
| post.isExternal | boolean | Yes | - | True when the post was originally published outside the system. |
| post.platform | string | Yes | "twitter" | "instagram" | "youtube" | "tiktok" | "pinterest" | "linkedin" | "bluesky" | "facebook" | "threads" | "googlebusiness" | - |
| post.accountId | string | Yes | - | - |
| post.platformPostId | string | Yes | - | - |
| post.platformPostUrl | string | null | Yes | - | - |
| post.content | string | Yes | - | - |
| post.publishedAt | string | null | Yes | date-time | - |
| post.mediaType | string | null | Yes | "image" | "video" | "reel" | "carousel" | - |
| post.thumbnailUrl | string | null | Yes | - | - |
| post.platformSpecificData | object | Yes | - | Platform-specific post data, matching the structure used by regular posts. |
| post.platformSpecificData.visibility | string | No | "public" | "private" | "unlisted" | YouTube video visibility, matching the regular post platformSpecificData structure. |
| post.platformSpecificData.[key: string] | any | No | - | - |
| post.analytics | object | Yes | - | Live metrics returned by this sync request. Metrics are not persisted on the post. |
| post.analytics.impressions | number | null | Yes | - | - |
| post.analytics.reach | number | null | Yes | - | - |
| post.analytics.likes | number | null | Yes | - | - |
| post.analytics.comments | number | null | Yes | - | - |
| post.analytics.shares | number | null | Yes | - | - |
| post.analytics.saves | number | null | Yes | - | - |
| post.analytics.clicks | number | null | Yes | - | - |
| post.analytics.views | number | null | Yes | - | - |
| post.analytics.engagementRate | number | null | Yes | - | Engagement rate (0-1). null when the platform does not report engagement. |
| post.analytics.avgWatchTime | number | null | No | - | Instagram Reels only. Average watch time per view, in seconds. null for other media/platforms. |
| post.analytics.totalWatchTime | number | null | No | - | Instagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null. |
| post.analytics.skipRate | number | null | 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. |
| posts | array<object> | No | - | Array of the same post object shape as post. |
Exact 200 response contract; analytics are live and not persisted.
| Status | Content type | Response shape | Documented meaning |
|---|---|---|---|
| 200 | application/json | success, synced, found, post, posts | Successful sync response. |
| 400 | application/json | success, message | Not described in supplied source. |
| 404 | application/json | success, message | Not described in supplied source. |
| 409 | application/json | success, message | Not described in supplied source. |
| 502 | application/json | success, message | Not described in supplied source. |
| 503 | application/json | success, message | Not described in supplied source. |
Only status codes and shapes evidenced in the source; no invented error triggers.
Frequently asked questions
How do I sync external posts for one connected account?
Send POST to {{API_BASE_URL}}/v1/posts/sync-external with x-access-key header and JSON body containing required accountId. Optionally provide at most one of url or postId to verify one post, and visibility for YouTube filtering. The response reports postsFound and postsSynced, capped at 50 recent posts.
Are analytics from a sync stored on the post?
Analytics are returned live in the response but are not persisted on the post. Handle nullable analytics fields, including engagementRate, as number or null, and fetch again on the next sync for current values.
What happens if a post already exists?
Existing posts are updated instead of duplicated. Compare postsFound with postsSynced to see how many matched posts were inserted or refreshed in the call.
curl -X POST "{{API_BASE_URL}}/v1/posts/sync-external" \
-H "Content-Type: application/json" \
-H "x-access-key: <token>" \
-d '{
"accountId": "string"
}'curl -X POST "{{API_BASE_URL}}/v1/posts/sync-external" \
-H "Content-Type: application/json" \
-H "x-access-key: <token>" \
-d '{
"accountId": "string",
"postId": "string"
}'{
"success": true,
"synced": {
"postsFound": 0,
"postsSynced": 0,
"skipped": true
},
"found": true,
"post": {
"postId": "string",
"origin": "postpeer",
"isExternal": true,
"platform": "twitter",
"accountId": "string",
"platformPostId": "string",
"platformPostUrl": "string",
"content": "string",
"publishedAt": "2019-08-24T14:15:22Z",
"mediaType": "image",
"thumbnailUrl": "string",
"platformSpecificData": {
"visibility": "public"
},
"analytics": {
"impressions": 0,
"reach": 0,
"likes": 0,
"comments": 0,
"shares": 0,
"saves": 0,
"clicks": 0,
"views": 0,
"engagementRate": 0,
"avgWatchTime": 0,
"totalWatchTime": 0,
"skipRate": 0
}
},
"posts": [
{
"postId": "string",
"origin": "postpeer",
"isExternal": true,
"platform": "twitter",
"accountId": "string",
"platformPostId": "string",
"platformPostUrl": "string",
"content": "string",
"publishedAt": "2019-08-24T14:15:22Z",
"mediaType": "image",
"thumbnailUrl": "string",
"platformSpecificData": {
"visibility": "public"
},
"analytics": {
"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 |
|---|---|---|---|---|---|---|
| body#1 | body | object | __0 | Yes | Provide at most one of url or postId. | |
| body#1 | body.accountId | string | __1 | Yes | Connected the service integration ID whose recent posts to sync. | |
| body#1 | body.url | string | __2 | No | Platform post URL to locate among the account's recent posts. | kind: schemaLength; value: 1 <= length |
| body#1 | body.postId | string | __3 | No | Native platform post ID to locate. | kind: ; value: 1 <= length |
| body#1 | body.visibility | string | __4 | No | Return only YouTube videos with this visibility. Visibility filtering is currently supported for YouTube accounts. | |
| body#1 | body.visibility[variant1] | string | __4_extends:__5 | Return only YouTube videos with this visibility. Visibility filtering is currently supported for YouTube accounts. | kind: ; value: "public" | |
| body#1 | body.visibility[variant2] | string | __4_extends:__6 | Return only YouTube videos with this visibility. Visibility filtering is currently supported for YouTube accounts. | kind: ; value: "private" | |
| body#1 | body.visibility[variant3] | string | __4_extends:__7 | Return only YouTube videos with this visibility. Visibility filtering is currently supported for YouTube accounts. | kind: ; value: "unlisted" | |
| response#2 | response | object | __0 | |||
| response#2 | response.success | boolean | __1 | Yes | kind: schemaValueIn; value: true | |
| response#2 | response.synced | object | __2 | Yes | ||
| response#2 | response.synced.postsFound | integer | __3 | Yes | Number of recent posts matching the request, capped at 50. | kind: schemaRange; value: 0 <= value |
| response#2 | response.synced.postsSynced | integer | __4 | Yes | Number of posts inserted or refreshed in the service. | kind: schemaRange; value: 0 <= value |
| response#2 | response.synced.skipped | boolean | __5 | Yes | Always false; retained for response compatibility. | |
| response#2 | response.found | boolean | __6 | No | ||
| response#2 | response.post | object | null | __7 | No | ||
| response#2 | response.post[variant1] | object | __7_extends:__8 | |||
| response#2 | response.post[variant1].postId | string | __9 | Yes | Stable the service post ID. | |
| response#2 | response.post[variant1].origin | string | __10 | Yes | Where the post was originally published. | |
| response#2 | response.post[variant1].origin[variant1] | string | __10_extends:__11 | Where the post was originally published. | kind: schemaValueIn; value: "postpeer" | |
| response#2 | response.post[variant1].origin[variant2] | string | __10_extends:__12 | Where the post was originally published. | kind: schemaValueIn; value: "external" | |
| response#2 | response.post[variant1].isExternal | boolean | __13 | Yes | True when the post was originally published outside the service. | |
| response#2 | response.post[variant1].platform | string | __14 | Yes | kind: schemaValueIn; value: "twitter" | "instagram" | "youtube" | "tiktok" | "pinterest" | "linkedin" | "bluesky" | "facebook" | "threads" | "googlebusiness" | |
| response#2 | response.post[variant1].accountId | string | __15 | Yes | ||
| response#2 | response.post[variant1].platformPostId | string | __16 | Yes | ||
| response#2 | response.post[variant1].platformPostUrl | string | null | __17 | Yes | ||
| response#2 | response.post[variant1].platformPostUrl[variant1] | string | __17_type:string | |||
| response#2 | response.post[variant1].platformPostUrl[variant2] | null | __17_type:null | |||
| response#2 | response.post[variant1].content | string | __18 | Yes | ||
| response#2 | response.post[variant1].publishedAt | string | null | __19 | Yes | kind: schemaFormat; value: date-time | |
| response#2 | response.post[variant1].publishedAt[variant1] | string | __19_type:string | kind: schemaFormat; value: date-time | ||
| response#2 | response.post[variant1].publishedAt[variant2] | null | __19_type:null | kind: ; value: date-time | ||
| response#2 | response.post[variant1].mediaType | string | null | __20 | Yes | kind: ; value: "image" | "video" | "reel" | "carousel" | |
| response#2 | response.post[variant1].mediaType[variant1] | string | __20_type:string | kind: ; value: "image" | "video" | "reel" | "carousel" | ||
| response#2 | response.post[variant1].mediaType[variant2] | null | __20_type:null | kind: ; value: "image" | "video" | "reel" | "carousel" | ||
| response#2 | response.post[variant1].thumbnailUrl | string | null | __21 | Yes | ||
| response#2 | response.post[variant1].thumbnailUrl[variant1] | string | __21_type:string | |||
| response#2 | response.post[variant1].thumbnailUrl[variant2] | null | __21_type:null | |||
| response#2 | response.post[variant1].platformSpecificData | object | __22 | Yes | Platform-specific post data, matching the structure used by regular posts. | |
| response#2 | response.post[variant1].platformSpecificData.visibility | string | __23 | No | YouTube video visibility, matching the regular post platformSpecificData structure. | kind: ; value: "public" | "private" | "unlisted" |
| response#2 | response.post[variant1].platformSpecificData.[key: string] | any | true | No | ||
| response#2 | response.post[variant1].analytics | object | __24 | Yes | Live metrics returned by this sync request. Metrics are not persisted on the post. | |
| response#2 | response.post[variant1].analytics.impressions | number | null | __25 | Yes | ||
| response#2 | response.post[variant1].analytics.impressions[variant1] | number | __25_type:number | |||
| response#2 | response.post[variant1].analytics.impressions[variant2] | null | __25_type:null | |||
| response#2 | response.post[variant1].analytics.reach | number | null | __26 | Yes | ||
| response#2 | response.post[variant1].analytics.reach[variant1] | number | __26_type:number | |||
| response#2 | response.post[variant1].analytics.reach[variant2] | null | __26_type:null | |||
| response#2 | response.post[variant1].analytics.likes | number | null | __27 | Yes | ||
| response#2 | response.post[variant1].analytics.likes[variant1] | number | __27_type:number | |||
| response#2 | response.post[variant1].analytics.likes[variant2] | null | __27_type:null | |||
| response#2 | response.post[variant1].analytics.comments | number | null | __28 | Yes | ||
| response#2 | response.post[variant1].analytics.comments[variant1] | number | __28_type:number | |||
| response#2 | response.post[variant1].analytics.comments[variant2] | null | __28_type:null | |||
| response#2 | response.post[variant1].analytics.shares | number | null | __29 | Yes | ||
| response#2 | response.post[variant1].analytics.shares[variant1] | number | __29_type:number | |||
| response#2 | response.post[variant1].analytics.shares[variant2] | null | __29_type:null | |||
| response#2 | response.post[variant1].analytics.saves | number | null | __30 | Yes | ||
| response#2 | response.post[variant1].analytics.saves[variant1] | number | __30_type:number | |||
| response#2 | response.post[variant1].analytics.saves[variant2] | null | __30_type:null | |||
| response#2 | response.post[variant1].analytics.clicks | number | null | __31 | Yes | ||
| response#2 | response.post[variant1].analytics.clicks[variant1] | number | __31_type:number | |||
| response#2 | response.post[variant1].analytics.clicks[variant2] | null | __31_type:null | |||
| response#2 | response.post[variant1].analytics.views | number | null | __32 | Yes | ||
| response#2 | response.post[variant1].analytics.views[variant1] | number | __32_type:number | |||
| response#2 | response.post[variant1].analytics.views[variant2] | null | __32_type:null | |||
| response#2 | response.post[variant1].analytics.engagementRate | number | null | __33 | Yes | Engagement rate (0-1). null when the platform does not report engagement. | |
| response#2 | response.post[variant1].analytics.engagementRate[variant1] | number | __33_type:number | Engagement rate (0-1). null when the platform does not report engagement. | ||
| response#2 | response.post[variant1].analytics.engagementRate[variant2] | null | __33_type:null | Engagement rate (0-1). null when the platform does not report engagement. | ||
| response#2 | response.post[variant1].analytics.avgWatchTime | number | null | __34 | No | Instagram Reels only. Average watch time per view, in seconds. null for other media/platforms. | |
| response#2 | response.post[variant1].analytics.avgWatchTime[variant1] | number | __34_type:number | Instagram Reels only. Average watch time per view, in seconds. null for other media/platforms. | ||
| response#2 | response.post[variant1].analytics.avgWatchTime[variant2] | null | __34_type:null | Instagram Reels only. Average watch time per view, in seconds. null for other media/platforms. | ||
| response#2 | response.post[variant1].analytics.totalWatchTime | number | null | __35 | No | Instagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null. | |
| response#2 | response.post[variant1].analytics.totalWatchTime[variant1] | number | __35_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#2 | response.post[variant1].analytics.totalWatchTime[variant2] | null | __35_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#2 | response.post[variant1].analytics.skipRate | number | null | __36 | 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#2 | response.post[variant1].analytics.skipRate[variant1] | number | __36_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#2 | response.post[variant1].analytics.skipRate[variant2] | null | __36_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#2 | response.post[variant2] | null | __7_extends:__37 | |||
| response#2 | response.posts | array<object> | __38 | No | ||
| response#2 | response.posts[] | object | __39 | |||
| response#2 | response.posts[].postId | string | __40 | Yes | Stable the service post ID. | |
| response#2 | response.posts[].origin | string | __41 | Yes | Where the post was originally published. | |
| response#2 | response.posts[].origin[variant1] | string | __41_extends:__42 | Where the post was originally published. | kind: ; value: "postpeer" | |
| response#2 | response.posts[].origin[variant2] | string | __41_extends:__43 | Where the post was originally published. | kind: ; value: "external" | |
| response#2 | response.posts[].isExternal | boolean | __44 | Yes | True when the post was originally published outside the service. | |
| response#2 | response.posts[].platform | string | __45 | Yes | kind: ; value: "twitter" | "instagram" | "youtube" | "tiktok" | "pinterest" | "linkedin" | "bluesky" | "facebook" | "threads" | "googlebusiness" | |
| response#2 | response.posts[].accountId | string | __46 | Yes | ||
| response#2 | response.posts[].platformPostId | string | __47 | Yes | ||
| response#2 | response.posts[].platformPostUrl | string | null | __48 | Yes | ||
| response#2 | response.posts[].platformPostUrl[variant1] | string | __48_type:string | |||
| response#2 | response.posts[].platformPostUrl[variant2] | null | __48_type:null | |||
| response#2 | response.posts[].content | string | __49 | Yes | ||
| response#2 | response.posts[].publishedAt | string | null | __50 | Yes | kind: ; value: date-time | |
| response#2 | response.posts[].publishedAt[variant1] | string | __50_type:string | kind: ; value: date-time | ||
| response#2 | response.posts[].publishedAt[variant2] | null | __50_type:null | kind: ; value: date-time | ||
| response#2 | response.posts[].mediaType | string | null | __51 | Yes | kind: ; value: "image" | "video" | "reel" | "carousel" | |
| response#2 | response.posts[].mediaType[variant1] | string | __51_type:string | kind: ; value: "image" | "video" | "reel" | "carousel" | ||
| response#2 | response.posts[].mediaType[variant2] | null | __51_type:null | kind: ; value: "image" | "video" | "reel" | "carousel" | ||
| response#2 | response.posts[].thumbnailUrl | string | null | __52 | Yes | ||
| response#2 | response.posts[].thumbnailUrl[variant1] | string | __52_type:string | |||
| response#2 | response.posts[].thumbnailUrl[variant2] | null | __52_type:null | |||
| response#2 | response.posts[].platformSpecificData | object | __53 | Yes | Platform-specific post data, matching the structure used by regular posts. | |
| response#2 | response.posts[].platformSpecificData.visibility | string | __54 | No | YouTube video visibility, matching the regular post platformSpecificData structure. | kind: ; value: "public" | "private" | "unlisted" |
| response#2 | response.posts[].platformSpecificData.[key: string] | any | true | No | ||
| response#2 | response.posts[].analytics | object | __55 | Yes | Live metrics returned by this sync request. Metrics are not persisted on the post. | |
| response#2 | response.posts[].analytics.impressions | number | null | __56 | Yes | ||
| response#2 | response.posts[].analytics.impressions[variant1] | number | __56_type:number | |||
| response#2 | response.posts[].analytics.impressions[variant2] | null | __56_type:null | |||
| response#2 | response.posts[].analytics.reach | number | null | __57 | Yes | ||
| response#2 | response.posts[].analytics.reach[variant1] | number | __57_type:number | |||
| response#2 | response.posts[].analytics.reach[variant2] | null | __57_type:null | |||
| response#2 | response.posts[].analytics.likes | number | null | __58 | Yes | ||
| response#2 | response.posts[].analytics.likes[variant1] | number | __58_type:number | |||
| response#2 | response.posts[].analytics.likes[variant2] | null | __58_type:null | |||
| response#2 | response.posts[].analytics.comments | number | null | __59 | Yes | ||
| response#2 | response.posts[].analytics.comments[variant1] | number | __59_type:number | |||
| response#2 | response.posts[].analytics.comments[variant2] | null | __59_type:null | |||
| response#2 | response.posts[].analytics.shares | number | null | __60 | Yes | ||
| response#2 | response.posts[].analytics.shares[variant1] | number | __60_type:number | |||
| response#2 | response.posts[].analytics.shares[variant2] | null | __60_type:null | |||
| response#2 | response.posts[].analytics.saves | number | null | __61 | Yes | ||
| response#2 | response.posts[].analytics.saves[variant1] | number | __61_type:number | |||
| response#2 | response.posts[].analytics.saves[variant2] | null | __61_type:null | |||
| response#2 | response.posts[].analytics.clicks | number | null | __62 | Yes | ||
| response#2 | response.posts[].analytics.clicks[variant1] | number | __62_type:number | |||
| response#2 | response.posts[].analytics.clicks[variant2] | null | __62_type:null | |||
| response#2 | response.posts[].analytics.views | number | null | __63 | Yes | ||
| response#2 | response.posts[].analytics.views[variant1] | number | __63_type:number | |||
| response#2 | response.posts[].analytics.views[variant2] | null | __63_type:null | |||
| response#2 | response.posts[].analytics.engagementRate | number | null | __64 | Yes | Engagement rate (0-1). null when the platform does not report engagement. | |
| response#2 | response.posts[].analytics.engagementRate[variant1] | number | __64_type:number | Engagement rate (0-1). null when the platform does not report engagement. | ||
| response#2 | response.posts[].analytics.engagementRate[variant2] | null | __64_type:null | Engagement rate (0-1). null when the platform does not report engagement. | ||
| response#2 | response.posts[].analytics.avgWatchTime | number | null | __65 | No | Instagram Reels only. Average watch time per view, in seconds. null for other media/platforms. | |
| response#2 | response.posts[].analytics.avgWatchTime[variant1] | number | __65_type:number | Instagram Reels only. Average watch time per view, in seconds. null for other media/platforms. | ||
| response#2 | response.posts[].analytics.avgWatchTime[variant2] | null | __65_type:null | Instagram Reels only. Average watch time per view, in seconds. null for other media/platforms. | ||
| response#2 | response.posts[].analytics.totalWatchTime | number | null | __66 | No | Instagram Reels only. Total watch time in seconds, including replays. Meta flags this metric as in development, so it may be null. | |
| response#2 | response.posts[].analytics.totalWatchTime[variant1] | number | __66_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#2 | response.posts[].analytics.totalWatchTime[variant2] | null | __66_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#2 | response.posts[].analytics.skipRate | number | null | __67 | 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#2 | response.posts[].analytics.skipRate[variant1] | number | __67_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#2 | response.posts[].analytics.skipRate[variant2] | null | __67_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#3 | response | object | __0 | |||
| response#3 | response.success | boolean | __1 | Yes | ||
| response#3 | response.message | string | __2 | Yes |