staqlydocs
REST APIAPI referencePosts

The post's numbers per channel, read from each platform that reports them

The post's numbers per channel, read from each platform that reports them (posts:read)

Every request sends Authorization: Bearer ...: the access token in local mode, an API key stk_... in cloud mode. Use Send to try it against your cloud instance with your API key.

GET
/v1/posts/{id}/metrics

Published targets on platforms that report numbers (X) are read again when the cached numbers are older than ten minutes, or now with refresh=true. A failed read keeps the last numbers and sets error. Targets on your own automation show what it reported (PUT .../metrics). available: false means the platform gives no numbers.

Authorization

headerAuthorizationBearer <token>

API key (stk_...), or in the Community Edition the access token (stk_local_...)

Path Parameters

id*string

Query Parameters

refresh?boolean

Read every published target's numbers now

Response Body

OK

application/json
  1. response
data*array<>
curl -X GET 'https://staqly.example.com/v1/posts/string/metrics'
{  "data": [    {      "channel_id": "string",      "channel_name": "string",      "provider": "string",      "status": "string",      "external_url": "string",      "available": true,      "metrics": {        "impressions": 0,        "likes": 0,        "reposts": 0,        "replies": 0,        "quotes": 0,        "bookmarks": 0,        "link_clicks": 0      },      "updated_at": "2019-08-24T14:15:22Z",      "error": "string"    }  ]}