Post analytics
GET /public/v1/analytics/post/{postId}Returns the platform’s numbers for a single published post: reach, engagement, whatever that provider reports per item.
Doing this in the app? See Analytics. Also available as
sharek analytics:post (CLI); the MCP server has no
tool for it.
Path parameters
Section titled “Path parameters”| Parameter | Required | Description |
|---|---|---|
postId |
Yes | The post id from create a post or list posts. |
Query parameters
Section titled “Query parameters”| Parameter | Required | Description |
|---|---|---|
date |
Yes | How many days back to cover, as a number. |
Request
Section titled “Request”curl -H "Authorization: your-api-key" \ "https://dash.sharek.app/api/public/v1/analytics/post/post-id?date=30"Response
Section titled “Response”Same shape as channel analytics:
[ { "label": "Impressions", "percentageChange": 0, "data": [ { "total": 3402, "date": "2026-09-01" } ] }]total is not reliably typed: the interface declares a string and production returns
numbers, so coerce it with Number(...) before doing arithmetic.
The {"missing": true} response
Section titled “The {"missing": true} response”{ "missing": true }This is not an error and not an empty result. It means the post published, but Sharek could not tell which item on the platform it became, so there is nothing to ask for numbers about.
Repair it in three steps:
- Call missing content for the same post id to list candidate items.
- Work out which one is yours from the returned URLs.
- Send that id to update release id.
Analytics work from then on.
An empty array
Section titled “An empty array”[] means there is nothing to report yet, most often because the post has not published
or the provider reports no per-post metrics.