tiktok/
following-list

Raccogli i profili TikTok pubblici seguiti da uno o più nomi utente, con identità, bio, avatar, metriche visibili e contesto dell’account di origine come record normalizzati.

TikTok Following List API

Relazioni di seguiti
Record dei profili
Limiti per utente
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 Following List

Gli elenchi dei seguiti di TikTok contengono i profili pubblici che un account segue in modo visibile, con ID utente, nomi utente, nomi visualizzati, biografie, avatar, link ai profili e metriche visibili dell’account. Questi record di relazioni e profili supportano la ricerca sulle reti di interessi, la scoperta di creator, la mappatura delle relazioni pubbliche e l’arricchimento dei dataset di profili.

Funzionalità della TikTok Following List API

  • Relazioni dall’origine ai profiliRaccogli i record dei profili seguiti per ogni nome utente pubblico inviato e conserva l’handle di origine in extra.input_username.
  • Identità normalizzata dei profili seguitiRestituisce un ID utente stabile, nome utente, nome visualizzato e URL canonico del profilo TikTok per ogni membro della relazione salvato.
  • Contesto del profilo pubblicoInclude il testo della biografia, un riferimento all’avatar e le metriche visibili dell’account esposte con il profilo seguito.
  • Raccolta limitata per utenteApplica results_limit separatamente a ogni nome utente mentre scorre i dati disponibili dell’elenco e deduplica i profili salvati in base all’identità stabile.

Parametri della TikTok Following List API

ParametriObbligatorioDescrizione
usernamesObbligatorioElenco obbligatorio di nomi utente TikTok pubblici non vuoti. Una @ iniziale viene accettata e rimossa prima della raccolta.
results_limitFacoltativoNumero massimo di record di profili seguiti richiesti per ogni nome utente. Il valore predefinito è 100 e accetta numeri interi da 20 a 2.000.

Come usare la TikTok Following List API

Invia handle di origine pubblici, poi leggi i record normalizzati dei profili seguiti dall’attività asincrona completata.

  1. Prepara uno o più nomi utente TikTok pubblici, con o senza @ iniziale, e scegli un results_limit da 20 a 2.000 per ciascun nome utente.
  2. Invia con POST usernames e results_limit a /v1/tiktok/following-list, poi salva il task_id restituito.
  3. Interroga GET /v1/tasks/{task_id} finché l’attività è in coda, in esecuzione o in nuovo tentativo, e fermati quando va a buon fine o fallisce.
  4. Dopo il successo leggi data.results.items; quando has_more è true, richiedi la stessa attività con next_cursor per caricare la pagina successiva dei risultati salvati.
curl -X POST "https://api.socq.ai/v1/tiktok/following-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 pass next_cursor while data.results.has_more is true

Casi d’uso della TikTok Following List API

  • Ricerca sulle reti di interessi: Usa il contesto dell’account di origine con ID, nomi utente e biografie dei profili seguiti per esaminare gli interessi pubblici intorno a un account noto.
  • Scoperta di creator a partire da account di partenza: Esamina nomi visualizzati, biografie, avatar, link ai profili e metriche visibili per costruire un elenco di profili candidati dai seguiti pubblici di un account.
  • Arricchimento di dataset di profili: Aggiungi ID stabili, URL canonici, biografie pubbliche, avatar e metriche visibili dell’account ai record di profili basati sul nome utente.

Consigli degli esperti per la TikTok Following List API

  • Rimuovi la @ iniziale e deduplica i nomi utente prima dell’invio, così handle equivalenti non generano lavoro duplicato sugli account di origine.
  • Imposta results_limit per ogni nome utente in base alla profondità che ti serve; elenchi di input più grandi possono produrre fino a usernames × results_limit record, prima della fine degli elenchi e della deduplicazione.
  • Usa id come chiave principale del profilo, ripiega su url quando manca e conserva extra.input_username per la tracciabilità dell’origine.
  • Considera risultati vuoti o brevi come un esito legato alla visibilità pubblica, poi controlla la privacy dell’account e la disponibilità dell’elenco prima di riprovare.
  • Non interpretare l’ordine restituito come attualità o forza della relazione, a meno che i tuoi dati a valle non forniscano esplicitamente quel segnale.

Oltre alla TikTok Following 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 Followers List API — Raccoglie i profili normalizzati visibili negli elenchi pubblici dei follower, con contesto della fonte conservato e metriche supportate.
  • 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 Following List API — FAQ

TikTok Following List API è un’interfaccia programmatica per raccogliere i profili pubblici seguiti da uno o più nomi utente TikTok. Restituisce identità normalizzata del profilo, biografia, avatar, metriche visibili, URL canonico e contesto dell’account di origine.

Invia uno o più handle non vuoti nell’array usernames. I valori possono includere o omettere una @ iniziale, che viene rimossa prima della raccolta.

Un record normalizzato può contenere ID dell’utente seguito, nome utente, nome visualizzato, URL canonico del profilo, biografia pubblica, avatar, metriche visibili del profilo, momento di raccolta ed extra.input_username.

results_limit ha come valore predefinito 100, accetta numeri interi da 20 a 2.000 e si applica separatamente a ciascun nome utente. Il totale salvato può essere inferiore quando un elenco visibile termina o i profili con identità duplicata vengono rimossi.

Privacy dell’account, restrizioni della piattaforma, pagine dell’elenco non disponibili o la fine dell’elenco pubblico delle relazioni possono ridurre i record restituiti. Controlla la visibilità pubblica dell’account di origine prima di riprovare.

No. Considera l’ordine restituito solo come ordine di raccolta, a meno che una fonte separata fornisca esplicitamente una semantica di affinità o di attualità.

Ogni record di profilo normalizzato salvato costa 0,5 crediti. La fatturazione usa il numero effettivo di record salvati, quindi un’attività vuota non comporta alcun addebito per risultato.