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.
Najdłuższy okres wstecz dla dziennych metryk konta; bez dat API zwraca ostatnie 7 dni.
Zwykłe opóźnienie, zanim dostępne będą dzienne wartości i wyniki postów, takie jak polubienia, wyświetlenia i udostępnienia.
Czas od publikacji, po którym dane posta przestają się aktualizować.
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_followersiengaged_audience: dziennie, dla kont z Advanced Access lub Verified Business Accounts.audience_ages,audience_genders,audience_countriesiaudience_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.
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