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.
Zero-based row offset to jump to (numbered pages), 0 to 10000. With a cursor, the jump starts from that cursor; without one it is a plain offset. Lists not yet on the signed cursor standard ignore it.
"0"
"25"
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, pinterest "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, pinterest "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"
Response
Success
Opaque cursor for the page after this one; null on the last page.
Opaque cursor for the page before this one; null on the first page. Lists on the signed cursor standard return a real backwards cursor; older lists echo the request cursor.
Zero-based position of the first row of this page within total (for "Showing 26-50 of 268" and page numbers); null when unknown.