Analytics-Synchronisierung

Analytics werden nach einem festen Zeitplan von jeder Plattform gelesen, je nach den Rate Limits der Plattform alle paar Stunden. Zwei Endpunkte zeigen Ihnen den aktuellen Stand und lassen Sie eine Aktualisierung anfordern, wenn Sie nicht warten können.

GET /api/v1/analytics/sync-status

GET /api/v1/analytics/sync-status

{
  "accountGroupId": "ag_01j9x",
  "syncInProgress": false,
  "lastSyncedAt": "2026-09-08T06:12:41.000Z",
  "historyHorizonAt": "2026-03-12T00:00:00.000Z",
  "platforms": [
    {
      "platform": "INSTAGRAM",
      "connectionId": "cmlxmnxn20006hzpzvo291ckg",
      "accountName": "adaptlypost",
      "status": "IDLE",
      "lastSyncedAt": "2026-09-08T06:12:41.000Z",
      "lastErrorMessage": null,
      "historyHorizonAt": "2026-03-12T00:00:00.000Z",
      "lastDiscoveryAt": "2026-09-08T06:10:03.000Z",
      "needsAnalyticsReconnect": false
    }
  ]
}

Feld	Beschreibung
syncInProgress	True, solange ein Konto in der Warteschlange steht oder synchronisiert wird
historyHorizonAt	Frühestes Datum, für das ein Konto Daten hat. Frühere Daten bedeuten keine Daten, nicht null Aktivität
connectionId	Die Konto-`id` aus Verbundene Konten
status	`IDLE`, `QUEUED`, `SYNCING` oder `FAILED`
lastErrorMessage	Warum die letzte Synchronisierung fehlgeschlagen ist, sofern zutreffend
needsAnalyticsReconnect	True, wenn das Konto verbunden wurde, bevor es Analytics-Berechtigungen gab

Konten auf Plattformen ohne Analytics (X) werden nicht aufgeführt.

Erneute Verbindung für Analytics

Social-Media-Plattformen erlauben es einer App nicht, einer bestehenden Freigabe nachträglich Berechtigungen hinzuzufügen. Ein Konto, das verbunden wurde, bevor AdaptlyPost um Analytics-Zugriff gebeten hat, bleibt inaktiv, ohne Synchronisierungen und ohne Fehler, bis die Person, der es gehört, die Verbindung erneuert und die zusätzlichen Berechtigungen genehmigt. Genau das markiert needsAnalyticsReconnect. Ein Verbindungslink eignet sich dafür, sodass eine Agentur oder ein Kunde die Verbindung erneuern kann, ohne ein Passwort zu teilen.

POST /api/v1/analytics/sync

POST /api/v1/analytics/sync

Kein Body. Stellt für jedes Konto mit Analytics eine Synchronisierung in die Warteschlange und liest die letzten 7 Tage erneut. Verwenden Sie dies direkt nach der Veröffentlichung, wenn die planmäßige Aktualisierung noch zu weit entfernt ist.

{
  "queued": true,
  "message": "Analytics sync queued. Fresh numbers will appear within a few minutes",
  "cooldownSecondsRemaining": null
}

Ein Lauf pro Workspace alle 10 Minuten. Innerhalb der Cooldown-Phase ist die Antwort weiterhin 200:

{
  "queued": false,
  "message": "Analytics were synced recently. Please try again in 412 seconds",
  "cooldownSecondsRemaining": 412
}

Der Lauf ist asynchron. Fragen Sie GET /api/v1/analytics/sync-status ab, bis syncInProgress false ist, und lesen Sie die Metriken danach erneut. Versuchen Sie es nicht erneut innerhalb der Cooldown-Phase; die Antwort ändert sich dadurch nicht.