Social Analytics Overview

Overview#

Returns analytics for every post across your connected social accounts. This is the same data behind the Analytics page in your dashboard. Each post carries its metrics (impressions, reach, likes, comments, shares, saves, clicks, views, engagement rate), and the response includes follower counts per account.

Covers posts published through Orshot and posts synced from your connected platforms, so there is data from day one.

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

Request#

await fetch(
  "https://api.orshot.com/v1/social/analytics?from=2026-08-01&to=2026-08-13&sort=engagement",
  {
    method: "GET",
    headers: {
      Authorization: "Bearer <ORSHOT_API_KEY>",
    },
  },
);

Query Parameters#

Responses are cached briefly and refreshed in the background, so repeated calls are fast. post_id is set when a post was published through Orshot, so use it with the per-post analytics endpoint. External posts use analytics_post_id there instead.

Error Responses#

Analytics not enabled (403)#

{
  "error": "Analytics is not enabled for this account",
  "code": "analytics_not_enabled"
}

Rate limited (429)#

API analytics reads are limited to 10 requests per minute per workspace (responses are cached server-side, so polling faster buys nothing). The response includes a Retry-After header.