TikTok Followers List
Gli elenchi di follower TikTok visibili pubblicamente rivelano identità degli account, biografie, link ai profili e conteggi disponibili di pubblico o attività. Questi record supportano il campionamento del pubblico, la scoperta di creator, le code di arricchimento e la ricerca ricorrente su elenchi pubblici.
Funzionalità della TikTok Followers List API
- Raccolta da più accountRaccogli i follower di uno o più nomi utente pubblici, con results_limit applicato in modo indipendente a ciascun account inviato.
- Scansione limitata del feedScorre internamente le pagine di follower supportate fino al limite per account, a una pagina successiva non disponibile o al tetto di raccolta.
- Record di profilo normalizzatiRestituisce ID del follower, nome utente, nome visualizzato, biografia, riferimento all’avatar, URL del profilo e metriche pubbliche supportate in una struttura di profilo coerente.
- Contesto di origine conservatoMantiene in extra.input_username l’handle inviato e normalizzato per il record del follower conservato.
- Controllo dei duplicati a livello di attivitàElimina le identità di follower ripetute nell’intera attività in base all’ID normalizzato o all’URL del profilo, prima che i risultati vengano salvati e paginati.
Parametri della TikTok Followers List API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
usernames | Obbligatorio | Elenco obbligatorio e non vuoto di nomi utente TikTok pubblici. I valori possono includere o omettere una @ iniziale; ID numerici degli account, URL dei profili e valori di cursore non sono accettati. |
results_limit | Facoltativo | Numero intero facoltativo da 20 a 2.000, valore predefinito 100. Il limite si applica separatamente a ogni nome utente inviato ed è un tetto, non una garanzia di completezza. |
Come usare la TikTok Followers List API
Invia handle pubblici noti, attendi l’attività asincrona e scorri i record dei profili salvati.
- Rimuovi gli spazi superflui, togli le @ iniziali facoltative per la tua deduplicazione e scegli nomi utente TikTok pubblici.
- Invia con POST usernames e un results_limit per nome utente da 20 a 2.000 a /v1/tiktok/followers-list.
- Salva task_id e interroga /v1/tasks/{task_id}; queued, running e retrying sono normali stati intermedi.
- Dopo il successo leggi data.results.items e passa next_cursor allo stesso endpoint dell’attività finché has_more è true.
curl -X POST "https://api.socq.ai/v1/tiktok/followers-list" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["@loganpaul"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della TikTok Followers List API
- Campionamento del pubblico: Costruisci un campione limitato di profili di follower visibili pubblicamente per una revisione qualitativa del pubblico.
- Code di scoperta dei creator: Raccogli nomi utente e link ai profili dei follower che possono alimentare una revisione manuale o una successiva attività di arricchimento con TikTok Profiles.
- Ricerca ricorrente sugli elenchi: Salva campioni con timestamp dagli stessi account pubblici per osservare le variazioni delle identità disponibili a ogni raccolta.
- Input per directory di profili: Trasforma le voci degli elenchi pubblici di follower in campi coerenti di identità, biografia, avatar e metriche per directory interne.
Consigli degli esperti per la TikTok Followers List API
- Normalizza le maiuscole e rimuovi la @ iniziale prima della deduplicazione lato client; altrimenti @name e name possono generare ricerche equivalenti alla fonte.
- Considera results_limit come un tetto per nome utente: due nomi utente con il valore predefinito 100 producono una stima di 200 risultati, non 100.
- Conserva extra.input_username, ma non usare questo endpoint per un’analisi esatta dei follower in comune, perché la deduplicazione a livello di attività mantiene un solo contesto di origine per ogni identità di follower.
- Usa il nome utente del follower, non l’id numerico, quando passi un account restituito a un endpoint che accetta nomi utente TikTok.
- Non inviare next_cursor in una nuova richiesta di raccolta; serve solo a scorrere i risultati già salvati della stessa attività riuscita.
- Gestisci le metriche come nullable e created_at come null, perché le righe dei follower a monte non sempre espongono quei campi.
- Aspettati meno record per account privati, limitati, non disponibili o molto grandi e considera i riferimenti agli avatar come URL di origine che possono scadere.
API correlate
Oltre alla TikTok Followers List 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 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