Skip to main content
GET
Get channel analytics
{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 has average: 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

Authorization
string
header
required

Your API key from Connections > API Keys, or an OAuth access token (pos_...). Send it as it is, with no Bearer prefix.

Path Parameters

integration
string
required

The channel's id, from List channels

Query Parameters

date
string
required

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

label
string

Metric label (e.g. Followers, Impressions, Likes)

data
object[]
percentageChange
number

Not computed today: each network sends a fixed 0 or 5. Ignore it.

average
boolean

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.

unit
enum<string>

How to show an averaged series. Absent on series that are summed.

Available options:
percent,
seconds,
count
Last modified on October 10, 2026