Zum Hauptinhalt springen

Analytics

Wie die Beiträge eines Arbeitsbereichs auf den Plattformen abgeschnitten haben, so wie die Plattformen es melden: Aufrufe, Impressionen, Reichweite, Likes, Kommentare, geteilte und gespeicherte Beiträge, Link-Klicks und Follower. Die Zahlen werden von den Konten gelesen, auf denen die Kanäle des Arbeitsbereichs über den Plattform-Connector von Reelwire veröffentlichen, auf Facebook, Instagram, LinkedIn, Pinterest, Threads, TikTok, X und YouTube. Ein per E-Mail oder Webhook übergebener Beitrag hat daher keine, ebenso wenig Discord, Telegram und Slack. Der Bildschirm Analytics zeigt dasselbe.

Analytics gehört zu den Tarifen, die den Posting-Dienst des Plattform-Connectors enthalten, Individual und Business; bei Free antwortet jede Route mit einem 403 und einem Satz, der das sagt.

MethodePfadBerechtigung
GET/v1/analyticsposts:read
GET/v1/analytics/postsposts:read
GET/v1/analytics/posts/{id}posts:read

Live gelesen. Nichts wird gespeichert: Die Plattformen melden alle paar Stunden neue Zahlen, und Reelwire behält jede Antwort zehn Minuten, eine frühere Anfrage erhält also dieselbe Antwort. readAt sagt, wann die Zahlen gelesen wurden.

Den Zeitraum wählen​

Alle drei nehmen dieselben Parameter:

ParameterWas es bewirkt
from, toDer Zeitraum, ganze Tage im Format YYYY-MM-DD, beide eingeschlossen. Die letzten 30 Tage, wenn keiner angegeben ist, höchstens ein Jahr, nie über heute hinaus.
platformEine Plattform, mit der ID, die GET /v1/channels/surfaces nennt: instagram, youtube, x...
channelIdEin Kanal: die Zahlen des Kontos, auf dem sein Plattform-Connector veröffentlicht. Ein 404, wenn er auf keinem veröffentlicht.
sourcereelwire, der Standard, die Beiträge, die der Plattform-Connector von Reelwire erstellt hat; all, jeder Beitrag auf den verbundenen Konten, auch die auf andere Weise veröffentlichten.

Die Zahlen des Zeitraums​

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 sind Likes, Kommentare, geteilte und gespeicherte Beiträge zusammen; engagementRate sind die Interaktionen im Verhältnis zu Impressionen, sonst Reichweite, sonst Aufrufen, in Prozent, null, wo nichts gesehen wurde. Wo Plattformen zusammengezählt werden (totals, previous, daily), zählen die Interaktionen jeder Plattform gegen ihre eigene Zahl und die Summen werden geteilt, daher werden die Likes einer Plattform nie an den Impressionen einer anderen gemessen. Die übrigen Zahlen sind einfache Summen dessen, was jede Plattform unter diesem Namen meldet: Ein Aufruf, eine Impression und die Reichweite bedeuten nicht auf jeder Plattform dasselbe.
  • previous ist der gleich lange Zeitraum direkt davor, für die Veränderung.
  • daily enthält jeden Tag des Zeitraums, 0, wo nichts geschah. Interaktionen zählen an dem Tag, an dem sie eingingen.
  • platforms nennt nur die Plattformen mit Beiträgen im Zeitraum. Plattformen zählen unterschiedlich: LinkedIn meldet zum Beispiel Impressionen statt Aufrufe.
  • accounts ist jedes über den Posting-Dienst verbundene Konto, mit den Kanälen, die darauf veröffentlichen. Die Plattformen zählen Follower einmal am Tag.
  • bestTimes sind die durchschnittlichen Interaktionen der Beiträge, die in jeder Stunde der Woche erschienen sind: day 0 ist Montag und hour ist in UTC.

Hat der Arbeitsbereich kein über den Posting-Dienst verbundenes Konto, lautet die Antwort { "available": false, "reason": "no-accounts" }.

Die Beiträge​

curl "http://localhost:4000/v1/analytics/posts?sort=views&perPage=10" \
-H "Authorization: Bearer rw_your_key_here"

Eine Zeile pro Beitrag und Plattform, die neuesten zuerst, es sei denn, sort nennt einen der Werte publishedAt, views, impressions, reach, engagement, engagementRate, likes, comments, shares, saves oder clicks (höchste zuerst, ascending=true umgekehrt). q durchsucht den Text des Beitrags, die Plattform sowie Kanal, Marke und Titel eines von Reelwire erstellten Beitrags; page und perPage (5 bis 100, standardmäßig 25) teilen ihn in Seiten, wie bei jeder Liste (Seitenweise Abfrage).

{
"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 nennt den Beitrag, den Reelwire erstellt hat, null für einen auf andere Weise auf dem Konto veröffentlichten. Für einen Zeitraum werden höchstens tausend Beiträge gelesen.

Ein Beitrag​

GET /v1/analytics/posts/{id} nimmt die id, die eine Zeile nennt, oder die eigene Beitrags-ID von Reelwire, und antwortet mit dem Beitrag auf jeder Plattform, auf der er erschienen ist, mit dem, was manche Plattformen hinzufügen, und seinen Zahlen Tag für Tag seit seinem Erscheinen:

{
"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 ist null, wo die Plattform nichts sagt: averageWatchSeconds in Sekunden, completionRate und skipRate in Prozent. Ein Beitrag eines anderen Arbeitsbereichs, oder einer, für den die Plattformen noch keine Zahlen haben, ergibt ein 404; die ersten Zahlen eines Beitrags kommen innerhalb weniger Stunden nach seinem Erscheinen.