tiktok/
followers-list

Raccogli profili normalizzati dagli elenchi di follower TikTok visibili pubblicamente per uno o più nomi utente, con contesto di origine, link ai profili e metriche pubbliche disponibili.

TikTok Followers List API

Profili dei follower
Campionamento del pubblico
Ricerca su elenchi pubblici
0,5 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 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

ParametriObbligatorioDescrizione
usernamesObbligatorioElenco 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_limitFacoltativoNumero 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.

  1. Rimuovi gli spazi superflui, togli le @ iniziali facoltative per la tua deduplicazione e scegli nomi utente TikTok pubblici.
  2. Invia con POST usernames e un results_limit per nome utente da 20 a 2.000 a /v1/tiktok/followers-list.
  3. Salva task_id e interroga /v1/tasks/{task_id}; queued, running e retrying sono normali stati intermedi.
  4. 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 true

Casi 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.

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.

Esplora altre piattaforme

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

TikTok Followers List API — FAQ

TikTok Followers List API è un’interfaccia programmatica per raccogliere i profili dei follower visibili pubblicamente da uno o più nomi utente TikTok, restituendo identità normalizzata, biografia, link al profilo e metriche pubbliche disponibili.

Invia un array usernames non vuoto con handle pubblici, facoltativamente preceduti da @, più un results_limit facoltativo. ID numerici di destinazione, URL dei profili e cursori di raccolta non sono accettati.

È un numero intero da 20 a 2.000, ha come valore predefinito 100 e si applica in modo indipendente a ciascun nome utente. Pone un tetto alla raccolta richiesta senza garantire che esista quel numero di record pubblici.

Un record normalizzato contiene ID, nome utente, nome visualizzato, testo della biografia, riferimento all’avatar, URL del profilo, metriche pubbliche nullable, collected_at ed extra.input_username. created_at è attualmente null.

La paginazione del feed di TikTok è gestita internamente e non è un parametro di invio. Il next_cursor restituito dopo il successo carica solo un’altra pagina dei risultati salvati da /v1/tasks/{task_id}.

Non in modo affidabile. I risultati salvati vengono deduplicati nell’attività per ID del follower o URL del profilo, quindi un follower ripetuto viene conservato una sola volta con un solo input_username e non come insieme completo delle relazioni di origine.

Ogni risultato normalizzato salvato costa 0,5 crediti, senza costo base. La stima iniziale moltiplica results_limit per il numero di nomi utente inviati e i crediti prepagati non usati vengono rimborsati al termine dell’attività.