Beitrags-Analytics | AdaptlyPost

Berechtigung: analytics.read. Siehe Rollen und Berechtigungen.

Beitrags-Analytics beantworten die Fragen „Wie hat dieser Beitrag abgeschnitten?" und „Welche Beiträge liefen am besten?". Sie umfassen Beiträge, die über AdaptlyPost veröffentlicht wurden, sowie Beiträge, die auf den verbundenen Konten entdeckt wurden, sodass ein Beitrag aus der nativen App trotzdem mit seinen Zahlen erscheint.

Hier geht es um Performance, nicht um Zustellung. Beitragsergebnisse zeigt Ihnen, ob ein Beitrag jede Plattform erreicht hat; dieser Endpunkt zeigt Ihnen, was danach passiert ist.

GET /api/v1/analytics/posts

GET /api/v1/analytics/posts?from=2026-08-01&to=2026-08-31&sortBy=VIEWS&page=1&limit=20

Parameter	Beschreibung
from, to	Der Zeitraum, ISO 8601. Beiträge werden nach Veröffentlichungsdatum ausgewählt. Erforderlich
platforms	Beschränkt auf diese Plattformen. Wiederholen Sie den Schlüssel für jeden Wert
connectionIds	Beschränkt auf diese Konten, über ihre `id` aus Verbundene Konten. Wiederholen Sie den Schlüssel für jeden Wert
sortBy	`VIEWS`, `LIKES`, `COMMENTS`, `SHARES`, `SAVES`, `CLICKS`, `IMPRESSIONS`, `ENGAGEMENT_RATE` oder `PUBLISHED_AT` (Standard). Absteigend
page	Seitenzahl, ab 1
limit	Beiträge pro Seite, 1 bis 100, Standard 20

{
  "posts": [
    {
      "id": "ap_01j9xk4",
      "postId": "cmm0z0k3q0000i0r5mxn0hfhs",
      "postPlatformId": "cmm0z0k3u0001i0r5dlbfa440",
      "platform": "INSTAGRAM",
      "connectionId": "conn_ig_001",
      "publishedAt": "2026-08-14T10:00:12.000Z",
      "title": "Plan a week of posts in one sitting",
      "thumbnailUrl": "https://cdn.adaptlypost.com/...",
      "permalink": "https://www.instagram.com/p/...",
      "accountName": "adaptlypost",
      "metrics": {
        "views": 9120,
        "likes": 410,
        "comments": 38,
        "shares": 22,
        "saves": 61,
        "clicks": null,
        "impressions": 10230,
        "reach": 8540,
        "engagementRate": 5.15
      }
    }
  ],
  "total": 42,
  "page": 1,
  "limit": 20,
  "hasMore": true
}

Feld	Beschreibung
id	Analytics-Datensatz-ID. Die einzige ID, die jeder erfasste Beitrag hat
postId	Die AdaptlyPost-Beitrags-ID, verwendbar mit Beitrag abrufen. Null bei einem auf dem Konto entdeckten Beitrag
postPlatformId	Die `platformId` aus den Beitragsergebnissen. Null bei entdeckten Beiträgen
connectionId	Das Konto, zu dem der Beitrag gehört: seine `id` aus Verbundene Konten
accountName	Anzeigename dieses Kontos, auf jeder Plattform
permalink	Öffentliche URL des Beitrags auf der Plattform, sofern bekannt
metrics	Zuletzt erfasste Zähler. Eine Metrik, die die Plattform nicht meldet, ist null

Beiträge im Google Unternehmensprofil werden mit null-Metriken aufgeführt: Das Google Unternehmensprofil meldet Impressionen nur für den Standort, nicht pro Beitrag.

GET /api/v1/analytics/top-posts

GET /api/v1/analytics/top-posts?from=2026-08-01&to=2026-08-31&sortBy=ENGAGEMENT_RATE&limit=5

Dieselben Zeilen ohne Paginierung: die obersten limit Beiträge (1 bis 50, Standard 10), sortiert nach sortBy (Standard VIEWS). Gibt { "posts": [...] } zurück. Der Endpunkt akzeptiert dieselben Filter platforms und connectionIds.

GET /api/v1/analytics/discovered-posts

GET /api/v1/analytics/discovered-posts?from=2026-08-01&to=2026-08-31&limit=200

Beiträge, die auf den verbundenen Konten gefunden wurden und die AdaptlyPost nicht veröffentlicht hat, für einen schreibgeschützten Kalender. Ihre Metriken finden Sie unter /analytics/posts; dieser Endpunkt gibt den Beitrag selbst zurück.

{
  "posts": [
    {
      "id": "ap_01j9xk9",
      "platform": "TIKTOK",
      "connectionId": "conn_tt_001",
      "publishedAt": "2026-08-20T17:30:00.000Z",
      "text": "Behind the scenes of our launch week",
      "thumbnailUrl": "https://cdn.adaptlypost.com/...",
      "permalink": "https://www.tiktok.com/@adaptlypost/video/...",
      "accountName": "adaptlypost"
    }
  ]
}

limit akzeptiert 1 bis 1000 und liegt standardmäßig bei 200. Auch hier filtern platforms und connectionIds auf dieselbe Weise.

Wie weit zurück

Beim Verbinden eines Kontos werden seine Beiträge der letzten 180 Tage importiert, und die Analytics bleiben danach erhalten, solange das Konto verbunden ist. Ein Beitrag wird 180 Tage nach der Veröffentlichung weiter aktualisiert und behält danach seine letzten Zahlen. Manche Plattformen stellen für ein bestimmtes Konto weniger Verlauf zur Verfügung; Analytics-Synchronisierung meldet den genauen Horizont je Konto.