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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
usernames | Obbligatorio | Elenco obbligatorio di nomi utente TikTok pubblici non vuoti. Una @ iniziale viene accettata e rimossa prima della raccolta. |
results_limit | Facoltativo | Numero 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.
- 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.
- Invia con POST usernames e results_limit a /v1/tiktok/following-list, poi salva il task_id restituito.
- 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.
- 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 trueCasi 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.
API correlate
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.
- 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