Analytics

Two commands read analytics: analytics:platform for a channel, such as its followers and impressions over time, and analytics:post for one published post.

Which networks report numbers

Nine networks send analytics to PostQueen. Every other channel answers with an empty list, [].

Network	Channel windows	One post’s numbers	Followers
X	7 days	Yes	No
Facebook Page	7, 30, 90 days	Yes	Yes
Instagram	7, 30 days	Yes	Yes
Threads	7, 30 days	Yes	No
TikTok	7, 30 days	Yes	Yes
YouTube	7, 30, 90 days	Yes	Yes
LinkedIn Page	7, 30, 90 days	Yes	Yes
Pinterest	7, 30, 90 days	Yes	No
Google Business Profile	7, 30, 90 days	No	No

The other networks, such as Bluesky, WordPress and DEV, report no analytics.

A channel’s numbers

postqueen analytics:platform <channel-id>          # the last 7 days
postqueen analytics:platform <channel-id> -d 30    # the last 30 days

-d is the number of days to look back, 7 by default. Use a window the table lists for that network. PostQueen passes any other number to the network unchanged, and the network may refuse it. X is never asked: you get the last 7 days as of the last Refresh in Analytics, whatever -d says, and [] before the first refresh. The answer is a list of metrics, each with a value per day and the change over the window:

📊 Analytics for integration: cmf1abc2d0003
[
  {
    "label": "Impressions",
    "data": [
      { "total": "5000", "date": "2026-09-01" },
      { "total": "5200", "date": "2026-09-02" }
    ],
    "percentageChange": 4
  }
]

The labels depend on the network. PostQueen keeps a channel’s answer for an hour, so asking again within the hour returns the same numbers.

One post’s numbers

postqueen analytics:post <post-id>
postqueen analytics:post <post-id> -d 30

The answer has the same shape: a list of metrics such as likes, comments and impressions. It can also be:

[]: the post has not been published yet, or its network gives no numbers per post.
{"missing": true}: the post was published, but PostQueen does not know its ID on the network. Fix it below.

Fix a missing release ID

When a network does not return the post’s ID after publishing, PostQueen marks it as missing and cannot read its numbers. This happens with TikTok, which is also the only network that can list its recent posts for you to pick from.

List the channel's recent posts

postqueen posts:missing <post-id>

[
  { "id": "7321456789012345678", "url": "https://.../cover.jpeg" },
  { "id": "7321456789012345679", "url": "https://.../cover2.jpeg" }
]

Each item is a post on the network, with its cover image. This command prints JSON with no status line. Every other network answers [].

Connect the right one

postqueen posts:connect <post-id> --release-id "7321456789012345678"

Read the numbers

postqueen analytics:post <post-id>

Totals and top posts

The CLI reads one channel or one post at a time. For totals across your published posts, or your best posts ranked, use the API’s analytics summary and post analytics routes, or ask an agent over MCP.

Use the numbers in a script

Drop the status line with tail -n +2, then read the JSON with jq:

postqueen analytics:platform <channel-id> -d 30 | tail -n +2 | jq -r '.[] | "\(.label): \(.percentageChange)%"'

postqueen analytics:platform <channel-id> | tail -n +2 | jq -r '.[] | select(.label=="Impressions") | .data[-1].total'

postqueen analytics:post <post-id> | tail -n +2 | jq '.[] | {label, latest: .data[-1].total}'

Start here

Assistants and bots

Coding agents

Editors and more

MCP reference

CLI reference

Troubleshooting

Which networks report numbers

A channel’s numbers

One post’s numbers

Fix a missing release ID

Totals and top posts

Use the numbers in a script

Next steps

Analytics in the app

Command reference

​Which networks report numbers

​A channel’s numbers

​One post’s numbers

​Fix a missing release ID

​Totals and top posts

​Use the numbers in a script

​Next steps

Analytics in the app

Command reference

Which networks report numbers

A channel’s numbers

One post’s numbers

Fix a missing release ID

Totals and top posts

Use the numbers in a script

Next steps