List post analytics

curl --request GET \
  --url https://api.postqueen.ai/public/v1/analytics/posts \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.postqueen.ai/public/v1/analytics/posts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "syncing": true,
  "date": 123,
  "total": 123,
  "page": 123,
  "limit": 123,
  "notes": {},
  "columns": {},
  "posts": [
    {
      "id": "<string>",
      "group": "<string>",
      "content": "<string>",
      "thumbnail": "<string>",
      "publishDate": "2023-11-07T05:31:56Z",
      "releaseURL": "<string>",
      "integrationId": "<string>",
      "platform": "<string>",
      "channelName": "<string>",
      "channelPicture": "<string>",
      "impressions": 123,
      "reactions": 123,
      "comments": 123,
      "shares": 123,
      "engagementRate": 123,
      "previous": {}
    }
  ],
  "top": [
    {
      "id": "<string>",
      "group": "<string>",
      "content": "<string>",
      "thumbnail": "<string>",
      "publishDate": "2023-11-07T05:31:56Z",
      "releaseURL": "<string>",
      "integrationId": "<string>",
      "platform": "<string>",
      "channelName": "<string>",
      "channelPicture": "<string>",
      "impressions": 123,
      "reactions": 123,
      "comments": 123,
      "shares": 123,
      "engagementRate": 123,
      "previous": {}
    }
  ],
  "topReactions": [
    {
      "id": "<string>",
      "group": "<string>",
      "content": "<string>",
      "thumbnail": "<string>",
      "publishDate": "2023-11-07T05:31:56Z",
      "releaseURL": "<string>",
      "integrationId": "<string>",
      "platform": "<string>",
      "channelName": "<string>",
      "channelPicture": "<string>",
      "impressions": 123,
      "reactions": 123,
      "comments": 123,
      "shares": 123,
      "engagementRate": 123,
      "previous": {}
    }
  ],
  "topComments": [
    {
      "id": "<string>",
      "group": "<string>",
      "content": "<string>",
      "thumbnail": "<string>",
      "publishDate": "2023-11-07T05:31:56Z",
      "releaseURL": "<string>",
      "integrationId": "<string>",
      "platform": "<string>",
      "channelName": "<string>",
      "channelPicture": "<string>",
      "impressions": 123,
      "reactions": 123,
      "comments": 123,
      "shares": 123,
      "engagementRate": 123,
      "previous": {}
    }
  ]
}

{
  "message": [
    "startDate must be a valid ISO 8601 date string"
  ],
  "error": "Bad Request",
  "statusCode": 400
}

{
  "msg": "Invalid API key"
}

GET

analytics

posts

List post analytics

curl --request GET \
  --url https://api.postqueen.ai/public/v1/analytics/posts \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.postqueen.ai/public/v1/analytics/posts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "syncing": true,
  "date": 123,
  "total": 123,
  "page": 123,
  "limit": 123,
  "notes": {},
  "columns": {},
  "posts": [
    {
      "id": "<string>",
      "group": "<string>",
      "content": "<string>",
      "thumbnail": "<string>",
      "publishDate": "2023-11-07T05:31:56Z",
      "releaseURL": "<string>",
      "integrationId": "<string>",
      "platform": "<string>",
      "channelName": "<string>",
      "channelPicture": "<string>",
      "impressions": 123,
      "reactions": 123,
      "comments": 123,
      "shares": 123,
      "engagementRate": 123,
      "previous": {}
    }
  ],
  "top": [
    {
      "id": "<string>",
      "group": "<string>",
      "content": "<string>",
      "thumbnail": "<string>",
      "publishDate": "2023-11-07T05:31:56Z",
      "releaseURL": "<string>",
      "integrationId": "<string>",
      "platform": "<string>",
      "channelName": "<string>",
      "channelPicture": "<string>",
      "impressions": 123,
      "reactions": 123,
      "comments": 123,
      "shares": 123,
      "engagementRate": 123,
      "previous": {}
    }
  ],
  "topReactions": [
    {
      "id": "<string>",
      "group": "<string>",
      "content": "<string>",
      "thumbnail": "<string>",
      "publishDate": "2023-11-07T05:31:56Z",
      "releaseURL": "<string>",
      "integrationId": "<string>",
      "platform": "<string>",
      "channelName": "<string>",
      "channelPicture": "<string>",
      "impressions": 123,
      "reactions": 123,
      "comments": 123,
      "shares": 123,
      "engagementRate": 123,
      "previous": {}
    }
  ],
  "topComments": [
    {
      "id": "<string>",
      "group": "<string>",
      "content": "<string>",
      "thumbnail": "<string>",
      "publishDate": "2023-11-07T05:31:56Z",
      "releaseURL": "<string>",
      "integrationId": "<string>",
      "platform": "<string>",
      "channelName": "<string>",
      "channelPicture": "<string>",
      "impressions": 123,
      "reactions": 123,
      "comments": 123,
      "shares": 123,
      "engagementRate": 123,
      "previous": {}
    }
  ]
}

