List channel post performance
Ranks the channel’s posts of the range (made in TryPost or not) by one metric, best first, and returns the top 50 a page at a time. Page size is set by the server: read meta.per_page. The response also carries the filters the server applied. Posts without the metric come last. Same time zone, filters, range clamping and 404 rule as GET /channels/{account}/insights.
Authorizations
Workspace API key from Settings → API Keys.
Path Parameters
Social account (channel) id. An account of another workspace returns 404.
Query Parameters
7d (last 7 days), 30d (last 30 days, the default), mtd (month to date) or custom. Days are calendar days in the API key user's time zone, today included.
7d, 30d, mtd, custom First day, Y-m-d. Required with range=custom and ignored for the other presets. Sending start and end without range means custom.
Last day, Y-m-d, on or after start. Required with range=custom.
Only posts with any of these labels (labels of this workspace). Unknown or deleted labels return 422.
Also (or only) posts without labels. Posts made outside TryPost have no labels. Send 1 or 0; true and false are rejected with 422.
1, 0 Only these content types. They must belong to the channel's network.
Post format on one network. It must belong to the destination's network. GET /content-types lists the formats of each network with their media rules. Instagram and Facebook stories publish no text.
instagram_feed, instagram_reel, instagram_story, linkedin_post, linkedin_page_post, facebook_post, facebook_reel, facebook_story, tiktok_video, tiktok_photo, youtube_short, x_post, threads_post, threads_ghost_post, pinterest_pin, pinterest_video_pin, pinterest_carousel, bluesky_post, mastodon_post, telegram_post, discord_message, google_business_post previous ranks the posts of the previous range of the same length.
current, previous Metric to rank by. When the channel does not report it (or it is omitted), the first of these the channel reports is used; filters.sort says which.
reactions, comments, engagement_rate, views, impressions, shares, saves, reach x >= 1
