Dati demografici dei follower TikTok tramite l'API
L'API for Business di TikTok restituisce i dati demografici dei follower di un account da GET /business/get/: audience_ages, audience_genders, audience_countries e audience_cities, ciascuno una lista di quote dei follower, per gli account con almeno 100 follower. L'attività oraria dei follower arriva come audience_activity nelle metriche di ogni giorno, per gli account con Advanced Access o Verified Business Accounts e gli stessi 100 follower. Tutti richiedono lo scope user.insights.
easyCoexistence legge i dati demografici dei follower di un account TikTok con get_social_insights da Claude, ChatGPT o dal tuo codice: chiedi audience_ages, audience_genders, audience_countries, audience_cities o audience_activity e restituisce le liste di TikTok così come sono.
Follower che un account deve avere prima che TikTok restituisca le suddivisioni per età, genere, paese e città.
Fasce d'età in audience_ages: 18-24, 25-34, 35-44, 45-54 e 55+.
Fuso orario di audience_activity, il conteggio orario dei follower attivi su TikTok.
Ritardo abituale per audience_countries, audience_genders e audience_activity, che TikTok calcola offline.
Quali dati demografici restituisce l'endpoint dell'account?
GET /business/get/ li restituisce quando vengono indicati in fields. Le quattro suddivisioni si trovano in cima a data, una lista per dimensione, mentre l'attività oraria è in metrics, un insieme per ogni giorno:
audience_ages: la quota di follower in ciascuna fascia d'età, 18-24, 25-34, 35-44, 45-54 e 55+.audience_genders: la quota di follower per genere: Female, Male o Other.audience_countries: la quota di follower per paese o regione, come codice ISO 3166-1 alpha-2.audience_cities: la quota di follower per città, tramitecity_name.audience_activity: per ogni giorno, i follower attivi su TikTok in ciascuna ora, come hour e count.
Come si richiedono?
Con i nomi dei campi in fields, un array JSON, e un intervallo di date in UTC per le metriche giornaliere che contengono audience_activity. start_date ed end_date risalgono fino a 60 giorni indietro e, se omessi, TikTok restituisce i 7 giorni fino al giorno precedente alla richiesta:
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'Com'è fatta la risposta?
Ogni suddivisione è una lista di oggetti che abbina un gruppo alla sua percentuale, e ogni giorno in metrics riporta la data e una lista audience_activity di ore. I valori seguenti sono esempi di TikTok stesso, ridotti alla lista dei generi e a poche 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 }
]
}
]
}
}Quali account ricevono quali suddivisioni?
Le quote per età, genere, paese e città arrivano una volta che l'account ha almeno 100 follower; l'esempio di TikTok per un account con 13 follower restituisce quelle liste vuote. Anche audience_activity richiede 100 follower e, in più, un account con Advanced Access, che si ottiene collegandolo a un account TikTok for Business o a un Business Center non verificato, oppure un Verified Business Account. Tutti questi campi richiedono lo scope user.insights sul token.
Quanto sono aggiornati i dati demografici?
Con uno o due giorni di ritardo. TikTok elenca audience_countries, audience_genders e audience_activity tra i campi che di solito hanno un ritardo di 24-48 ore, in UTC, e indica lo stesso tempo di aggiornamento per età e città. I dati provengono da TikTok Analytics, che il proprietario attiva nell'app dopo la pubblicazione di un primo video; i dati precedenti non sono disponibili. TikTok basa i dati demografici su più fattori, tra cui quello che gli utenti inseriscono nei loro profili.
In cosa differiscono i dati demografici dei follower da quelli degli spettatori di un video?
Descrivono persone diverse. Le liste dell'account riguardano i follower. /business/video/list/ restituisce le suddivisioni delle persone che hanno guardato un singolo post: audience_genders, audience_countries e audience_cities, fino a 10 voci ciascuna, e audience_types, che divide gli spettatori in nuovi e di ritorno, follower e non follower. Questi richiedono lo scope video.insights invece di user.insights.
Come li legge easyCoexistence?
Con get_social_insights sull'account: ometti object_id, elenca i nomi dei campi come metrics e passa start_date ed end_date in params quando vuoi audience_activity per giorni specifici. Restituisce le liste di TikTok così come sono, quindi quote e ore si leggono esattamente come sopra.
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" }
}Errori comuni
- Aspettarsi suddivisioni per un account piccolo. TikTok restituisce le quote per età, genere, paese e città da 100 follower in su, e il suo esempio per un account con 13 follower mostra le liste vuote.
- Leggere le ore di audience_activity come ora locale. TikTok le riporta in UTC+0, quindi spostale sul fuso orario del pubblico prima di pianificare i post.
- Trattare i dati demografici dei follower come quelli degli spettatori. Le liste dell'account descrivono i follower; audience_countries di un video descrive le persone che lo hanno guardato.
- Aspettarsi audience_activity su un account personale. TikTok lo restituisce per gli account con Advanced Access o Verified Business Account che hanno almeno 100 follower.
Da US$ 9 a US$ 0,75 per connessione al mese, con il prezzo che scende man mano che aggiungi connessioni, e i primi 3 giorni di prova gratuita.
Domande frequenti
Con l'API di TikTok posso vedere età e genere dei miei follower?
Sì. /business/get/ restituisce audience_ages e audience_genders, quote di follower per gruppo, una volta che l'account ha almeno 100 follower e il token ha user.insights.
Quali fasce d'età usa l'API di TikTok?
18-24, 25-34, 35-44, 45-54 e 55+, ciascuna con la quota di follower che vi rientra.
L'API di TikTok dice quando i miei follower sono online?
audience_activity fornisce i follower attivi su TikTok per ogni ora, in UTC+0, all'interno delle metriche di ogni giorno, per gli account con Advanced Access o Verified Business Account e 100 follower o più.
Come fa l'API di TikTok a indicare i paesi dei follower?
Come codici paese o regione ISO 3166-1 alpha-2 in audience_countries, ciascuno con la quota di follower provenienti da lì.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il