{
  "message": [
    "startDate must be a valid ISO 8601 date string"
  ],
  "error": "Bad Request",
  "statusCode": 400
}

{
  "msg": "Invalid API key"
}

Where Get post analytics asks the network about one post, this reads the metrics PostQueen has already stored for all your published posts. It answers fast, and it can sort and page them.

date picks posts by publish date: the last 1 to 90 days, 30 by default.
The numbers are each post’s latest lifetime totals, not growth inside the range. null means the network does not report that metric, not zero.
Only networks with post metrics are included: Instagram, Facebook, Threads, X, LinkedIn Page, TikTok, YouTube and Pinterest. Facebook reports no comments, and Pinterest no reactions or comments. None of the networks Available on PostQueen today is among them.
Stored numbers older than an hour start a refresh in the background. The answer still comes at once, with syncing: true: ask again a little later for newer numbers.

Narrow the list with integrationIds (comma separated), platform or q (text in the content or the channel name). Sort with sort (reactions, comments, impressions, engagement or published) and dir. topReactions and topComments always hold the five best posts of the whole filtered range, whatever page you ask for. For totals instead of a list, use Get an analytics summary.

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.

Query Parameters

date

integer

default:30

Days to look back by publish date, 1 to 90. Default 30

Required range: 1 <= x <= 90

integrationIds

string

Comma-separated channel ids to limit the report to

string

Text to match in the post content, channel name or platform

Maximum string length: 200

platform

string

The network's identifier, such as x or instagram

Maximum string length: 64

sort

enum<string>

default:reactions

Sort field. Default reactions

Available options:

reactions,

comments,

impressions,

engagement,

published

dir

enum<string>

default:desc

Sort direction. Default desc

Available options:

asc,

desc

page

integer

default:0

Page number, 0-indexed

Required range: x >= 0

limit

integer

default:20

Posts per page, 1 to 100. Default 20

Required range: 1 <= x <= 100

Response

A page of posts with their metrics

syncing

boolean

A background refresh was started; ask again shortly for newer numbers

date

integer

total

integer

page

integer

limit

integer

notes

object

Fixed reading notes: the range filters posts by publish date, numbers are current lifetime totals, null means unknown rather than zero, Facebook returns no comments, Pinterest no reactions or comments, Google Business no post metrics

columns

object

Which metrics any post in the range has at all: comments, reactions, impressions, engagement

posts

object[]

Show child attributes

top

object[]

Same as topReactions

Show child attributes

topReactions

object[]

Up to 5 posts with the most reactions

Show child attributes

topComments

object[]

Up to 5 posts with the most comments

Show child attributes

Last modified on September 23, 2026

Get started

Endpoints

Posting settings by network

Build on PostQueen

SDK and no-code

List post analytics

Authorizations

Query Parameters

Response