v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Analytics

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 profiles: LinkedIn has no listing API for personal profiles, so a url is REQUIRED and imports that single post. Pass any LinkedIn post URL (linkedin.com/posts/…, linkedin.com/feed/update/urn:li:activity:…) or a urn:li:share:… / urn:li:ugcPost:… URN. Works for posts published outside Zernio and before the account was connected, any age; the post must be authored by the connected member. Imported posts return full analytics (impressions, reach, reactions, comments, reshares, saves) and keep refreshing on the background analytics cycle, but carry no content/media (LinkedIn does not expose them for personal profiles).

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.

post/v1/posts/sync-external

Request body

accountIdstring required

SocialAccount ID whose posts to sync. Must be connected to Zernio.

urlstring

The post URL to locate. Optional. Provide url or postId to return a specific post; omit both to just refresh and return the account's recent posts.

postIdstring

The platform post/media/video id to locate, as an alternative to url. Optional.

Response

Sync result. When url or postId is provided, returns the matched post (or found: false). When neither is provided, returns the account's freshly-synced recent posts.

foundboolean

Present only when a locator (url/postId) was provided — whether the post was found.