Skip to main content
GET
/
analytics
/
{integration}
Get platform analytics
curl --request GET \
  --url https://api.postiz.com/public/v1/analytics/{integration} \
  --header 'Authorization: <api-key>'
[
  {
    "label": "Followers",
    "data": [
      {
        "total": "1250",
        "date": "2025-01-01"
      },
      {
        "total": "1280",
        "date": "2025-01-02"
      }
    ],
    "percentageChange": 2.4
  },
  {
    "label": "Impressions",
    "data": [
      {
        "total": "5000",
        "date": "2025-01-01"
      },
      {
        "total": "5200",
        "date": "2025-01-02"
      }
    ],
    "percentageChange": 4
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.postiz.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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 will return 400 Invalid integration. 
# Get the integration ID
curl -H "Authorization: your-api-key" \
  https://api.postiz.com/public/v1/integrations

# Use the returned id
curl -H "Authorization: your-api-key" \
  https://api.postiz.com/public/v1/analytics/<integration-id>

​
Common errors

  • 400 Invalid integration — the path param is the wrong shape.
  • 404 Channel not found — the integration exists but has been disconnected. Reconnect the channel from the Postiz UI.
  • 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 Postiz 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