Beitrags-Analytics | AdaptlyPost

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
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",
      "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
permalink	Öffentliche URL des Beitrags auf der Plattform, sofern bekannt
metrics	Zuletzt erfasste Zähler. Eine Metrik, die die Plattform nicht meldet, ist null

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.

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",
      "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.

Wie weit zurück

Nichts, was vor mehr als 180 Tagen veröffentlicht wurde, wird aufgeführt, auf keiner Plattform. Manche Plattformen stellen für ein bestimmtes Konto weniger Verlauf zur Verfügung; Analytics-Synchronisierung meldet den genauen Horizont je Konto.