AccediInizia la prova gratuita
easyCoexistence API ufficiali

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.

100

Follower che un account deve avere prima che TikTok restituisca le suddivisioni per età, genere, paese e città.

5 groups

Fasce d'età in audience_ages: 18-24, 25-34, 35-44, 45-54 e 55+.

UTC+0

Fuso orario di audience_activity, il conteggio orario dei follower attivi su TikTok.

24 to 48 h

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à, tramite city_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:

Follower demographics for a TikTok account
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:

Demographics in the /business/get/ response
{
  "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.

Follower demographics through MCP
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.
Farlo con EasyCoexistence

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