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

Dane demograficzne odbiorców TikTok przez API

API TikTok for Business zwraca dane demograficzne obserwujących konta TikTok z GET /business/get/: audience_ages, audience_genders, audience_countries i audience_cities, każde jako listę udziałów obserwujących, dla kont z co najmniej 100 obserwującymi. Godzinową aktywność obserwujących zwraca jako audience_activity w metrykach każdego dnia, dla kont z Advanced Access lub Verified Business Accounts oraz tych samych 100 obserwujących. Wszystkie pola wymagają zakresu user.insights.

easyCoexistence odczytuje dane demograficzne obserwujących konta TikTok przez get_social_insights z Claude, ChatGPT lub własnego kodu: poproś o audience_ages, audience_genders, audience_countries, audience_cities lub audience_activity, a zwróci listy TikToka w niezmienionej postaci.

100

Liczba obserwujących, jaką konto musi mieć, zanim TikTok zwróci podziały według wieku, płci, kraju i miasta.

5 groups

Grupy wiekowe w audience_ages: 18-24, 25-34, 35-44, 45-54 i 55+.

UTC+0

Strefa czasowa audience_activity, czyli godzinowa liczba obserwujących aktywnych na TikToku.

24 to 48 h

Zwykłe opóźnienie dla audience_countries, audience_genders i audience_activity, które TikTok oblicza offline.

Jakie dane demograficzne zwraca endpoint konta?

GET /business/get/ zwraca je, gdy są wymienione w fields. Cztery podziały znajdują się na górze data, po jednej liście na wymiar, a godzinowa aktywność jest w metrics, po jednym zestawie na dzień:

  • audience_ages: udział obserwujących w każdej grupie wiekowej, 18-24, 25-34, 35-44, 45-54 i 55+.
  • audience_genders: udział obserwujących według płci: Female, Male lub Other.
  • audience_countries: udział obserwujących w każdym kraju lub regionie, jako kod ISO 3166-1 alpha-2.
  • audience_cities: udział obserwujących w każdym mieście, według city_name.
  • audience_activity: dla każdego dnia liczba obserwujących aktywnych na TikToku w każdej godzinie, jako hour i count.

Jak je pobrać?

Podajesz nazwy pól w fields jako tablicę JSON oraz zakres dat w UTC dla dziennych metryk, które zawierają audience_activity. start_date i end_date sięgają wstecz do 60 dni; bez nich TikTok zwraca 7 dni do dnia poprzedzającego zapytanie:

Follower demographics for a TikTok account
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=["audience_ages","audience_genders","audience_countries","audience_cities","audience_activity"]' \
  --data-urlencode 'start_date=2026-10-24' \
  --data-urlencode 'end_date=2026-10-30'

Jak wygląda odpowiedź?

Każdy podział to lista obiektów łączących grupę z jej procentem, a każdy dzień w metrics ma datę i listę godzin w audience_activity. Poniższe wartości to przykłady TikToka, skrócone do listy płci i kilku godzin:

Demographics in the /business/get/ response
{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "audience_genders": [
      { "gender": "Female", "percentage": 0.7554470336505679 },
      { "gender": "Male", "percentage": 0.24455296634943213 }
    ],
    "metrics": [
      {
        "date": "<DATE>",
        "audience_activity": [
          { "hour": "20", "count": 1 },
          { "hour": "23", "count": 4 },
          { "hour": "7", "count": 4 }
        ]
      }
    ]
  }
}

Które konta dostają które podziały?

Udziały według wieku, płci, kraju i miasta pojawiają się, gdy konto ma co najmniej 100 obserwujących; przykład TikToka dla konta z 13 obserwującymi zwraca te listy puste. audience_activity też wymaga 100 obserwujących, a do tego konta z Advanced Access, które uzyskuje się przez powiązanie z kontem TikTok for Business lub niezweryfikowanym Business Center, albo Verified Business Account. Każde z tych pól wymaga zakresu user.insights w tokenie.

Jak świeże są dane demograficzne?

Z opóźnieniem jednego lub dwóch dni. TikTok wymienia audience_countries, audience_genders i audience_activity wśród pól, które zwykle opóźniają się o 24 do 48 godzin, w UTC, i podaje ten sam czas aktualizacji dla wieku i miast. Dane pochodzą z TikTok Analytics, który właściciel włącza w aplikacji po opublikowaniu pierwszego wideo; dane sprzed tego momentu nie są dostępne. TikTok opiera dane demograficzne na kilku czynnikach, w tym na tym, co użytkownicy wpisują w swoich profilach.

Czym różnią się dane demograficzne obserwujących od widzów wideo?

Opisują różne osoby. Podziały konta dotyczą obserwujących. /business/video/list/ zwraca podziały osób, które obejrzały jeden post: audience_genders, audience_countries i audience_cities, po maksymalnie 10 wpisów każde, oraz audience_types, który dzieli widzów na nowych i powracających, obserwujących i nieobserwujących. Te pola wymagają zakresu video.insights zamiast user.insights.

Jak easyCoexistence je odczytuje?

Za pomocą get_social_insights na koncie: pomiń object_id, wymień nazwy pól jako metrics i podaj start_date oraz end_date w params, gdy chcesz audience_activity dla konkretnych dni. Narzędzie zwraca listy TikToka w takiej postaci, w jakiej są, więc udziały i godziny czytasz dokładnie tak, jak wyżej.

Follower demographics through MCP
get_social_insights {
  "account_id": "<ACCOUNT_ID>",
  "metrics": ["audience_ages", "audience_genders", "audience_countries", "audience_cities", "audience_activity"],
  "params": { "start_date": "2026-10-24", "end_date": "2026-10-30" }
}

Typowe błędy

  • Oczekiwanie podziałów dla małego konta. TikTok zwraca udziały według wieku, płci, kraju i miasta od 100 obserwujących, a jego przykład dla konta z 13 obserwującymi pokazuje puste listy.
  • Odczytywanie godzin audience_activity jako czasu lokalnego. TikTok podaje je w UTC+0, więc przesuń je do strefy czasowej odbiorców, zanim zaplanujesz publikacje.
  • Traktowanie danych demograficznych obserwujących jako danych widzów. Listy konta opisują obserwujących, a audience_countries wideo opisuje osoby, które je obejrzały.
  • Oczekiwanie audience_activity na koncie osobistym. TikTok zwraca je dla kont z Advanced Access lub Verified Business Accounts, które mają co najmniej 100 obserwujących.
Z EasyCoexistence zrobisz to

US$ 9 do US$ 0,75 za połączenie miesięcznie, spadając wraz z liczbą połączeń, a pierwsze 3 dni są bezpłatne.

Najczęściej zadawane pytania

Czy API TikTok pokaże wiek i płeć moich obserwujących?

Tak. /business/get/ zwraca audience_ages i audience_genders, czyli udziały obserwujących w każdej grupie, gdy konto ma co najmniej 100 obserwujących, a token ma user.insights.

Jakie grupy wiekowe stosuje API TikTok?

18-24, 25-34, 35-44, 45-54 i 55+, każda z udziałem obserwujących w niej.

Czy API TikTok mówi, kiedy moi obserwujący są online?

audience_activity podaje godzinową liczbę obserwujących aktywnych na TikToku, w UTC+0, w metrykach każdego dnia, dla kont z Advanced Access lub Verified Business Accounts i 100 obserwującymi lub więcej.

Jak API TikTok podaje kraje obserwujących?

Jako kody krajów lub regionów ISO 3166-1 alpha-2 w audience_countries, każdy z udziałem obserwujących stamtąd.

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