Browse the docs

DocsREST API

Analytics and other endpoints

PostDelegate API reference for channel and post analytics, notifications, free time slot suggestions, connection checks and the account behind your API key.

On this page

All paths are relative to https://app.postdelegate.com/api/public/v1.

GET /analytics/:integration

Returns analytics for one channel, where the network provides them. Use a channel id from GET /integrations.

ParameterNotes
dateOptional number of days to cover. Defaults to 7.
curl "https://app.postdelegate.com/api/public/v1/analytics/CHANNEL_ID?date=30" \
  -H "Authorization: YOUR_API_KEY"

The response is a list of metric series, each with a label, dated data points and a percentageChange:

[
  {
    "label": "Followers",
    "data": [
      { "total": "1204", "date": "2026-10-24" },
      { "total": "1231", "date": "2026-10-31" }
    ],
    "percentageChange": 2.2
  }
]

The values above are illustrative. The metrics differ by network, so read the label of each series rather than assuming a fixed set. Networks without analytics, and disabled or disconnected channels, return [].

GET /analytics/post/:postId

Returns analytics for one published post in the same shape. date is the number of days to cover. The answer is [] when the post has not published or the network has no post analytics, and { "missing": true } for a post whose live link is not known yet.

GET /notifications

Lists your workspace’s in-app notifications, such as failed posts.

ParameterNotes
pageOptional, starts at 0.

GET /find-slot/:id

Suggests the next free time to publish on a channel, based on that channel’s time slots and your existing posts.

{ "date": "2026-11-06T09:20:00" }

Pass a channel id as :id. The date is UTC. Use it as the date of a new post.

GET /is-connected

Checks that your key works.

{ "connected": true }

GET /me

Shows which workspace the key belongs to.

{
  "organization": { "id": "cm3x5a9zz0000orgg", "name": "Acme Studio" },
  "user": null
}

user is filled in only for pos_ tokens issued to an app. A plain API key belongs to the whole workspace, so user is null.

Something unclear, wrong or missing? Email support@postdelegate.com and tell us which page you were on.