Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Demografski podaci publike na TikToku putem API-ja

TikTokov API for Business vraća demografske podatke pratitelja računa putem GET /business/get/: audience_ages, audience_genders, audience_countries i audience_cities, svaki kao popis udjela pratitelja, za račune s najmanje 100 pratitelja. Satna aktivnost pratitelja dolazi kao audience_activity u metrikama svakog dana, za račune s Advanced Access ili Verified Business Accounts i istih 100 pratitelja. Sve zahtijeva opseg user.insights.

easyCoexistence čita demografiju pratitelja TikTok računa pomoću get_social_insights iz Claudea, ChatGPT-ja ili vašeg vlastitog koda: zatražite audience_ages, audience_genders, audience_countries, audience_cities ili audience_activity i dobit ćete TikTokove popise onakve kakvi jesu.

100

Broj pratitelja koji račun mora imati prije nego TikTok vrati raščlambe po dobi, spolu, zemlji i gradu.

5 groups

Dobne skupine u audience_ages: 18-24, 25-34, 35-44, 45-54 i 55+.

UTC+0

Vremenska zona audience_activity, satnog broja pratitelja aktivnih na TikToku.

24 to 48 h

Uobičajeno kašnjenje za audience_countries, audience_genders i audience_activity, koje TikTok izračunava izvan mreže.

Koje demografske podatke vraća endpoint računa?

GET /business/get/ ih vraća kada su navedeni u fields. Četiri raščlambe nalaze se na vrhu data, jedan popis po dimenziji, a satna aktivnost u metrics, jedan skup po danu:

  • audience_ages: udio pratitelja u svakoj dobnoj skupini, 18-24, 25-34, 35-44, 45-54 i 55+.
  • audience_genders: udio pratitelja po spolu: Female, Male ili Other.
  • audience_countries: udio pratitelja po državi ili regiji, kao ISO 3166-1 alpha-2 kôd.
  • audience_cities: udio pratitelja po gradu, prema city_name.
  • audience_activity: za svaki dan, pratitelji aktivni na TikToku u svakom satu, kao hour i count.

Kako ih zatražiti?

Nazivima polja u fields, kao JSON niz, i rasponom datuma u UTC-u za dnevne metrike koje sadrže audience_activity. start_date i end_date sežu unatrag do 60 dana, a bez njih TikTok vraća 7 dana do dana prije zahtjeva:

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'

Kako izgleda odgovor?

Svaka raščlamba je popis objekata koji spajaju skupinu s njezinim postotkom, a svaki dan u metrics nosi svoj datum i popis sati u audience_activity. Vrijednosti niže su TikTokovi vlastiti primjeri, skraćeni na popis spolova i nekoliko sati:

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 }
        ]
      }
    ]
  }
}

Koji računi dobivaju koje raščlambe?

Udjeli po dobi, spolu, zemlji i gradu dolaze kada račun ima najmanje 100 pratitelja; TikTokov vlastiti primjer za račun s 13 pratitelja vraća te popise prazne. audience_activity također traži 100 pratitelja, a uz to račun s Advanced Access, što se dobiva povezivanjem s računom TikTok for Business ili neverificiranim Business Centerom, ili Verified Business Account. Za svako od tih polja na tokenu je potreban opseg user.insights.

Koliko su demografski podaci svježi?

Dan ili dva iza. TikTok navodi audience_countries, audience_genders i audience_activity među poljima koja obično kasne 24 do 48 sati, u UTC-u, i daje isto vrijeme ažuriranja za dobne skupine i gradove. Podaci dolaze iz alata TikTok Analytics, koji vlasnik uključuje u aplikaciji nakon objave prvog videa, a podaci od prije toga nisu dostupni. TikTok demografiju temelji na više čimbenika, uključujući ono što korisnici upišu u svoje profile.

Po čemu se demografija pratitelja razlikuje od gledatelja videa?

Opisuju različite ljude. Popisi računa pokrivaju pratitelje. /business/video/list/ vraća raščlambe onih koji su pogledali jednu objavu: audience_genders, audience_countries i audience_cities, do 10 unosa svaki, te audience_types, koji gledatelje dijeli na nove i povratne, pratitelje i nepratitelje. Za to je potreban opseg video.insights umjesto user.insights.

Kako ih easyCoexistence čita?

Pomoću get_social_insights nad računom: izostavite object_id, navedite nazive polja kao metrics i proslijedite start_date i end_date u params kada želite audience_activity za određene dane. Vraća TikTokove popise onakvima kakvi jesu, pa se udjeli i sati čitaju točno kao gore.

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" }
}

Uobičajene pogreške

  • Očekivanje raščlamba za mali račun. TikTok vraća udjele po dobi, spolu, zemlji i gradu od 100 pratitelja, a njegov primjer za račun s 13 pratitelja pokazuje prazne popise.
  • Čitanje sati iz audience_activity kao lokalnog vremena. TikTok ih prikazuje u UTC+0, pa ih prije planiranja objava pomaknite na vremensku zonu publike.
  • Izjednačavanje demografije pratitelja s demografijom gledatelja. Popisi računa opisuju pratitelje, a audience_countries videa opisuje ljude koji su ga pogledali.
  • Očekivanje audience_activity na osobnom računu. TikTok ga vraća za račune s Advanced Access ili Verified Business Accounts koji imaju najmanje 100 pratitelja.
Radite ovo uz EasyCoexistence

Od US$ 9 do US$ 0,75 po vezi mjesečno, cijena pada kako dodajete veze, a prva 3 dana su besplatna.

Često postavljana pitanja

Može li TikTok API prikazati dob i spol mojih pratitelja?

Da. /business/get/ vraća audience_ages i audience_genders, udjele pratitelja po skupini, kada račun ima najmanje 100 pratitelja i token ima user.insights.

Koje dobne skupine koristi TikTok API?

18-24, 25-34, 35-44, 45-54 i 55+, svaka s udjelom pratitelja u njoj.

Govori li TikTok API kada su moji pratitelji online?

audience_activity daje pratitelje aktivne na TikToku po satu, u UTC+0, unutar metrika svakog dana, za Advanced Access ili Verified Business Accounts sa 100 ili više pratitelja.

Kako TikTok API daje zemlje pratitelja?

Kao ISO 3166-1 alpha-2 kôdove države ili regije u audience_countries, svaki s udjelom pratitelja odatle.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na