Analytics
How a workspace's posts did on the platforms, as the platforms report it: views, impressions, reach, likes, comments, shares, saves, link clicks and followers. The numbers are read from the accounts the workspace's channels post to through Reelwire's platform connector, on Facebook, Instagram, LinkedIn, Pinterest, Threads, TikTok, X and YouTube, so a post handed over by email or by webhook has none, and neither have Discord, Telegram and Slack. The Analytics screen shows the same.
Analytics comes with the plans that include the platform connector's posting service, Individual and
Business; on Free every route answers a 403 with a sentence saying so.
| Method | Path | Permission |
|---|---|---|
GET | /v1/analytics | posts:read |
GET | /v1/analytics/posts | posts:read |
GET | /v1/analytics/posts/{id} | posts:read |
Read live. Nothing is stored: the platforms report new numbers every few hours, and Reelwire keeps
each answer ten minutes, so asking again sooner answers the same. readAt says when the numbers were read.
Choosing the period
All three take the same query:
| Parameter | What it does |
|---|---|
from, to | The period, whole days written YYYY-MM-DD, both included. The last 30 days where neither is given, at most a year, never past today. |
platform | One platform, by the id GET /v1/channels/surfaces names it: instagram, youtube, x... |
channelId | One channel: the numbers of the account its platform connector posts to. A 404 where it posts to none. |
source | reelwire, the default, the posts Reelwire's platform connector made; all, every post on the connected accounts, also those posted another way. |
The period's numbers
curl "http://localhost:4000/v1/analytics?from=2026-10-19&to=2026-11-17" \
-H "Authorization: Bearer rw_your_key_here"
{
"available": true,
"period": { "from": "2026-10-19", "to": "2026-11-17", "days": 30 },
"previousPeriod": { "from": "2026-09-19", "to": "2026-10-18" },
"source": "reelwire",
"totals": { "posts": 23, "views": 18420, "impressions": 26110, "reach": 9870, "likes": 812, "comments": 64, "shares": 51, "saves": 37, "clicks": 12, "engagement": 964, "engagementRate": 3.69 },
"previous": { "posts": 17, "views": 12100, "...": "the same numbers" },
"daily": [{ "date": "2026-10-19", "posts": 1, "views": 640, "...": "the same numbers" }],
"platforms": [{ "platform": "instagram", "label": "Instagram", "posts": 6, "views": 7300, "...": "the same numbers" }],
"accounts": [
{
"accountId": "acc_...",
"platform": "instagram",
"label": "Instagram",
"name": "@yourbusiness",
"channels": [{ "id": "ch_...", "name": "Instagram EN" }],
"followers": 1200,
"growth": 40,
"growthPercent": 3.4,
"updatedAt": "2026-11-17T04:00:00.000Z",
"history": [{ "date": "2026-10-19", "followers": 1160 }]
}
],
"bestTimes": [{ "day": 0, "hour": 9, "engagement": 12.35, "posts": 3 }],
"readAt": "2026-11-17T12:00:00.000Z"
}
engagementis likes, comments, shares and saves together;engagementRateis engagement against impressions, else reach, else views, in per cent,nullwhere nothing was seen. Where platforms are added up (totals,previous,daily), each platform's engagement counts against its own number and the sums are divided, so one platform's likes are never measured against another's impressions. The other numbers are plain sums of what each platform reports under that name: a view, an impression and reach do not mean the same on every platform.previousis the period of the same length just before, for the change.dailyholds every day of the period,0where nothing happened. Engagement counts on the day it arrived.platformslists only the platforms with posts in the period. Platforms count differently: LinkedIn reports impressions rather than views, for one.accountsis every account connected through the posting service, with the channels posting to it. The platforms count followers once a day.bestTimesis the average engagement of the posts that went out in each hour of the week:day0 is Monday andhouris in UTC.
Where the workspace has no account connected through the posting service, the answer is
{ "available": false, "reason": "no-accounts" }.
The posts
curl "http://localhost:4000/v1/analytics/posts?sort=views&perPage=10" \
-H "Authorization: Bearer rw_your_key_here"
One row per post and platform, newest first unless sort names one of publishedAt, views,
impressions, reach, engagement, engagementRate, likes, comments, shares, saves or
clicks (highest first, ascending=true the other way). q searches the post's words, the platform,
and the channel, brand and title of a post Reelwire made; page and perPage (5 to 100, 25 by default)
page it, as on every list (Pagination).
{
"available": true,
"period": { "from": "2026-10-19", "to": "2026-11-17" },
"total": 23,
"all": 23,
"page": 1,
"perPage": 10,
"posts": [
{
"id": "6a1f...",
"platform": "instagram",
"label": "Instagram",
"accountId": "acc_...",
"publishedAt": "2026-11-16T09:00:00.000Z",
"url": "https://www.instagram.com/reel/...",
"text": "Spring opening on Monday...",
"ours": { "postId": "post_...", "postGroupId": "grp_...", "title": "Spring opening", "channelId": "ch_...", "channelName": "Instagram EN", "brandName": "Acme" },
"numbers": { "views": 2100, "impressions": 3400, "reach": 1800, "likes": 120, "comments": 9, "shares": 4, "saves": 6, "clicks": 0, "engagement": 139, "engagementRate": 4.09 }
}
],
"readAt": "2026-11-17T12:00:00.000Z"
}
ours names the post Reelwire made, null for one posted on the account another way. At most a thousand
posts are read for one period.
One post
GET /v1/analytics/posts/{id} takes the id a row answers, or Reelwire's own post id, and answers the
post on every platform it went out on, with what some platforms add, and its numbers day by day since it
went out:
{
"id": "6a1f...",
"publishedAt": "2026-11-16T09:00:00.000Z",
"text": "Spring opening on Monday...",
"ours": { "postId": "post_...", "title": "Spring opening", "channelName": "Instagram EN", "brandName": "Acme", "...": "as above" },
"platforms": [
{
"platform": "instagram",
"label": "Instagram",
"url": "https://www.instagram.com/reel/...",
"numbers": { "views": 2100, "...": "as above" },
"extra": { "follows": 3, "averageWatchSeconds": 4.3, "completionRate": 42, "skipRate": null }
}
],
"timeline": [{ "date": "2026-11-16", "platform": "instagram", "views": 1500, "...": "the same numbers" }]
}
extra is null where the platform says nothing: averageWatchSeconds in seconds, completionRate
and skipRate in per cent. A post of another workspace, or one the platforms have no numbers for yet,
is a 404; a post's first numbers come in within a few hours of it going out.