Analytics API
Most endpoints return the same core metrics as theanalytics object on each platform row when you get a post: comments, likes, shares, impressions, quotes, saves, and engagement_rate. Queue sync (POST …/sync) only schedules background jobs; it does not return metrics.
Only published platform rows contribute non-zero metrics; other rows appear in breakdowns with analytics: {}.
engagement_rate aggregation (for any total object): weighted by impressions when impressions exist; otherwise a simple average of non-zero rates; 0 when there is no data.
All routes require the posts API ability and live under /api/v1/analytics/….
| Endpoint | Purpose |
|---|---|
| GET /analytics | Totals across every workspace you can access, plus per-workspace totals |
| GET /analytics/workspaces/{workspace} | Totals for one workspace |
| GET /analytics/posts/{post} | Totals for one post, plus per connected account |
| POST /analytics/posts/{post}/sync | Queue jobs to refresh analytics for that post’s published rows |
| GET /analytics/accounts/{account} | Totals for one social account, plus each platform post row |
These endpoints count toward the same rate limit as the rest of API v1 (60 requests per minute per user).