List post performance
List stored performance metrics across many of a team’s posts, with filtering and pagination. Free: reads stored metrics only, with no live provider calls. Use getPostPerformance for one post’s detail or getAnalyticsAggregates for a team-wide summary.
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
Opaque pagination cursor from the previous page response (nextCursor/prevCursor); omit to start at the first page.
Page size as a positive integer string; defaults to 25, capped at 100.
"25"
"100"
Performance sort key, one of: engagement_rate, impression_count, like_count, comment_count, share_count, link_click_count, performance_score, virality_score. Empty or omitted falls back to the default ordering.
engagement_rate, impression_count, like_count, comment_count, share_count, link_click_count, performance_score, virality_score, Sort direction, asc or desc (default desc). Empty behaves as omitted.
asc, desc, Start of the published-at window, ISO 8601 timestamp (inclusive).
"2026-05-01T00:00:00.000Z"
End of the published-at window, ISO 8601 timestamp (inclusive).
"2026-05-31T23:59:59.000Z"
Restrict results to one provider; empty or omitted includes all connected providers.
x, tiktok, instagram, facebook, youtube, linkedin, threads "x"
Restrict results to one content format; empty or omitted includes all formats.
text_post, text_image, text_video, carousel, thread, CSV of user-tag UUIDs; restricts results to posts assigned ANY of these tags.
Alias of from using the filter[...] convention; ISO 8601 timestamp.
"2026-05-01T00:00:00.000Z"
Alias of to using the filter[...] convention; ISO 8601 timestamp.
"2026-05-31T23:59:59.000Z"
Alias of platform using the filter[...] convention.
x, tiktok, instagram, facebook, youtube, linkedin, threads "x"
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"