Skip to main content
GET
Get platform analytics

Path parameter: integration

The {integration} path parameter must be the integration’s id (the UUID-shaped string returned by GET /public/v1/integrations). It is not the platform __type (e.g. x, linkedin) and not the channel display name. Passing either of those returns 500 with the message Invalid integration. That is a rough edge rather than a designed status: the lookup throws a plain error. Read it as “no such integration in this organization”.

Common errors

  • 500 Invalid integration: no integration with that id belongs to your organization. A __type, a display name or an id from another workspace all land here.
  • Empty array with 200: the channel exists but its token expired and could not be refreshed, so PostQueen disconnected it. Reconnect it from the PostQueen UI. There is no 404 Channel not found on this endpoint.
  • Empty data: some platforms (notably Google My Business) restrict analytics by date range or by profile verification status. The endpoint returns an empty payload rather than an error.

Authorizations

Authorization
string
header
required

Your PostQueen API key

Path Parameters

integration
string
required

Integration ID

Query Parameters

date
string
required

Number of days to look back for analytics data (e.g. 7, 30, 90)

Response

200 - application/json

Analytics data for the integration

label
string

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

data
object[]
percentageChange
number

Percentage change over the selected period