Social · Analytics · Get audience analytics for a social media account
Retrieve audience analytics data (followers, demographics, growth) for a specific social media account within a date range.
Authentication
Header authentication of the form Api-Key <token>
Bearer authentication of the form Bearer <token>, where token is your auth token.
Query parameters
Start date in format YYYY-MM-DD
End date in format YYYY-MM-DD
Timezone (e.g. UTC, Europe/Warsaw)
Response
Analytics availability for the requested account. Values are returned UPPERCASE by the API (the gateway does not normalize them). When not ENABLED or PROCESSING, the rest of the response will typically be empty/null and the agent should surface a reconnect/enable CTA instead of rendering a chart. When the social service rejects the request outright (e.g. the workspace does not own the account) it still answers HTTP 200 with its own error envelope: status is then an integer code and results[].message carries the reason — surface that message instead of analytics.
false when the social account itself is disconnected and needs a fresh OAuth reconnect (independent of status). When false, surface a “Reconnect account” CTA before any analytics data.
