Demografski podaci publike na TikToku preko API-ja
TikTok API za poslovanje vraća demografiju pratilaca naloga preko GET /business/get/: audience_ages, audience_genders, audience_countries i audience_cities, svaki kao listu udela pratilaca, za naloge sa najmanje 100 pratilaca. Satna aktivnost pratilaca dolazi kao audience_activity u metrikama svakog dana, za naloge sa Advanced Access ili sa verifikovanim poslovnim nalogom, uz istih 100 pratilaca. Sve to zahteva opseg user.insights.
easyCoexistence čita demografiju pratilaca TikTok naloga preko get_social_insights iz Claude-a, ChatGPT-ja ili vašeg sopstvenog koda: zatražite audience_ages, audience_genders, audience_countries, audience_cities ili audience_activity, i dobićete TikTokove liste onakve kakve jesu.
Broj pratilaca koji nalog mora imati pre nego što TikTok vrati raščlanjivanje po uzrastu, polu, zemlji i gradu.
Starosne grupe u audience_ages: 18-24, 25-34, 35-44, 45-54 i 55+.
Vremenska zona audience_activity, satni broj pratilaca aktivnih na TikToku.
Uobičajeno kašnjenje za audience_countries, audience_genders i audience_activity, koje TikTok obračunava offline.
Koje demografske podatke vraća endpoint za nalog?
GET /business/get/ ih vraća kada su navedeni u polju fields. Četiri raščlanjivanja stoje na vrhu data, jedna lista po dimenziji, a satna aktivnost stoji u metrics, jedan skup po danu:
audience_ages: udeo pratilaca u svakoj starosnoj grupi, 18-24, 25-34, 35-44, 45-54 i 55+.audience_genders: udeo pratilaca po polu: Female, Male ili Other.audience_countries: udeo pratilaca po zemlji ili regionu, kao ISO 3166-1 alpha-2 kod.audience_cities: udeo pratilaca po gradu, premacity_name.audience_activity: za svaki dan, pratioci aktivni na TikToku u svakom satu, kao hour i count.
Kako ih tražite?
Imenom polja u fields, kao JSON niz, i vremenskim opsegom u UTC za dnevne metrike koje nose audience_activity. start_date i end_date sežu unazad do 60 dana, a bez njih TikTok vraća 7 dana zaključno sa danom pre zahteva:
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?
Svako raščlanjivanje je lista objekata koji spajaju grupu sa njenim procentom, a svaki dan u metrics nosi svoj datum i listu audience_activity sa satima. Vrednosti ispod su TikTokovi sopstveni primeri, skraćeni na listu polova i nekoliko sati:
{
"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 nalozi dobijaju koja raščlanjivanja?
Udeli po uzrastu, polu, zemlji i gradu stižu kada nalog ima najmanje 100 pratilaca; TikTokov sopstveni primer za nalog sa 13 pratilaca vraća te liste prazne. audience_activity takođe traži 100 pratilaca, a uz to i nalog sa Advanced Access, koji se dobija povezivanjem sa TikTok za poslovanje nalogom ili nepotvrđenim Business Center-om, ili verifikovanim poslovnim nalogom. Svako od tih polja zahteva opseg user.insights na tokenu.
Koliko su demografski podaci sveži?
Dan ili dva kasnije. TikTok navodi audience_countries, audience_genders i audience_activity među poljima koja obično kasne 24 do 48 sati, u UTC, i daje isto vreme ažuriranja za uzraste i gradove. Podaci dolaze iz TikTok Analytics, koji vlasnik uključuje u aplikaciji nakon objavljivanja prvog videa, a podaci iz perioda pre toga nisu dostupni. TikTok demografiju zasniva na više faktora, uključujući ono što korisnici upišu u svoje profile.
Čime se demografija pratilaca razlikuje od gledalaca videa?
Opisuju različite ljude. Liste naloga opisuju pratioce. /business/video/list/ vraća raščlanjivanja osoba koje su pogledale jednu objavu: audience_genders, audience_countries i audience_cities, do 10 stavki svaka, i audience_types, koji gledaoce deli na nove i vraćajuće, pratioce i nepratioce. Ona zahtevaju opseg video.insights umesto user.insights.
Kako ih easyCoexistence čita?
Pomoću get_social_insights na nalogu: izostavite object_id, navedite nazive polja kao metrics, i prosledite start_date i end_date u params kada želite audience_activity za određene dane. Vraća liste TikToka onakve kakve jesu, pa se udeli i sati čitaju tačno kao gore.
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" }
}Česte greške
- Očekivanje raščlanjivanja za mali nalog. TikTok vraća udele po uzrastu, polu, zemlji i gradu od 100 pratilaca, a njegov primer za nalog sa 13 pratilaca pokazuje prazne liste.
- Čitanje sati iz audience_activity kao lokalnog vremena. TikTok ih prijavljuje u UTC+0, pa ih pomerite na vremensku zonu publike pre planiranja objava.
- Tretiranje demografije pratilaca kao demografije gledalaca. Liste naloga opisuju pratioce; audience_countries videa opisuje ljude koji su ga pogledali.
- Očekivanje audience_activity na ličnom nalogu. TikTok ga vraća za naloge sa Advanced Access ili verifikovanim poslovnim nalozima koji imaju najmanje 100 pratilaca.
Od US$ 9 do US$ 0.75 po vezi mesečno, uz pad kako dodajete veze, a prva 3 dana su besplatna.
Često postavljana pitanja
Može li TikTok API da prikaže uzrast i pol mojih pratilaca?
Da. GET /business/get/ vraća audience_ages i audience_genders, udele pratilaca po grupi, kada nalog ima najmanje 100 pratilaca, a token ima opseg user.insights.
Koje starosne grupe koristi TikTok API?
18-24, 25-34, 35-44, 45-54 i 55+, svaka sa udelom pratilaca u njoj.
Da li TikTok API kaže kada su moji pratioci na mreži?
audience_activity daje pratioce aktivne na TikToku po satu, u UTC+0, unutar metrika svakog dana, za Advanced Access ili verifikovane poslovne naloge sa 100 pratilaca ili više.
Kako TikTok API daje zemlje pratilaca?
Kao ISO 3166-1 alpha-2 kodove zemlje ili regiona u audience_countries, svaki sa udelom pratilaca iz nje.
Nastavite sa čitanjem
Povežite prvi kanal za dva minuta.
Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo zvanični API-ji
- Nadzor 24/7
Provereno na