REST APIGET

Analityka postów

Wyświetlenia, polubienia, komentarze, udostępnienia, zapisy, zasięg i zaangażowanie każdego posta opublikowanego w danym oknie, z sortowaniem według dowolnej metryki, a także posty, które AdaptlyPost znalazł na twoich kontach, ale ich nie opublikował.

Uprawnienie: analytics.read. Zobacz Role i uprawnienia.

Analityka postów odpowiada na pytania „jak poradził sobie ten post” i „które posty wypadły najlepiej”. Obejmuje posty opublikowane przez AdaptlyPost oraz posty wykryte na połączonych kontach, więc post utworzony w natywnej aplikacji również pojawi się ze swoimi liczbami.

Chodzi tu o wyniki, a nie o dostarczenie. Wyniki posta mówią, czy post dotarł na każdą platformę, a ten endpoint pokazuje, co działo się później.

GET /api/v1/analytics/posts

GET /api/v1/analytics/posts?from=2026-08-01&to=2026-08-31&sortBy=VIEWS&page=1&limit=20
ParametrOpis
from, toOkno, ISO 8601. Posty są wybierane według daty publikacji. Wymagane
platformsOgranicza wyniki do tych platform. Powtórz klucz dla każdej wartości
connectionIdsOgranicza wyniki do tych kont, według ich id z Konta społecznościowe. Powtórz klucz dla każdej wartości
sortByVIEWS, LIKES, COMMENTS, SHARES, SAVES, CLICKS, IMPRESSIONS, ENGAGEMENT_RATE lub PUBLISHED_AT (domyślnie). Malejąco
pageNumer strony, od 1
limitLiczba postów na stronę, od 1 do 100, domyślnie 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
}
PoleOpis
idId rekordu analityki. Jedyny identyfikator, który ma każdy śledzony post
postIdId posta w AdaptlyPost, którego można użyć z Pobierz post. Null dla posta wykrytego na koncie
postPlatformIdplatformId z Wyników posta. Null dla wykrytych postów
connectionIdKonto, do którego należy post: jego id z Konta społecznościowe
accountNameWyświetlana nazwa tego konta, na każdej platformie
permalinkPubliczny adres URL posta na platformie, jeśli jest znany
metricsOstatnio odczytane liczniki. Metryka, której platforma nie raportuje, ma wartość null
metrics.engagedViews, averageViewDurationSeconds, averageViewPercentageTylko YouTube. Wyświetlenia odtworzone dalej niż pierwsza klatka, średnia długość odtwarzania w sekundach i średnia część filmu obejrzana na odtworzenie (może przekroczyć 100, gdy widzowie oglądają ponownie). Null na innych platformach oraz do czasu, aż YouTube Analytics uwzględni film, co trwa kilka dni

Posty z Google Business Profile są wymieniane z metrykami null: Google Business Profile raportuje wyświetlenia tylko dla lokalizacji, a nie dla poszczególnych postów.

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

Te same wiersze bez paginacji: najlepsze posty w liczbie limit (od 1 do 50, domyślnie 10) posortowane według sortBy (domyślnie VIEWS). Zwraca { "posts": [...] }. Przyjmuje te same filtry platforms i connectionIds.

GET /api/v1/analytics/discovered-posts

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

Posty znalezione na połączonych kontach, których AdaptlyPost nie opublikował, przeznaczone do kalendarza tylko do odczytu. Ich metryki są w /analytics/posts, a ten endpoint zwraca sam post.

{
  "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 przyjmuje wartości od 1 do 1000, domyślnie 200. Filtruj wyniki tak samo, za pomocą platforms i connectionIds.

Jak daleko sięga historia

Po połączeniu konta importowane są jego posty z ostatnich 180 dni, a od tej chwili analityka jest przechowywana tak długo, jak konto pozostaje połączone. Post odświeża się przez 180 dni od publikacji, a potem zachowuje ostatnie liczby. Niektóre platformy udostępniają dla danego konta krótszą historię; Synchronizacja analityki podaje dokładny horyzont dla każdego konta.