pozyDocs
Dashboard

Analytics · Analytics

Sync an external post

Syncs an external post.

POSThttps://api.pozy.ai/v1/posts/sync-external
Instagram, Facebook, TikTok, YouTube, X and Threads and 5 moresyncExternalPosts

Guides: Post analytics, Analytics, External posts

Request

Send your API key as Authorization: Bearer pz_live_.... Read-only keys cannot call it. Keys with the publishing resource group disabled get 403 resource_group_disabled. Authentication

Request body

application/json, required

  • accountIdstringrequired
  • urlstring
  • postIdstring

Example

curl -X POST "https://api.pozy.ai/v1/posts/sync-external" \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "accountId": "696e0b682d0a31188e7a2ba9"
}'

Response

200 on success

  • syncedobject
    • postsFoundinteger
    • postsSyncedinteger
    • skippedboolean
  • foundboolean
  • postobject

    One of:

    External Post Summary (13 fields)
    • platformstring
    • platformPostIdstring
    • platformPostUrlstring
    • contentstring
    • publishedAtstring (date-time)
    • mediaTypestring
    • thumbnailUrlstring
    • mediaItemsarray of object
    • mediaProductTypestring
    • isAiGeneratedboolean
    • isSharedToFeedboolean
    • mediaAudioTypestring
    • analyticsobject
      11 child fields
      • likesinteger
      • commentsinteger
      • sharesinteger
      • savesinteger
      • sendsinteger
      • clicksinteger
      • viewsinteger
      • reachinteger
      • impressionsinteger
      • engagementRatenumber
      • lastUpdatedstring (date-time)
  • postsarray of object
    13 child fields
    • platformstring
    • platformPostIdstring
    • platformPostUrlstring
    • contentstring
    • publishedAtstring (date-time)
    • mediaTypestring
    • thumbnailUrlstring
    • mediaItemsarray of object
    • mediaProductTypestring
    • isAiGeneratedboolean
    • isSharedToFeedboolean
    • mediaAudioTypestring
    • analyticsobject
      11 child fields
      • likesinteger
      • commentsinteger
      • sharesinteger
      • savesinteger
      • sendsinteger
      • clicksinteger
      • viewsinteger
      • reachinteger
      • impressionsinteger
      • engagementRatenumber
      • lastUpdatedstring (date-time)
200 response
{
  "synced": {
    "postsFound": 1,
    "postsSynced": 1,
    "skipped": true
  },
  "found": true,
  "post": {
    "platform": "instagram",
    "platformPostId": "637f799b3039e6602e83fa4f",
    "platformPostUrl": "https://pozy.ai/media/example-1.jpg",
    "content": "Hello from Pozy",
    "publishedAt": "2026-10-02T09:00:00.000Z",
    "mediaType": "string",
    "thumbnailUrl": "https://pozy.ai/media/example-1.jpg",
    "mediaItems": [
      {}
    ],
    "mediaProductType": "string",
    "isAiGenerated": true,
    "isSharedToFeed": true,
    "mediaAudioType": "string",
    "analytics": {
      "likes": 1,
      "comments": 1,
      "shares": 1,
      "saves": 1,
      "sends": 1,
      "clicks": 1,
      "views": 1,
      "reach": 1,
      "impressions": 1,
      "engagementRate": 12.5,
      "lastUpdated": "2026-10-02T09:00:00.000Z"
    }
  },
  "posts": [
    {
      "platform": "instagram",
      "platformPostId": "637f799b3039e6602e83fa4f",
      "platformPostUrl": "https://pozy.ai/media/example-1.jpg",
      "content": "Hello from Pozy",
      "publishedAt": "2026-10-02T09:00:00.000Z",
      "mediaType": "string",
      "thumbnailUrl": "https://pozy.ai/media/example-1.jpg",
      "mediaItems": [
        {}
      ],
      "mediaProductType": "string",
      "isAiGenerated": true,
      "isSharedToFeed": true,
      "mediaAudioType": "string",
      "analytics": {
        "likes": 1,
        "comments": 1,
        "shares": 1,
        "saves": 1,
        "sends": 1,
        "clicks": 1,
        "views": 1,
        "reach": 1,
        "impressions": 1,
        "engagementRate": 12.5,
        "lastUpdated": "2026-10-02T09:00:00.000Z"
      }
    }
  ]
}

Errors

Errors use one shape: { error, type, code, param?, details? }. The ones you are most likely to see here:

400invalid_request_errorA parameter or body field is missing or invalid. param names it.
401authentication_errorThe API key is missing, revoked or expired.
403permission_errorThe key is read-only, scoped to other profiles, or has this resource group disabled.
429rate_limit_errorToo many requests this minute. Wait for Retry-After seconds.

Every code is listed in Errors.

More in Analytics

GETGet post analyticsGETAnalytics changed since a cursorGETGet YouTube channel insightsGETGet LinkedIn org analyticsGETGet TikTok account-level insightsGETGet YouTube daily viewsGETGet YouTube video retention curveGETGet Facebook Page insightsGETGet Facebook post monetization earningsGETGet Instagram insightsGETGet Instagram follower historyGETGet Facebook Page demographicsGETGet LinkedIn organization follower demographicsGETGet Instagram demographicsGETGet Instagram online followersGETGet YouTube demographicsGETGet daily aggregated metricsGETGet an analytics dashboardGETGet best times to postGETGet content performance decayGETGet frequency vs engagementGETGet post analytics timelinePOSTRun a Google Analytics (GA4) reportPOSTRun a Google Analytics (GA4) realtime reportGETList Google Analytics (GA4) dimensions and metricsGETList tracking windowsPOSTOpen a tracking windowGETGet a tracking windowDELCancel a tracking windowGETGet post samplesGETGet a post's authenticity scoreGETList authenticity scoresGETGet Google Business Profile performance metricsGETGet Google Business Profile search keywordsGETGet LinkedIn aggregate statsGETGet LinkedIn post statsGETGet LinkedIn post reactionsGETGet Facebook post reactionsGETList visitor posts on a Facebook PageGETList the posts a Facebook Page is tagged in