Sync an external post

Fetch an account's latest external posts (published directly on the platform, not through Zernio) on demand, so a just-published post is retrievable within seconds instead of waiting for the background sync (which refreshes each account at most every ~90 minutes).

Primary use case: verifying a submitted post. When a user publishes on the platform and immediately pastes the post URL into your app, call this with accountId plus url (or postId) to confirm the post exists and return its metadata.

Behavior:

• We check our stored copy first and return immediately if the post is already known (no platform call).
• Otherwise we fetch the account's latest posts live from the platform, then match and return the submitted post.
• Requests are debounced per account (~15s): if the account was just synced, the live fetch is skipped.

accountId is required — a post URL or id alone cannot be resolved to an account, and the account must be connected to Zernio (we use its token to read the platform). Supported for every platform with a listing API (Instagram, Facebook, TikTok, YouTube, X, Threads, Pinterest, Reddit, Bluesky, Google Business, and LinkedIn organization accounts; LinkedIn personal accounts are not supported).

url accepts any format the platform uses (e.g. instagram.com/p/…, instagram.com/reel/…, youtu.be/…, youtube.com/shorts/…, tiktok.com/@user/video/…, and vm.tiktok.com short links). Pass postId (the platform media/video id) as an alternative locator.

Note: post-level analytics (reach, impressions) still carry the platform's own delay (e.g. ~24h on Instagram). This endpoint confirms the post exists and returns its metadata plus basic engagement (likes, comments), not delayed insights.

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.analytics.syncExternalPosts({  body: {    accountId: 'account_abc123',  },});console.log(data);

{
  "synced": {
    "postsFound": 0,
    "postsSynced": 0,
    "skipped": true
  },
  "found": true,
  "post": {
    "platform": "string",
    "platformPostId": "string",
    "platformPostUrl": "string",
    "content": "string",
    "publishedAt": "2019-08-24T14:15:22Z",
    "mediaType": "string",
    "mediaUrl": "string",
    "thumbnailUrl": "string",
    "mediaItems": [
      {}
    ],
    "analytics": {
      "likes": 0,
      "comments": 0,
      "shares": 0,
      "saves": 0,
      "sends": 0,
      "clicks": 0,
      "views": 0,
      "reach": 0,
      "impressions": 0,
      "engagementRate": 0,
      "lastUpdated": "2019-08-24T14:15:22Z"
    }
  },
  "posts": [
    {
      "platform": "string",
      "platformPostId": "string",
      "platformPostUrl": "string",
      "content": "string",
      "publishedAt": "2019-08-24T14:15:22Z",
      "mediaType": "string",
      "mediaUrl": "string",
      "thumbnailUrl": "string",
      "mediaItems": [
        {}
      ],
      "analytics": {
        "likes": 0,
        "comments": 0,
        "shares": 0,
        "saves": 0,
        "sends": 0,
        "clicks": 0,
        "views": 0,
        "reach": 0,
        "impressions": 0,
        "engagementRate": 0,
        "lastUpdated": "2019-08-24T14:15:22Z"
      }
    }
  ]
}

{
  "error": "string",
  "type": "invalid_request_error",
  "code": "string",
  "param": "string",
  "platform": "string",
  "platformError": {},
  "details": {}
}

{
  "error": "string",
  "type": "invalid_request_error",
  "code": "string",
  "param": "string",
  "platform": "string",
  "platformError": {},
  "details": {}
}