Liczba obserwujących TikToka i informacje o profilu przez API
Interfejs API dla firm TikToka zwraca liczbę obserwujących konta jako followers_count z GET /business/get/, obok username, display_name, profile_image, bio_description, is_verified, following_count, total_likes i videos_count. Każde z tych pól wymaga zakresu, na przykład user.info.stats. Endpoint /v2/user/info/ w Display API zwraca tę samą liczbę jako follower_count dla użytkownika, który autoryzował aplikację.
easyCoexistence odczytuje profil i liczbę obserwujących konta TikTok za pomocą get_social_insights z poziomu Claude, ChatGPT lub własnego kodu: podajesz pola, takie jak followers_count, total_likes lub videos_count, a dla wierszy dziennych także daty; zwraca dane TikToka w niezmienionej postaci.
Zakres dla followers_count, following_count, total_likes i videos_count na początku /business/get/.
Jak TikTok aktualizuje followers_count i pola profilu, a dzienne metryki zwykle pojawiają się po 24 do 48 godzin.
Nazwa liczby w /v2/user/info/ w Display API, pod własnym zakresem user.info.stats.
Najdłuższy okres wstecz dla dziennego followers_count i pozostałych dziennych metryk w /business/get/.
Co /business/get/ zwraca, gdy żądanie nie podaje żadnych pól: display_name i profile_image.
Jakie pola profilu zwraca /business/get/?
Te wymienione w parametrze fields, będącym tablicą JSON w ciągu zapytania. Każde pole odblokowuje zakres, który właściciel konta przyznał przy autoryzacji aplikacji. Żądanie bez wskazanych pól dostaje wyłącznie display_name i profile_image. TikTok aktualizuje poniższe pola profilu i liczniki w czasie rzeczywistym:
Jak zapytać o liczbę obserwujących?
Wysyłając GET do /business/get/, z tokenem konta w nagłówku Access-Token oraz business_id, czyli open_id z wymiany tokenu, a także z polami, które chcesz pobrać. Bieżące liczniki znajdują się na początku data, a dzienne wartości w metrics:
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/get/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["display_name","followers_count","following_count","is_verified","daily_new_followers","daily_lost_followers"]'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"display_name": "<DISPLAY_NAME>",
"followers_count": 13,
"following_count": 2,
"is_verified": false,
"metrics": [
{ "date": "<DATE>", "followers_count": 13, "daily_new_followers": 0, "daily_lost_followers": 0 }
]
}
}Jak śledzić obserwujących dzień po dniu?
Wpisz followers_count w fields, a TikTok zwróci go dwa razy: sumę od początku na górze data, w user.info.stats, oraz sumę za każdy dzień w metrics, w user.insights. start_date i end_date, w UTC, wybierają dni, do 60 dni wstecz. Bez nich TikTok zwraca 7 dni do dnia poprzedzającego żądanie. Trzy dzienne pola pokazują zmiany stojące za sumą, dla kont z Advanced Access lub zweryfikowanym kontem firmowym:
daily_new_followers: obserwujący przybyli tego dnia.daily_lost_followers: obserwujący utraceni tego dnia.daily_total_followers: dzienny wzrost netto, czyli przyrosty minus utraty.
Co zwraca Display API?
Ten sam rodzaj profilu dla użytkownika, który autoryzował aplikację w TikTok for Developers, z GET https://open.tiktokapis.com/v2/user/info/ i polami wymienionymi w parametrze fields. Jego nazwy i zakresy różnią się od API dla firm, a obiekt user nie zawiera dziennej historii:
| API for Business: /business/get/ | Display API: /v2/user/info/ | |
|---|---|---|
| Followers | followers_count | follower_count |
| Following | following_count | following_count |
| Likes | total_likes | likes_count |
| Videos | videos_count | video_count |
| Count scope | user.info.stats | user.info.stats |
| Username scope | user.info.username | user.info.profile |
| Photo | profile_image | avatar_url, avatar_url_100, avatar_large_url |
| Daily history | Up to 60 days in metrics | Not in the user object |
Czy można odczytać liczbę obserwujących innego konta?
Nie tymi dwoma endpointami. /business/get/ odpowiada dla business_id konta, które autoryzowało aplikację, a /v2/user/info/ dla użytkownika, którego token wykonuje wywołanie. Research API TikToka ma endpoint /v2/research/user/info/, który przyjmuje nazwę użytkownika i zwraca follower_count, following_count, likes_count i video_count, ale wyłącznie dla badaczy zatwierdzonych przez TikTok.
Jak easyCoexistence odczytuje profil?
Przy użyciu get_social_insights na koncie, bez object_id: nazwy w metrics stają się polami /business/get/, a start_date i end_date w params wybierają dni. Wynik to dane TikToka w niezmienionej postaci. Pusta lista metrics prosi o nazwę użytkownika, nazwę wyświetlaną, zdjęcie, liczbę obserwujących, obserwowanych, polubień i filmów, dwie flagi na poziomie konta oraz dzienne wyświetlenia filmów, wyświetlenia profilu i nowych obserwujących. list_social_accounts pokazuje też nazwę użytkownika i nazwę wyświetlaną zapisane przy połączeniu konta.
get_social_insights {
"account_id": "<ACCOUNT_ID>",
"metrics": ["followers_count", "following_count", "total_likes", "videos_count"],
"params": { "start_date": "2026-10-02", "end_date": "2026-10-31" }
}Typowe błędy
- Żądanie followers_count bez user.info.stats w tokenie. TikTok zwraca każde pole tylko wtedy, gdy właściciel przyznał jego zakres, więc właściciel musi ponownie autoryzować aplikację.
- Zapisywanie profile_image na później. To tymczasowy adres URL, którego wygaśnięcie zapisane jest w parametrze x-expires, więc pobierz świeży, gdy będzie potrzebny.
- Odczytywanie follower_count z /business/get/. To nazwa z Display API; API dla firm nazywa to pole followers_count.
- Oczekiwanie nowych i utraconych obserwujących na koncie osobistym. TikTok zwraca te dzienne pola tylko dla Advanced Access lub zweryfikowanych kont firmowych.
Od US$ 9 do US$ 0,75 za połączenie miesięcznie, spadając wraz z liczbą połączeń, z pierwszymi 3 dniami bezpłatnie.
Najczęściej zadawane pytania
Czy TikTok API pokazuje wzrost obserwujących w czasie?
Tak, za okres do 60 dni: followers_count dla każdego dnia w metrics oraz dzienne nowe, utracone i netto obserwujące przy Advanced Access lub zweryfikowanym koncie firmowym.
Jakiego zakresu wymaga liczba obserwujących TikToka?
user.info.stats, w obu interfejsach API: odblokowuje followers_count w /business/get/ oraz follower_count w /v2/user/info/ w Display API.
Czy osobiste konto TikTok zwraca liczbę obserwujących?
Tak. followers_count zależy od zakresu, a nie od poziomu konta; tylko niektóre dzienne pola wymagają Advanced Access lub zweryfikowanego konta firmowego.
Jak często aktualizuje się liczba obserwujących TikToka?
TikTok oznacza followers_count na najwyższym poziomie jako czas rzeczywisty, a dzienne wiersze w metrics zwykle pojawiają się z opóźnieniem 24 do 48 godzin, w UTC.
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