Demografia audienței TikTok prin API
API-ul TikTok for Business returnează demografia urmăritorilor unui cont TikTok din GET /business/get/: audience_ages, audience_genders, audience_countries și audience_cities, fiecare o listă cu ponderi ale urmăritorilor, pentru conturile cu cel puțin 100 de urmăritori. Activitatea orară a urmăritorilor vine ca audience_activity în metricile fiecărei zile, pentru conturile cu Advanced Access sau Verified Business Accounts și aceiași 100 de urmăritori. Toate necesită permisiunea user.insights.
easyCoexistence citește demografia urmăritorilor unui cont TikTok cu get_social_insights, din Claude, ChatGPT sau din propriul cod: cereți audience_ages, audience_genders, audience_countries, audience_cities sau audience_activity și primiți listele TikTok așa cum sunt.
Numărul de urmăritori necesar ca TikTok să returneze defalcările pe vârstă, gen, țară și oraș.
Grupele de vârstă din audience_ages: 18-24, 25-34, 35-44, 45-54 și 55+.
Fusul orar al audience_activity, adică numărul orar al urmăritorilor activi pe TikTok.
Întârzierea obișnuită pentru audience_countries, audience_genders și audience_activity, pe care TikTok le calculează offline.
Ce defalcări demografice returnează endpoint-ul contului?
GET /business/get/ le returnează atunci când sunt numite în fields. Cele patru defalcări stau în partea de sus a lui data, câte o listă pentru fiecare dimensiune, iar activitatea orară stă în metrics, câte un set pentru fiecare zi:
audience_ages: ponderea urmăritorilor din fiecare grupă de vârstă, 18-24, 25-34, 35-44, 45-54 și 55+.audience_genders: ponderea urmăritorilor după gen: Female, Male sau Other.audience_countries: ponderea urmăritorilor pe țară sau regiune, ca cod ISO 3166-1 alpha-2.audience_cities: ponderea urmăritorilor pe oraș, dupăcity_name.audience_activity: pentru fiecare zi, urmăritorii activi pe TikTok în fiecare oră, ca hour și count.
Cum le cereți?
Cu numele câmpurilor în fields, un array JSON, și un interval de date în UTC pentru metricile zilnice care conțin audience_activity. start_date și end_date pot merge până la 60 de zile în urmă; fără ele, TikTok returnează ultimele 7 zile până în ziua dinaintea cererii:
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'Cum arată răspunsul?
Fiecare defalcare este o listă de obiecte care asociază un grup cu procentajul său, iar fiecare zi din metrics conține data și o listă audience_activity de ore. Valorile de mai jos sunt exemplele proprii ale TikTok, reduse la lista de genuri și câteva ore:
{
"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 }
]
}
]
}
}Ce conturi primesc ce defalcări?
Ponderile pe vârstă, gen, țară și oraș apar odată ce contul are cel puțin 100 de urmăritori; exemplul TikTok pentru un cont cu 13 urmăritori returnează aceste liste goale. audience_activity cere și el 100 de urmăritori și, pe deasupra, un cont cu Advanced Access, obținut prin legarea la un cont TikTok for Business sau la un Business Center neverificat, ori un Verified Business Account. Fiecare dintre aceste câmpuri necesită permisiunea user.insights pe token.
Cât de proaspete sunt datele demografice?
Cu o întârziere de o zi sau două. TikTok include audience_countries, audience_genders și audience_activity printre câmpurile care rămân de obicei în urmă cu 24 până la 48 de ore, în UTC, și indică același timp de actualizare pentru vârste și orașe. Cifrele provin din TikTok Analytics, pe care proprietarul îl activează în aplicație după publicarea primului video; datele anterioare nu sunt disponibile. TikTok bazează demografia pe mai mulți factori, inclusiv ce își completează utilizatorii în profiluri.
Cum diferă demografia urmăritorilor de spectatorii unui video?
Descriu persoane diferite. Listele contului acoperă urmăritorii. /business/video/list/ returnează defalcări ale persoanelor care au urmărit o postare: audience_genders, audience_countries și audience_cities, cu până la 10 intrări fiecare, și audience_types, care împarte spectatorii în noi și reveniți, urmăritori și neurmăritori. Acestea necesită permisiunea video.insights în loc de user.insights.
Cum le citește easyCoexistence?
Cu get_social_insights pe cont: lăsați din afară object_id, treceți numele câmpurilor ca metrics și transmiteți start_date și end_date în params atunci când doriți audience_activity pentru anumite zile. Returnează listele TikTok așa cum sunt, astfel că ponderile și orele se citesc exact ca mai sus.
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" }
}Greșeli frecvente
- Așteptarea defalcărilor pentru un cont mic. TikTok returnează ponderile pe vârstă, gen, țară și oraș de la 100 de urmăritori, iar exemplul său pentru un cont cu 13 urmăritori arată listele goale.
- Citirea orelor din audience_activity ca oră locală. TikTok le raportează în UTC+0, deci mutați-le în fusul orar al audienței înainte de a planifica postările.
- Tratarea demografiei urmăritorilor ca demografie a spectatorilor. Listele contului descriu urmăritorii; audience_countries al unui video descrie persoanele care l-au urmărit.
- Așteptarea audience_activity pe un cont personal. TikTok îl returnează pentru conturi cu Advanced Access sau Verified Business Accounts care au cel puțin 100 de urmăritori.
De la US$ 9 până la US$ 0,75 per conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.
Întrebări frecvente
Poate API-ul TikTok să arate vârsta și genul urmăritorilor mei?
Da. /business/get/ returnează audience_ages și audience_genders, ponderi ale urmăritorilor pe grupă, odată ce contul are cel puțin 100 de urmăritori și token-ul are user.insights.
Ce grupe de vârstă folosește API-ul TikTok?
18-24, 25-34, 35-44, 45-54 și 55+, fiecare cu ponderea urmăritorilor din ea.
Spune API-ul TikTok când sunt online urmăritorii mei?
audience_activity oferă urmăritorii activi pe TikTok pe oră, în UTC+0, în metricile fiecărei zile, pentru conturile cu Advanced Access sau Verified Business Accounts și cu 100 de urmăritori sau mai mulți.
Cum oferă API-ul TikTok țările urmăritorilor?
Ca coduri ISO 3166-1 alpha-2 de țară sau regiune în audience_countries, fiecare cu ponderea urmăritorilor de acolo.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la