Skip to content

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.

Parameter Required Description
postId Yes The post id from create a post or list posts.
Parameter Required Description
date Yes How many days back to cover, as a number.
Terminal window
curl -H "Authorization: your-api-key" \
"https://dash.sharek.app/api/public/v1/analytics/post/post-id?date=30"

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.

{ "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:

  1. Call missing content for the same post id to list candidate items.
  2. Work out which one is yours from the returned URLs.
  3. Send that id to update release id.

Analytics work from then on.

[] means there is nothing to report yet, most often because the post has not published or the provider reports no per-post metrics.