tiktok/
profiles

Recupera i profili TikTok pubblici per uno o più nomi utente, con identità normalizzata, biografie, avatar, flag dell’account e conteggi visibili del pubblico.

TikTok Profiles API

Record dei creator
Risoluzione dell’identità
Istantanee dei profili
0,6 crediti per risultato
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 Profiles

I profili TikTok sono pagine pubbliche di creator o account con identità, biografie, avatar, stato di verifica e privacy e totali visibili di follower, seguiti, video e Mi piace. Questi segnali del profilo supportano la scoperta di creator, il confronto tra pubblici, la ricerca di partnership e l’arricchimento delle directory.

Funzionalità della TikTok Profiles API

  • Ricerca di nomi utente in bloccoRisolvi uno o più nomi utente pubblici di creator in una sola richiesta.
  • Input di nomi utente normalizzatiNormalizza input come nasa e @nasa prima della raccolta dei profili.
  • Identità stabile del profiloCostruisci un indice di identità da ID dell’account, nome utente, nome visualizzato e URL del profilo.
  • Campi del profilo e del pubblicoRestituisce in un unico record biografia, avatar, stato di verifica e privacy, oltre ai conteggi di follower, seguiti, video e Mi piace totali.
  • Istantanee dei profili tracciabiliTraccia ogni arricchimento e ogni istantanea ricorrente tramite l’input inviato e collected_at.

Parametri della TikTok Profiles API

ParametriObbligatorioDescrizione
usernamesObbligatorioElenco obbligatorio di nomi utente TikTok pubblici. Ogni valore può includere o omettere una @ iniziale.

Come usare la TikTok Profiles API

Parti da un elenco di nomi utente di creator e produci record pronti per una directory o un CRM.

  1. Normalizza le voci dell’elenco di creator come nasa e @nasa, poi deduplicale.
  2. Invia con POST l’array usernames a /v1/tiktok/profiles e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id}. queued e running sono normali stati intermedi.
  4. Dopo il successo leggi data.results.items. Quando has_more è true, continua con next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["nasa","@tiktok"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casi d’uso della TikTok Profiles API

  • Arricchimento di directory di talenti: Trasforma gli elenchi di nomi utente in schede di creator con ID degli account, avatar, biografie, stato e metriche di dimensione.
  • Preparazione di partnership: Esamina identità del creator, presenza di pubblicazione e dimensione del pubblico prima del contatto.
  • Monitoraggio della crescita dei creator: Salva istantanee ricorrenti di follower, video e Mi piace totali per un gruppo coerente di creator.
  • Abbinamento delle identità tra dataset: Usa gli ID degli account per collegare i record dei creator ai relativi video e commenti.

Consigli degli esperti per la TikTok Profiles API

  • Usa id come chiave del creator e mantieni username per la ricerca e la visualizzazione.
  • Conserva l’input inviato, così ogni record dell’API si ricollega in modo chiaro all’elenco di talenti di origine.
  • Raccogli a intervalli fissi e abbina ogni istantanea delle metriche a collected_at.
  • Deduplica per nome utente dopo aver rimosso la @ iniziale.
  • Combina avatar, display_name, biography e profile_url in schede di creator utili.
  • Unisci i record di profili, video e commenti correlati tramite l’ID dell’account per una vista più completa del creator.

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

  • 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 Audience Demographics API — Mostra da quali paesi provengono i follower di un creator a partire dal nome utente, con la quota del pubblico di ogni paese.
  • 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 Profiles API — FAQ

TikTok Profiles API recupera i record dei profili visibili pubblicamente per uno o più nomi utente TikTok. Restituisce identità normalizzata, biografie, avatar, flag di verifica e privacy e conteggi di follower, seguiti, video e Mi piace.

Inserisci i nomi utente pubblici nell’array usernames. Sono accettati sia il formato exampleuser sia @exampleuser.

Sì. usernames accetta più valori, che vengono elaborati nella stessa attività asincrona e restituiti come record di profilo normalizzati.

I risultati includono ID dell’account, nome utente, nome visualizzato, URL del profilo, biografia pubblica e avatar, con stato dell’account, data di creazione e campi della regione, se presenti.

I risultati includono i conteggi pubblicamente visibili di follower, seguiti, video e Mi piace totali, osservati durante la raccolta.

Le metriche corrispondono al timestamp collected_at. Salvare risultati ricorrenti per gli stessi account crea una sequenza di istantanee pubbliche dei profili.

Usa l’ID dell’account e il nome utente normalizzato per unire i campi dei creator di Videos, Search e Hashtags con i campi degli autori di Comments.

Ogni risultato di profilo normalizzato restituito costa 0,6 crediti.