Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

API analityki TikTok: metryki konta i wideo

API for Business od TikTok zwraca metryki konta z podziałem na dni, takie jak liczba obserwujących, wyświetlenia wideo, wyświetlenia profilu, polubienia, komentarze i udostępnienia, za ostatnie 60 dni, oraz łączne wyniki każdego wideo, takie jak wyświetlenia, polubienia, komentarze i udostępnienia. Większość liczb pojawia się z opóźnieniem 24 do 48 godzin i zależy od tego, czy w aplikacji włączono TikTok Analytics.

easyCoexistence odczytuje statystyki TikTok za pomocą get_social_insights z Claude, ChatGPT lub własnego kodu: obserwujących, wyświetlenia i polubienia konta dzień po dniu albo wyświetlenia, polubienia, komentarze i udostępnienia wideo.

60 days

Najdłuższy okres wstecz dla dziennych metryk konta; bez dat API zwraca ostatnie 7 dni.

24 to 48 h

Zwykłe opóźnienie, zanim dostępne będą dzienne wartości i wyniki postów, takie jak polubienia, wyświetlenia i udostępnienia.

365 days

Czas od publikacji, po którym dane posta przestają się aktualizować.

100

Liczba obserwujących, jaką konto musi mieć, zanim TikTok zwróci podział obserwujących na wiek, płeć i lokalizację.

Jakie są metryki konta?

GET /business/get/ zwraca profil konta oraz, dla podanych dat, listę metryk z jednym wpisem na dzień, w UTC:

  • followers_count: łączna liczba obserwujących teraz oraz na każdy dzień.
  • video_views, profile_views, likes, comments i shares: dzienne wartości z wszystkich wideo konta.
  • unique_video_views, daily_new_followers, daily_lost_followers i engaged_audience: dziennie, dla kont z Advanced Access lub Verified Business Accounts.
  • audience_ages, audience_genders, audience_countries i audience_cities: podziały obserwujących, dla kont z co najmniej 100 obserwującymi.

Jakie są metryki wideo?

GET /business/video/list/ zwraca publiczne posty konta z łącznymi wartościami od początku, bez ograniczenia do 60 dni wstecz: video_views, likes, comments, shares i favorites, a także zasięg, łączny i średni czas oglądania, wskaźnik pełnego obejrzenia, nowych obserwujących oraz źródła ruchu. Zwraca do 20 postów na stronę, a filters.video_ids wybiera konkretne z nich.

Jak aktualne są dane?

Pola profilu, takie jak nazwa użytkownika i bieżąca liczba obserwujących, są w czasie rzeczywistym. Dzienne metryki konta i wartości postów, takie jak wyświetlenia, polubienia, komentarze i udostępnienia, zwykle pojawiają się z opóźnieniem 24 do 48 godzin, w UTC, a dane posta przestają się aktualizować 365 dni po publikacji. Zasięg, czas oglądania i źródła ruchu mogą brakować przy wideo, którego przez ponad 7 dni nikt nie obejrzał, nie polubił, nie skomentował ani nie udostępnił.

Dlaczego metryki mogą brakować?

API zwraca to, co ma TikTok Analytics. Właściciel konta musi opublikować co najmniej jedno wideo i włączyć Analytics w aplikacji TikTok, a dane sprzed włączenia Analytics nie są dostępne. Niektóre metryki wymagają więcej: zasięg osiągniętej publiczności oraz nowi lub utraceni obserwujący pojawiają się tylko dla kont z Advanced Access lub Verified Business Accounts, a podziały obserwujących zaczynają się od 100 obserwujących.

Dlaczego liczby mogą się różnić od aplikacji TikTok?

Z powodu tego, co obejmują. video_views łączy wyświetlenia organiczne i płatne, a shares liczy zarówno udostępnienia poza TikTokiem, jak i wysyłki do znajomych w aplikacji, więc może wyjść wyżej niż licznik udostępnień na stronie TikTok. Dzienna liczba polubień nie odejmuje polubień cofniętych później.

Jak easyCoexistence odczytuje te dane?

Za pomocą get_social_insights. Dla konta podaj metryki, takie jak followers_count, video_views i likes, z start_date i end_date, a narzędzie zwróci dzienne wiersze z TikToka. Dla jednego wideo podaj jego item_id jako object_id, a zwrócone zostaną wyświetlenia, polubienia, komentarze i udostępnienia; szukane jest wśród 20 najnowszych wideo konta. Dla starszego wideo Twój własny kod wywołuje business/video/list/ z filters.video_ids, używając tokena z get_social_credentials.

Typowe błędy

  • Traktowanie wczorajszych liczb jako ostatecznych. Dzienne metryki mogą mieć opóźnienie 24 do 48 godzin, więc ostatnie dni mogą jeszcze się uzupełniać.
  • Pytanie o więcej niż 60 dni metryk konta. Okres wstecz kończy się na tym limicie, więc jeśli potrzebujesz dłuższej historii, zapisz liczby.
  • Szukanie starego wideo po object_id. get_social_insights przeszukuje 20 najnowszych; dla starszych postów filtruj po video_ids z własnego kodu, z tokenem z get_social_credentials.
  • Porównywanie udostępnień z API z licznikiem na stronie. API liczy też wysyłki do znajomych w TikToku, więc jego wynik jest wyższy.
Z EasyCoexistence zrobisz to

Dla pozostałych pól statystyk TikTok get_social_credentials daje własnemu kodowi token konta. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z bezpłatnym okresem próbnym obejmującym pierwsze 3 dni.

Najczęściej zadawane pytania

Czy API TikTok pokazuje, ilu obserwujących konto straciło?

Tak, jako daily_lost_followers obok daily_new_followers, dla kont z Advanced Access lub Verified Business Accounts.

Jak daleko wstecz sięgają statystyki konta TikTok?

60 dni. Bez dat API zwraca 7 dni kończących się dniem przed zapytaniem, w UTC.

Kiedy przestają się aktualizować dane wideo TikTok?

365 dni po publikacji wideo. Do tego czasu łączne wartości nadal się aktualizują, zwykle z opóźnieniem 24 do 48 godzin.

Czy wyświetlenia wideo TikTok obejmują płatne wyświetlenia?

Tak. Wartość video_views zwracana przez TikTok łączy aktywność organiczną i płatną.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w