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.
Path parameters
Section titled “Path parameters”| Parameter | Required | Description |
|---|---|---|
integration |
Yes | The channel id from list channels, not the provider name. |
Query parameters
Section titled “Query parameters”| 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. |
Request
Section titled “Request”curl -H "Authorization: your-api-key" \ "https://dash.sharek.app/api/public/v1/analytics/channel-id?date=30"Response
Section titled “Response”[ { "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. |
An empty array is common
Section titled “An empty array is common”[] 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.
Caching
Section titled “Caching”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.
Errors
Section titled “Errors”| 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.