Analytics-Überblick | AdaptlyPost

Drei Endpunkte beantworten die Frage „Wie haben wir abgeschnitten?": einer für den Gesamtwert, einer für den Trend, einer für den Vergleich zwischen Plattformen. Alle drei lesen dieselben Zahlen. Die Analytics decken Facebook, Instagram, Threads, TikTok, Pinterest, Bluesky und YouTube für die letzten 180 Tage ab. Für X gibt es hier keine Analytics, und die LinkedIn-Analytics warten noch auf die Freigabe durch LinkedIn, daher liefern beide keine Daten zurück.

Zeitraum-Parameter

Parameter	Beschreibung
from	Beginn des Zeitraums, ISO 8601. Erforderlich
to	Ende des Zeitraums, ISO 8601, nicht vor `from`. Erforderlich
platforms	Beschränkt auf diese Plattformen. Wiederholen Sie den Schlüssel für jeden Wert. Weglassen für alle abgedeckten Plattformen

Die Metriken zählen Beiträge, die innerhalb des Zeitraums veröffentlicht wurden. Zu jedem Wert gehört dieselbe Metrik für den gleich langen Zeitraum unmittelbar vor from, sodass ein 30-Tage-Zeitraum mit den 30 Tagen davor verglichen wird.

GET /api/v1/analytics/overview

GET /api/v1/analytics/overview?from=2026-08-01&to=2026-08-31&platforms=INSTAGRAM&platforms=TIKTOK

{
  "views": { "value": 48210, "previousValue": 39100, "deltaPercent": 23.3 },
  "likes": { "value": 2210, "previousValue": 1980, "deltaPercent": 11.6 },
  "comments": { "value": 340, "previousValue": 410, "deltaPercent": -17.1 },
  "shares": { "value": 128, "previousValue": null, "deltaPercent": null },
  "followers": { "value": 12980, "previousValue": 12410, "deltaPercent": 4.6 },
  "postsCount": { "value": 42, "previousValue": 37, "deltaPercent": 13.5 },
  "avgViewsPerPost": { "value": 1147.9, "previousValue": 1056.8, "deltaPercent": 8.6 },
  "engagementRate": { "value": 5.55, "previousValue": 6.11, "deltaPercent": -9.2 },
  "partialMetrics": ["shares"],
  "lastSyncedAt": "2026-09-08T06:12:41.000Z"
}

Feld	Beschreibung
value	Die Metrik für den angeforderten Zeitraum
previousValue	Dieselbe Metrik für den vorherigen, gleich langen Zeitraum
deltaPercent	Veränderung von `previousValue` zu `value`. Null, wenn der vorherige Wert 0 oder unbekannt ist
followers	Aktuelle Follower-Zahl zum Zeitpunkt `to`, verglichen mit der Zahl am Ende des vorherigen Zeitraums
engagementRate	Likes, Kommentare und Shares geteilt durch Views, als Prozentwert
partialMetrics	Metriken, die mindestens eine ausgewählte Plattform nicht melden kann. Ihre Summen umfassen nur die Plattformen, die dazu in der Lage sind
lastSyncedAt	Letzte erfolgreiche Synchronisierung über die ausgewählten Plattformen hinweg

Eine Metrik, die keine ausgewählte Plattform meldet, ist null. Das bedeutet „nicht gemessen", nicht „0".

GET /api/v1/analytics/timeseries

GET /api/v1/analytics/timeseries?from=2026-08-01&to=2026-08-31&granularity=WEEKLY

Fügt granularity hinzu: DAILY (Standard), WEEKLY oder MONTHLY.

{
  "points": [
    {
      "date": "2026-08-03T00:00:00.000Z",
      "views": 11820,
      "likes": 590,
      "comments": 82,
      "shares": 31,
      "followers": 12520,
      "postsCount": 10,
      "engagementRate": 5.9
    }
  ]
}

date ist der Beginn des Buckets in UTC. followers ist die zuletzt bekannte Zahl am Ende des Buckets. Die übrigen Zähler summieren die Beiträge, die innerhalb davon veröffentlicht wurden.

GET /api/v1/analytics/platform-breakdown

GET /api/v1/analytics/platform-breakdown?from=2026-08-01&to=2026-08-31

Nimmt nur from und to entgegen. Gibt { "platforms": [...] } zurück, mit einer Zeile pro Plattform, die Daten im Workspace hat. Jede Zeile enthält die Overview-Metriken für diese Plattform sowie supportedMetrics, die Liste der Metriken, die die Plattform meldet. Vergleichen Sie zwei Plattformen nur bei Metriken, die beide dort aufführen: Eine Pinterest-Zeile mit null bei Shares liegt gegenüber Instagram nicht bei Shares zurück, sie meldet sie schlicht nicht.

Aktualität

Die Zahlen aktualisieren sich von selbst alle paar Stunden. Wenn Sie gerade erst veröffentlicht haben und die Zahlen sofort sehen möchten, siehe Analytics-Synchronisierung.