TikTok-yleisön demografiset tiedot API:n kautta
TikTokin API for Business palauttaa TikTok-tilin seuraajien demografiset tiedot endpointista GET /business/get/: audience_ages, audience_genders, audience_countries ja audience_cities. Jokainen on lista seuraajien osuuksista, ja tiedot saa tileille, joilla on vähintään 100 seuraajaa. Seuraajien tuntikohtainen aktiivisuus tulee kentässä audience_activity kunkin päivän metriikoissa. Se on saatavilla tileille, joilla on Advanced Access tai Verified Business Account ja vähintään 100 seuraajaa. Kaikki vaativat user.insights-käyttöoikeuden.
easyCoexistence lukee TikTok-tilin seuraajien demografiset tiedot get_social_insights-työkalulla Claudesta, ChatGPT:stä tai omasta koodistasi.
Seuraajamäärä, joka tilillä on oltava, jotta TikTok palauttaa ikä-, sukupuoli-, maa- ja kaupunkijakaumat.
Ikäryhmät kentässä audience_ages: 18-24, 25-34, 35-44, 45-54 ja 55+.
Kentän audience_activity aikavyöhyke ja tuntikohtainen määrä TikTokissa aktiivisia seuraajia.
Tavallinen viive kentille audience_countries, audience_genders ja audience_activity, joita TikTok laskee jälkikäteen.
Mitä demografisia tietoja tilin endpoint palauttaa?
GET /business/get/ palauttaa ne, kun ne on nimetty parametrissa fields. Neljä jaottelua ovat datan yläosassa, yksi lista kutakin ulottuvuutta kohden, ja tuntikohtainen aktiivisuus on metriikoissa, yksi joukko päivää kohden:
audience_ages: seuraajien osuus kussakin ikäryhmässä, 18-24, 25-34, 35-44, 45-54 ja 55+.audience_genders: seuraajien osuus sukupuolittain: Female, Male tai Other.audience_countries: seuraajien osuus maittain tai alueittain ISO 3166-1 alpha-2 -koodina.audience_cities: seuraajien osuus kaupungeittain kentäncity_namemukaan.audience_activity: kullekin päivälle seuraajat, jotka ovat aktiivisia TikTokissa kunakin tuntina, tunnin (hour) ja määrän (count) mukaan.
Miten niitä pyydetään?
Kenttien nimillä parametrissa fields JSON-taulukkona sekä päivämäärävälillä UTC-ajassa niille päivittäisille metriikoille, jotka sisältävät audience_activity. start_date ja end_date ulottuvat enintään 60 päivää taaksepäin. Ilman niitä TikTok palauttaa 7 päivää, päättyen pyyntöä edeltävään päivään:
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'Miltä vastaus näyttää?
Jokainen jaottelu on lista objekteja, jotka yhdistävät ryhmän ja sen prosenttiosuuden. Jokainen päivä metriikoissa sisältää päivämääränsä ja audience_activity-listan tunneista. Alla olevat arvot ovat TikTokin omia esimerkkejä, lyhennettynä sukupuolilistaan ja muutamaan tuntiin:
{
"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 }
]
}
]
}
}Mitkä tilit saavat mitkä jaottelut?
Ikä-, sukupuoli-, maa- ja kaupunkiosuudet tulevat, kun tilillä on vähintään 100 seuraajaa. TikTokin oma esimerkki 13 seuraajan tilistä palauttaa nämä listat tyhjinä. audience_activity vaatii myös 100 seuraajaa ja lisäksi Advanced Accessin, joka saadaan yhdistämällä tili TikTok for Business -tiliin tai vahvistamattomaan Business Centeriin, tai Verified Business Account -tilin. Jokainen näistä kentistä vaatii user.insights-käyttöoikeuden tokenilla.
Kuinka tuoreita demografiset tiedot ovat?
Päivän tai kahden jäljessä. TikTok listaa audience_countries, audience_genders ja audience_activity kenttiin, joiden viive on yleensä 24–48 tuntia UTC-ajassa, ja antaa saman päivitysajan iille ja kaupungeille. Luvut tulevat TikTok Analyticsista, jonka tilin omistaja kytkee päälle sovelluksessa ensimmäisen videon julkaisun jälkeen. Sitä ennen kerättyä dataa ei ole saatavilla. TikTok perustaa demografiset tiedot useisiin tekijöihin, muun muassa siihen, mitä käyttäjät ovat profiileihinsa kirjoittaneet.
Miten seuraajien demografia eroaa videon katselijoista?
Ne kuvaavat eri ihmisiä. Tilin listat koskevat seuraajia. /business/video/list/ palauttaa jaottelut ihmisistä, jotka katsoivat yhden julkaisun: audience_genders, audience_countries ja audience_cities, enintään 10 kohdetta kukin, sekä audience_types, joka jakaa katselijat uusiin ja palaaviin, seuraajiin ja ei-seuraajiin. Nämä vaativat video.insights-käyttöoikeuden user.insights-käyttöoikeuden sijaan.
Miten easyCoexistence lukee ne?
get_social_insights-työkalulla tilistä: jätä object_id pois, luettele kenttien nimet metriikoina ja anna start_date ja end_date params-kentässä, kun haluat audience_activity-tiedot tietyiltä päiviltä. Se palauttaa TikTokin listat sellaisinaan, joten osuudet ja tunnit luetaan täsmälleen kuten yllä.
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" }
}Yleiset virheet
- Odotetaan jaotteluja pienelle tilille. TikTok palauttaa ikä-, sukupuoli-, maa- ja kaupunkiosuudet 100 seuraajasta alkaen, ja sen esimerkki 13 seuraajan tilistä näyttää listat tyhjinä.
- Luetaan audience_activity-tunnit paikallisaikana. TikTok ilmoittaa ne UTC+0-ajassa, joten siirrä ne yleisön aikavyöhykkeelle ennen julkaisujen suunnittelua.
- Seuraajien demografian käsittely katselijoiden demografiana. Tilin listat kuvaavat seuraajia, ja videon audience_countries kuvaa ihmisiä, jotka katsoivat sitä.
- Odotetaan audience_activitya henkilökohtaisella tilillä. TikTok palauttaa sen tileille, joilla on Advanced Access tai Verified Business Account ja vähintään 100 seuraajaa.
Pyydä audience_ages, audience_genders, audience_countries, audience_cities tai audience_activity, ja se palauttaa TikTokin listat sellaisinaan. US$ 9:stä US$ 0.75:een yhteyttä kohden kuukaudessa, ja hinta laskee yhteyksien lisääntyessä. Ensimmäiset 3 päivää ovat ilmaisia.
Usein kysytyt kysymykset
Voiko TikTokin API näyttää seuraajieni iän ja sukupuolen?
Kyllä. /business/get/ palauttaa audience_ages- ja audience_genders-kentät, seuraajien osuudet ryhmittäin, kun tilillä on vähintään 100 seuraajaa ja tokenilla user.insights-käyttöoikeus.
Mitä ikäryhmiä TikTokin API käyttää?
18-24, 25-34, 35-44, 45-54 ja 55+, kussakin seuraajien osuus.
Kertooko TikTokin API, milloin seuraajani ovat verkossa?
audience_activity antaa tunneittain seuraajat, jotka ovat aktiivisia TikTokissa, UTC+0-ajassa kunkin päivän metriikoissa. Saatavilla Advanced Access -tileille tai Verified Business Account -tileille, joilla on vähintään 100 seuraajaa.
Miten TikTokin API ilmoittaa seuraajien maat?
ISO 3166-1 alpha-2 -maa- tai aluekoodeina kentässä audience_countries, kussakin osuus seuraajista sieltä.
Lue lisää
Yhdistä ensimmäinen kanavasi kahdessa minuutissa.
Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.
- 3 päivää ilmaiseksi
- Peruuta milloin tahansa
- Vain viralliset API:t
- Valvottu 24/7
Vahvistettu