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| Parametr | Opis |
|---|---|
| from, to | Okno, ISO 8601. Posty są wybierane według daty publikacji. Wymagane |
| platforms | Ogranicza wyniki do tych platform. Powtórz klucz dla każdej wartości |
| connectionIds | Ogranicza wyniki do tych kont, według ich id z Konta społecznościowe. Powtórz klucz dla każdej wartości |
| sortBy | VIEWS, LIKES, COMMENTS, SHARES, SAVES, CLICKS, IMPRESSIONS, ENGAGEMENT_RATE lub PUBLISHED_AT (domyślnie). Malejąco |
| page | Numer strony, od 1 |
| limit | Liczba 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
}| Pole | Opis |
|---|---|
| id | Id rekordu analityki. Jedyny identyfikator, który ma każdy śledzony post |
| postId | Id posta w AdaptlyPost, którego można użyć z Pobierz post. Null dla posta wykrytego na koncie |
| postPlatformId | platformId z Wyników posta. Null dla wykrytych postów |
| connectionId | Konto, do którego należy post: jego id z Konta społecznościowe |
| accountName | Wyświetlana nazwa tego konta, na każdej platformie |
| permalink | Publiczny adres URL posta na platformie, jeśli jest znany |
| metrics | Ostatnio odczytane liczniki. Metryka, której platforma nie raportuje, ma wartość null |
| metrics.engagedViews, averageViewDurationSeconds, averageViewPercentage | Tylko 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=5Te 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=200Posty 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.