Skip to main content
GET
Get post analytics
Pass the PostQueen post id and date, the number of days to look back. The numbers are read live from the network, so they are what that network reports for one post: likes, comments, views, shares and the like. Eight networks have post metrics: Instagram, Facebook, Threads, X, LinkedIn Page, TikTok, YouTube and Pinterest. None of the networks Available on PostQueen today reports them. The answer is [] when:
  • the post has not been published yet,
  • its network has no post metrics, or
  • the channel’s token cannot be renewed.
A TikTok post whose id never came back answers { "missing": true }. Connect it with Get missing content and Update release ID. For many posts at once, sorted by what did best, use List post analytics.

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

postId
string
required

The post's id

Query Parameters

date
string
required

Days to look back, such as 7 or 30

Response

The post's metrics, [], or { "missing": true }

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 September 23, 2026