Analytics aggregates
Return team-wide analytics aggregated across posts and accounts for a time window, read from stored metrics. Free: no credits spent and no live provider calls. Use listAccountAnalytics for per-account breakdowns or listPostPerformance for per-post metrics.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Team (workspace) id (UUID). Discover ids via the list teams endpoint or the agent context.
Query Parameters
Start of the reporting window, ISO 8601 timestamp (inclusive).
"2026-05-01T00:00:00.000Z"
End of the reporting window, ISO 8601 timestamp (inclusive).
"2026-05-31T23:59:59.000Z"
Restrict aggregates to one provider; omit for all connected providers.
x, tiktok, instagram, facebook, youtube, linkedin, threads "x"
Restrict aggregates to one content format; empty or omitted includes all formats.
text_post, text_image, text_video, carousel, thread, CSV of user-tag UUIDs; restricts aggregates to posts assigned ANY of these tags.
Alias of postType using the filter[...] convention.
text_post, text_image, text_video, carousel, thread, Alias of tagIds using the filter[...] convention; CSV of user-tag UUIDs.
Comma-separated AI tags; matches posts whose assets carry any of the listed tags (OR).
"launch,product"
Comma-separated AI content categories; matches posts in any of the listed categories (OR).
"education"
Comma-separated AI purposes; matches posts whose assets carry any of the listed purposes (OR).
"promotion"
Comma-separated AI emotions; matches posts tagged with any of the listed emotions (OR).
"joy"
Comma-separated media types; each value one of: image, video, audio, gif, document.
"image,video"
Comma-separated AI enrichment statuses; each value one of: pending, processing, completed, failed.
"completed"