Przegląd analityki
Odczytaj wyświetlenia, polubienia, komentarze, udostępnienia, obserwujących i wskaźnik zaangażowania dla wybranego okna dat: łącznie, dziennie i według platform, każdą wartość w porównaniu z poprzednim oknem.
Uprawnienie: analytics.read. Zobacz Role i uprawnienia.
Trzy endpointy odpowiadają na pytanie „jak nam poszło”: jeden podaje sumę, drugi trend, a trzeci porównanie platform. Wszystkie czytają te same liczby. Analityka obejmuje Facebooka, Instagram, Threads, TikToka, Pinterest, Bluesky, LinkedIn, YouTube, X i Google Business Profile. Google Business Profile raportuje tylko wyświetlenia lokalizacji, bez liczb dla poszczególnych postów. Mastodon, Telegram, Tumblr i WordPress nie mają analityki. 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, więc możesz odpytywać dowolny zakres dat z tej historii.
Parametry okna
| Parametr | Opis |
|---|---|
| from | Początek okna, ISO 8601. Wymagany |
| to | Koniec okna, ISO 8601, nie wcześniejszy niż from. Wymagany |
| platforms | Ogranicza wyniki do tych platform. Powtórz klucz dla każdej wartości. Pomiń, aby objąć wszystkie obsługiwane platformy |
| connectionIds | Ogranicza wyniki do tych kont, według ich id z Konta społecznościowe. Powtórz klucz dla każdej wartości. Pomiń, aby objąć wszystkie konta |
Metryki liczą posty opublikowane w oknie. Każdej wartości towarzyszy ta sama metryka dla okna o tej samej długości, kończącego się tuż przed from, więc okno 30-dniowe jest porównywane z 30 dniami, które je poprzedzają.
GET /api/v1/analytics/overview
GET /api/v1/analytics/overview?from=2026-08-01&to=2026-08-31&platforms=INSTAGRAM&platforms=TIKTOK{
"views": { "value": 48210, "previousValue": 39100, "deltaPercent": 23.3 },
"likes": { "value": 2210, "previousValue": 1980, "deltaPercent": 11.6 },
"comments": { "value": 340, "previousValue": 410, "deltaPercent": -17.1 },
"shares": { "value": 128, "previousValue": null, "deltaPercent": null },
"followers": { "value": 12980, "previousValue": 12410, "deltaPercent": 4.6 },
"postsCount": { "value": 42, "previousValue": 37, "deltaPercent": 13.5 },
"avgViewsPerPost": { "value": 1147.9, "previousValue": 1056.8, "deltaPercent": 8.6 },
"engagementRate": { "value": 5.55, "previousValue": 6.11, "deltaPercent": -9.2 },
"partialMetrics": ["shares"],
"lastSyncedAt": "2026-09-08T06:12:41.000Z"
}| Pole | Opis |
|---|---|
| value | Metryka dla żądanego okna |
| previousValue | Ta sama metryka dla poprzedniego okna o tej samej długości |
| deltaPercent | Zmiana od previousValue do value. Null, gdy poprzednia wartość wynosi 0 lub jest nieznana |
| followers | Najnowsza liczba obserwujących na moment to, porównana z liczbą na koniec poprzedniego okna |
| engagementRate | Polubienia, komentarze i udostępnienia podzielone przez wyświetlenia, w procentach |
| partialMetrics | Metryki, których co najmniej jedna z wybranych platform nie raportuje. Ich sumy obejmują tylko platformy, które je raportują |
| accountActivityConnectionIds | Konta liczone według aktywności całego konta w każdym dniu okna (każdy post, niezależnie od daty publikacji), a nie według sum postów opublikowanych w oknie, np. profile osobiste na LinkedInie i lokalizacje Google Business Profile. Nie mają wierszy w Analityka postów |
| lastSyncedAt | Ostatnia udana synchronizacja wśród wybranych platform |
Metryka, której nie raportuje żadna z wybranych platform, ma wartość null. Oznacza to „nie zmierzono”, a nie zero. Ma ją też wtedy, gdy posty istnieją, ale żaden z nich jej nie zgłosił.
GET /api/v1/analytics/timeseries
GET /api/v1/analytics/timeseries?from=2026-08-01&to=2026-08-31&granularity=WEEKLYDodaje parametr granularity: DAILY (domyślnie), WEEKLY lub MONTHLY.
{
"points": [
{
"date": "2026-08-03T00:00:00.000Z",
"views": 11820,
"likes": 590,
"comments": 82,
"shares": 31,
"followers": 12520,
"postsCount": 10,
"engagementRate": 5.9
}
]
}date to początek przedziału w UTC. followers to ostatnia znana liczba na koniec przedziału. Pozostałe liczniki sumują posty opublikowane w jego obrębie.
GET /api/v1/analytics/platform-breakdown
GET /api/v1/analytics/platform-breakdown?from=2026-08-01&to=2026-08-31Przyjmuje from, to i connectionIds, ale nie platforms. Zwraca { "platforms": [...] } z jednym wierszem na każdą platformę, która ma dane w obszarze roboczym. Każdy wiersz zawiera metryki przeglądu dla tej platformy oraz supportedMetrics, czyli listę metryk, które platforma raportuje. Porównuj dwie platformy tylko pod względem metryk, które obie tam wymieniają: wiersz Pinteresta z null w udostępnieniach nie przegrywa z Instagramem, po prostu ich nie raportuje.
Aktualność danych
Liczby odświeżają się same co kilka godzin. Jeśli właśnie coś opublikowano i potrzebujesz liczb od razu, zobacz Synchronizacja analityki.