Get channel analytics
A channel’s metrics over time, such as followers and impressions, read from the network.
{integration} is the channel’s id from List channels, not the network name. date is the number of days to look back.
Which channels report
Nine networks return channel metrics: Instagram, TikTok, YouTube, Facebook Page, X, LinkedIn Page, Threads, Pinterest and Google Business Profile. Every other channel answers[], and that includes every network Available on PostQueen today. The app offers 7, 30 and 90 days, 7 and 30 on Instagram, Threads and TikTok, and 7 on X; the API passes your number to the network as it is. An answer is kept for an hour per channel and range, so asking again within the hour returns the same numbers. X is the exception: the API never asks X. It returns the last 7 days as of the last time someone chose Refresh in Analytics, whatever date you send, and [] before the first refresh.
Reading the numbers
Each series has one value per day. For the whole range, add the days up, unless the series hasaverage: true: then take their average, and unit says whether it is a percentage, seconds or a count. Engagement and click rates, average view duration and average daily reach are averaged, since adding up a rate or a daily unique count gives a number that means nothing. Series labelled New Followers count the followers won each day, so their sum is the followers won in the range, not the account’s total. percentageChange is not computed today: each network sends a fixed 0 or 5.
If it fails
Authorizations
Your API key from Connections > API Keys, or an OAuth access token (pos_...). Send it as it is, with no Bearer prefix.
Path Parameters
The channel's id, from List channels
Query Parameters
Number of days to look back. The app offers 7, 30 and 90 (Instagram, Threads and TikTok only 7 and 30); the value is passed to the network as it is.
Response
The channel's metrics
Metric label (e.g. Followers, Impressions, Likes)
Not computed today: each network sends a fixed 0 or 5. Ignore it.
When true, the figure for the range is the average of the days, not their sum. Set on daily rates and daily unique counts, such as engagement rate and average daily reach.
How to show an averaged series. Absent on series that are summed.
percent, seconds, count