tiktok/
user-audience

Scopri in quali paesi vivono i follower di un account TikTok pubblico partendo solo dal nome utente, con nome di ogni paese, codice ISO, quota del pubblico e numero di follower campionati.

TikTok Audience Demographics API

Nome utente come input
Paesi dei follower
Quota per paese
20 crediti per richiesta
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

TikTok Audience Demographics

I paesi del pubblico di un account TikTok mostrano dove vivono i suoi follower, come quota di ogni paese su un campione di follower insieme al numero di follower campionati che sta dietro quella quota. Le analisi native di TikTok riservano questa vista al proprietario dell’account, quindi una ricerca per nome utente è il modo in cui brand, agenzie e analisti verificano un creator che non gestiscono.

Funzionalità della TikTok Audience Demographics API

  • Qualsiasi nome utente pubblico, senza accessoInvia un nome utente pubblico, con o senza @, e ottieni la distribuzione geografica dei suoi follower senza accedere all’account e senza una sessione TikTok.
  • Nome, codice ISO, quota e conteggioOgni voce di audience_countries riporta il nome del paese, un country_code di due lettere, una quota da 0 a 1 e il numero di follower campionati che la sostengono.
  • Prima il mercato più grandeI paesi arrivano ordinati per quota, quindi le prime righe dicono dove si trova la maggior parte del pubblico e la coda mostra i mercati minori.

Parametri della TikTok Audience Demographics API

ParametriObbligatorioDescrizione
usernameObbligatorioIl nome utente TikTok da analizzare, con o senza la @ iniziale.

Come usare la TikTok Audience Demographics API

Invia un nome utente, interroga l’attività e leggi un unico record del pubblico.

  1. Invia con POST {"username": "khaby.lame"} a /v1/tiktok/user-audience.
  2. Interroga GET /v1/tasks/{task_id} ogni pochi secondi finché status è succeeded.
  3. Leggi l’unico record in results.items e scorri audience_countries.
curl -X POST "https://api.socq.ai/v1/tiktok/user-audience" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"khaby.lame"}'

# The result has one record; audience_countries[].share is a fraction from 0 to 1.

Casi d’uso della TikTok Audience Demographics API

  • Ingaggiare un creator per un solo mercato: Prima di pagare una campagna rivolta a un singolo paese, leggi la quota che quel paese occupa tra i follower del creator; un grande seguito che vive altrove non raggiungerà i tuoi acquirenti.
  • Verificare se una spinta sul targeting geografico funziona: Quando cerchi di far crescere il pubblico in un nuovo paese, esegui lo stesso nome utente a intervalli regolari e confronta la quota di quel paese tra i diversi timestamp collected_at.
  • Escludere i mercati che non puoi servire: Negozi e app che vendono in un elenco fisso di paesi possono sommare la quota di quei valori country_code ed escludere i creator i cui follower vivono per lo più altrove.

Consigli degli esperti per la TikTok Audience Demographics API

  • Dividi count per share per vedere quanto è grande il campione di follower; quando è piccolo, considera alla pari i paesi con quote vicine invece di metterli in classifica.
  • Raggruppa i valori country_code in regioni tue, come EU o LATAM, prima di confrontare i creator, perché di solito le campagne puntano a una regione e non a un solo paese.

Oltre alla TikTok Audience Demographics API, usa queste API quando ti serve un altro tipo di dati pubblici di TikTok.

  • TikTok Profiles API — Recupera identità del profilo pubblico, bio, flag dell’account e conteggi del pubblico a partire dal nome utente.
  • TikTok Followers List API — Raccoglie i profili normalizzati visibili negli elenchi pubblici dei follower, con contesto della fonte conservato e metriche supportate.
  • TikTok Following List API — Raccoglie i profili pubblici seguiti dagli account TikTok con identità normalizzata, bio, metriche visibili e contesto dell’account di origine.
  • TikTok User Videos API — Raccoglie i video pubblici del feed di un profilo a partire dal nome utente con didascalie, creator, media, date, engagement e contesto dell’account di origine.
  • TikTok Similar Accounts API — Trova gli account che TikTok consiglia come simili a un nome utente, con numero di follower e bio.
  • TikTok Live Ranking API — Ottiene la classifica giornaliera dei creator LIVE con posizioni, punteggi basati sui regali e numero di follower.

Esplora altre piattaforme

Combina i dati di TikTok con i dati pubblici delle altre piattaforme social supportate.

TikTok Audience Demographics API — FAQ

TikTok Audience Demographics API è un’interfaccia programmatica per recuperare, a partire dal nome utente, i paesi in cui si trovano i follower di un account TikTok pubblico. Restituisce un record che elenca per ogni paese nome, codice ISO, quota del pubblico e numero di follower campionati.

Sì, per qualsiasi account pubblico. TikTok mostra la posizione dei follower solo al proprietario dell’account, mentre questa ricerca richiede soltanto il nome utente.

No. Il record riguarda solo il paese dei follower, senza suddivisione per età, genere o città.

Sì, invia il tuo nome utente e leggi i paesi come dati invece di aprire TikTok Analytics, una soluzione adatta ai report su più account che gestisci.

Ogni quota deriva da un campione dei follower dell’account e count indica quanti follower campionati la sostengono. Un paese con un count basso è un segnale approssimativo, non un dato preciso.

Per richiesta. Un nome utente costa una tariffa fissa di 20 crediti indipendentemente da quanti paesi vengono restituiti, e con un nome utente inesistente l’attività non riesce e i crediti vengono restituiti.