Skip to main content

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.

MethodPathPermission
GET/v1/analyticsposts:read
GET/v1/analytics/postsposts: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:

ParameterWhat it does
from, toThe period, whole days written YYYY-MM-DD, both included. The last 30 days where neither is given, at most a year, never past today.
platformOne platform, by the id GET /v1/channels/surfaces names it: instagram, youtube, x...
channelIdOne channel: the numbers of the account its platform connector posts to. A 404 where it posts to none.
sourcereelwire, 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"
}
  • engagement is likes, comments, shares and saves together; engagementRate is engagement against impressions, else reach, else views, in per cent, null where 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.
  • previous is the period of the same length just before, for the change.
  • daily holds every day of the period, 0 where nothing happened. Engagement counts on the day it arrived.
  • platforms lists only the platforms with posts in the period. Platforms count differently: LinkedIn reports impressions rather than views, for one.
  • accounts is every account connected through the posting service, with the channels posting to it. The platforms count followers once a day.
  • bestTimes is the average engagement of the posts that went out in each hour of the week: day 0 is Monday and hour is 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.