Social Analytics for a Post

Overview#

Returns everything analytics knows about a single post: total metrics, per-platform results, sync status, and a daily timeline of impressions and engagement since it published.

For posts published through Orshot, :postId is the post id from the posts endpoints. For posts synced from your platforms, use the analytics_post_id from the analytics overview.

https://api.orshot.com/v1/social/analytics/posts/:postId

Request#

await fetch("https://api.orshot.com/v1/social/analytics/posts/512", {
  method: "GET",
  headers: {
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});

Right after publishing, sync_status is pending while the platform reports its first numbers. Poll with refresh=1 sparingly, or just wait a few minutes.

Query Parameters#

Error Responses#

Not found (404)#

The post does not exist in this workspace, has no analytics yet, or an external analytics_post_id does not belong to this workspace's accounts.

Other errors match the analytics overview endpoint: 403 with code analytics_not_enabled, and 429 with a Retry-After header.