Analytics-Überblick | AdaptlyPost

Berechtigung: analytics.read. Siehe Rollen und Berechtigungen.

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, LinkedIn, YouTube, X und das Google Unternehmensprofil ab. Das Google Unternehmensprofil meldet nur Impressionen für den Standort, ohne Zahlen pro Beitrag. Mastodon, Telegram und Tumblr haben keine Analytics. Beim Verbinden eines Kontos werden seine Beiträge der letzten 180 Tage importiert, und die Analytics bleiben danach erhalten, solange das Konto verbunden ist. So können Sie jeden Zeitraum in diesem Verlauf abfragen.

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
connectionIds	Beschränkt auf diese Konten, über ihre `id` aus Verbundene Konten. Wiederholen Sie den Schlüssel für jeden Wert. Weglassen für alle Konten

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 from, to und connectionIds entgegen, aber nicht platforms. 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.