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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
usernames | Obbligatorio | Elenco 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.
- Normalizza le voci dell’elenco di creator come nasa e @nasa, poi deduplicale.
- Invia con POST l’array usernames a /v1/tiktok/profiles e salva il task_id restituito.
- Interroga /v1/tasks/{task_id}. queued e running sono normali stati intermedi.
- 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 trueCasi 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.
API correlate
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.
- TikTok Hashtags API
- TikTok Comments API
- TikTok Videos API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Live Room Info API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API