Skip to content

Channel analytics

GET /public/v1/analytics/{integration}

Returns what the platform reports for one channel: followers, impressions, engagement, whatever that platform exposes. Metrics differ per provider, so this operation returns labelled series rather than a fixed schema.

Doing this in the app? See Analytics. Also available as sharek analytics:platform (CLI); the MCP server has no tool for it.

Parameter Required Description
integration Yes The channel id from list channels, not the provider name.
Parameter Required Description
date No How many days back to cover, as a number. 7, 30, 90. Defaults to 7, which is also what you get for a value that is not a positive number.
Terminal window
curl -H "Authorization: your-api-key" \
"https://dash.sharek.app/api/public/v1/analytics/channel-id?date=30"
[
{
"label": "Reach",
"percentageChange": 0,
"data": [
{ "total": 0, "date": "2026-08-18" },
{ "total": 0, "date": "2026-08-19" }
]
}
]
Field Description
label The metric’s name, chosen by the provider. An Instagram channel can return Follower Count, Reach, Likes, Views, Comments, Shares, Saves and Replies; other providers return their own set.
data The daily series.
percentageChange Always 0 today: no provider computes it yet, so do not build on it.

[] is returned, without an error, when:

  • The provider exposes no analytics. Many do not.
  • The channel is not a social channel.
  • The channel’s token expired and could not be refreshed. In that case the channel is also disconnected and will show as needing attention in the app.

Check for [] before assuming an integration is broken.

Responses are cached for one hour per channel and per number of days. Asking again inside that hour returns the same numbers, so there is nothing to gain from polling more often.

Response Meaning
500 The channel id does not belong to your organization. This surfaces as a server error rather than a 404.

For a single post’s numbers rather than the channel’s, use post analytics.