General analytics overview
Get comprehensive analytics with filtering capabilities.
Similar to the /overall page in the web app, this endpoint provides:
- Summary metrics
- Top performing posts
- Top performing creators
- Platform breakdown
When fromDate and/or toDate are provided, summary uses the same
activity attribution model as the dashboard Performance Overview chart:
- daily deltas from post
dailystats - first-stat totals attributed back to the upload date
- posts without daily stats attributed to their upload date
snapshotSummary, topPosts, topCreators, and platformBreakdown
remain upload-date snapshot views, matching the /overall page tables.
Agency accounts can pass scope=agency to compute the overview across
the parent agency and every subaccount.
Authorizations
API key for authentication. Get yours from Settings → Integrations
Query Parameters
Data scope. company (default) returns only the authenticated
company's own data. agency returns the union of the parent agency
plus every subaccount — use this to pull analytics across all brands.
scope=agency requires an API key belonging to a parent agency
account (an account with isAgency=true and no parent). Passing it with
a non-agency or subaccount key returns 403.
company, agency Filter analytics by specific program
Filter analytics by specific creator
Filter analytics by platform
tiktok, instagram, youtube Response
Successfully retrieved analytics overview