Takwimu za hadhira ya TikTok kupitia API
API ya Biashara ya TikTok hurudisha takwimu za wafuasi wa akaunti kupitia GET /business/get/: audience_ages, audience_genders, audience_countries na audience_cities, kila moja ikiwa orodha ya asilimia za wafuasi, kwa akaunti zenye wafuasi 100 au zaidi. Shughuli ya wafuasi kwa saa hutolewa kama audience_activity ndani ya metrics ya kila siku, kwa akaunti zenye Advanced Access au Verified Business Accounts na wafuasi 100 pia. Vyote vinahitaji scope ya user.insights.
easyCoexistence husoma takwimu za wafuasi wa akaunti ya TikTok kwa get_social_insights kutoka Claude, ChatGPT au msimbo wako mwenyewe: omba audience_ages, audience_genders, audience_countries, audience_cities au audience_activity, nayo hurudisha orodha za TikTok kama zilivyo.
Idadi ya wafuasi ambayo akaunti inahitaji kabla TikTok haijarudisha takwimu za umri, jinsia, nchi na jiji.
Vikundi vya umri katika audience_ages: 18-24, 25-34, 35-44, 45-54 na 55+.
Eneo la saa la audience_activity, yaani idadi ya wafuasi walio hai kwenye TikTok kwa kila saa.
Muda wa kawaida wa ucheleweshaji wa audience_countries, audience_genders na audience_activity, ambazo TikTok huzikokotoa nje ya mtandao.
Ni takwimu zipi endpoint ya akaunti hurudisha?
GET /business/get/ hurudisha takwimu hizo zikitajwa kwenye fields. Mgawanyo wa nne uko juu kabisa ndani ya data, orodha moja kwa kila kipimo, na shughuli ya kila saa iko ndani ya metrics, seti moja kwa kila siku:
audience_ages: asilimia ya wafuasi katika kila kundi la umri, 18-24, 25-34, 35-44, 45-54 na 55+.audience_genders: asilimia ya wafuasi kwa jinsia: Female, Male au Other.audience_countries: asilimia ya wafuasi kwa kila nchi au eneo, kama msimbo wa ISO 3166-1 alpha-2.audience_cities: asilimia ya wafuasi kwa kila jiji, kwacity_name.audience_activity: kwa kila siku, wafuasi walio hai kwenye TikTok kwa kila saa, kama hour na count.
Unaziombaje?
Kwa majina ya sehemu katika fields, yaliyowekwa kama JSON array, na kipindi cha tarehe kwa UTC kwa metrics za kila siku zinazobeba audience_activity. start_date na end_date zinaweza kurudi nyuma hadi siku 60, na bila hizo TikTok hurudisha siku 7 hadi siku moja kabla ya ombi:
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'Jibu linaonekanaje?
Kila mgawanyo ni orodha ya vitu vinavyounganisha kikundi na asilimia yake, na kila siku kwenye metrics hubeba tarehe yake na orodha ya audience_activity ya saa. Thamani zilizo hapa chini ni mifano ya TikTok yenyewe, zimepunguzwa hadi orodha ya jinsia na saa chache:
{
"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 }
]
}
]
}
}Ni akaunti zipi hupata mgawanyo gani?
Asilimia za umri, jinsia, nchi na jiji hutolewa mara akaunti inapofikisha wafuasi 100 angalau; mfano wa TikTok wa akaunti yenye wafuasi 13 hurudisha orodha hizo tupu. audience_activity pia inahitaji wafuasi 100, na zaidi ya hapo akaunti yenye Advanced Access, ambayo hupatikana kwa kuiunganisha na akaunti ya TikTok for Business au Business Center isiyothibitishwa, au Verified Business Account. Kila sehemu hizi zinahitaji scope ya user.insights kwenye token.
Takwimu zinachelewa kwa muda gani?
Zinachelewa siku moja au mbili. TikTok inaorodhesha audience_countries, audience_genders na audience_activity miongoni mwa sehemu ambazo kwa kawaida huchelewa saa 24 hadi 48, kwa UTC, na inatoa muda uleule wa kusasisha kwa umri na miji. Takwimu zinatoka TikTok Analytics, ambayo mmiliki huiwasha kwenye programu baada ya kuchapisha video ya kwanza, na data ya kabla ya hapo haipatikani. TikTok inazitegemea takwimu za wasifu kwa mambo kadhaa, pamoja na kile watumiaji walichoweka kwenye wasifu wao.
Takwimu za wafuasi zinatofautianaje na watazamaji wa video?
Zinaelezea watu tofauti. Orodha za akaunti zinahusu wafuasi. /business/video/list/ hurudisha mgawanyo wa watu waliotazama chapisho moja: audience_genders, audience_countries na audience_cities, kila moja ikiwa na hadi maingizo 10, na audience_types, inayogawa watazamaji kuwa wapya na wanaorudi, wafuasi na wasio wafuasi. Hizo zinahitaji scope ya video.insights badala ya user.insights.
easyCoexistence inazisomaje?
Kwa get_social_insights kwenye akaunti: acha object_id, orodhesha majina ya sehemu kama metrics, na pitisha start_date na end_date kwenye params unapotaka audience_activity kwa siku mahususi. Inarudisha orodha za TikTok kama zilivyo, kwa hiyo asilimia na saa zinasomeka kama ilivyoelezwa hapo juu.
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" }
}Makosa ya kawaida
- Kutarajia mgawanyo kwa akaunti ndogo. TikTok hurudisha asilimia za umri, jinsia, nchi na jiji kuanzia wafuasi 100, na mfano wake wa akaunti yenye wafuasi 13 unaonyesha orodha tupu.
- Kusoma saa za audience_activity kama saa za eneo lako. TikTok huziripoti kwa UTC+0, kwa hiyo zibadilishe kwenda eneo la saa la hadhira kabla ya kupanga machapisho.
- Kuchukulia takwimu za wafuasi kama takwimu za watazamaji. Orodha za akaunti zinaelezea wafuasi; audience_countries ya video inaelezea watu waliotazama.
- Kutarajia audience_activity kwenye akaunti binafsi. TikTok huirudisha kwa akaunti zenye Advanced Access au Verified Business Accounts zenye wafuasi 100 angalau.
Kuanzia US$ 9 hadi US$ 0.75 kwa muunganisho kwa mwezi, inashuka unavyoongeza miunganisho, na kipindi cha majaribio bila malipo cha siku 3.
Maswali yanayoulizwa mara kwa mara
Je, API ya TikTok inaweza kuonyesha umri na jinsia ya wafuasi wangu?
Ndiyo. /business/get/ hurudisha audience_ages na audience_genders, asilimia za wafuasi kwa kila kundi, mara akaunti inapofikisha wafuasi 100 angalau na token ina user.insights.
API ya TikTok hutumia vikundi gani vya umri?
18-24, 25-34, 35-44, 45-54 na 55+, kila kimoja kikiwa na asilimia ya wafuasi walio ndani yake.
Je, API ya TikTok inasema wafuasi wangu wako mtandaoni lini?
audience_activity inatoa wafuasi walio hai kwenye TikTok kwa kila saa, kwa UTC+0, ndani ya metrics ya kila siku, kwa akaunti zenye Advanced Access au Verified Business Accounts na wafuasi 100 au zaidi.
API ya TikTok inatoa vipi nchi za wafuasi?
Kama msimbo wa nchi au eneo wa ISO 3166-1 alpha-2 kwenye audience_countries, kila moja ikiwa na asilimia ya wafuasi kutoka hapo.
Endelea kusoma
Unganisha chaneli yako ya kwanza ndani ya dakika mbili.
Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.
- Siku 3 bila malipo
- Ghairi wakati wowote
- API rasmi pekee
- Hufuatiliwa saa 24/7
Imethibitishwa kwenye