REST APIGET

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

ParametrOpis
fromPoczątek okna, ISO 8601. Wymagany
toKoniec okna, ISO 8601, nie wcześniejszy niż from. Wymagany
platformsOgranicza wyniki do tych platform. Powtórz klucz dla każdej wartości. Pomiń, aby objąć wszystkie obsługiwane platformy
connectionIdsOgranicza 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"
}
PoleOpis
valueMetryka dla żądanego okna
previousValueTa sama metryka dla poprzedniego okna o tej samej długości
deltaPercentZmiana od previousValue do value. Null, gdy poprzednia wartość wynosi 0 lub jest nieznana
followersNajnowsza liczba obserwujących na moment to, porównana z liczbą na koniec poprzedniego okna
engagementRatePolubienia, komentarze i udostępnienia podzielone przez wyświetlenia, w procentach
partialMetricsMetryki, których co najmniej jedna z wybranych platform nie raportuje. Ich sumy obejmują tylko platformy, które je raportują
accountActivityConnectionIdsKonta 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
lastSyncedAtOstatnia 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=WEEKLY

Dodaje 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-31

Przyjmuje 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.