X Following List
Gli elenchi dei seguiti di X sono relazioni pubblicamente visibili tra account, che mostrano quali profili segue un account di origine, con identità, biografie, link, immagini, stato dell’account, contatori e dettagli di creazione. Questi record supportano la ricerca sulle reti di interessi, la scoperta di account, la mappatura delle relazioni e l’arricchimento dei dataset di profili.
Funzionalità della X Following List API
- Raccolta dei seguiti di più accountAccetta uno o più nomi utente pubblici di X e applica una raccolta separata e con limite dell’elenco dei seguiti a ogni account di origine.
- Identità e contesto del profiloRestituisce ID, nomi utente, nomi visualizzati, URL canonici, biografie, siti web, posizioni, avatar, banner e orari di creazione degli account seguiti.
- Segnali dell’account e contatori pubbliciCombina i segnali visibili di verifica, protezione, messaggistica, post in evidenza e automazione con i conteggi di follower, seguiti, post, media e Mi piace.
- Record normalizzati con riferimento alla fonteMantiene ogni profilo salvato in una struttura pubblica coerente con collected_at ed extra.input_username per la tracciabilità della fonte.
Parametri della X Following List API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
usernames | Obbligatorio | Array obbligatorio di nomi utente pubblici di X non vuoti. I valori possono includere o omettere la @ iniziale. |
results_limit | Facoltativo | Numero massimo di profili seguiti richiesti per nome utente. Il valore predefinito è 200 e sono accettati multipli di 200 da 200 a 2.000. |
Come usare la X Following List API
Invia i nomi utente pubblici di origine, poi leggi i record normalizzati dei profili seguiti dall’attività asincrona completata.
- Prepara uno o più nomi utente pubblici di X, con o senza @ iniziale, e scegli un results_limit per nome utente che sia un multiplo di 200 da 200 a 2.000.
- Invia con POST usernames e results_limit a /v1/x/following-list, poi conserva il task_id restituito.
- Interroga GET /v1/tasks/{task_id} mentre l’attività è queued, running o retrying e fermati quando riesce o fallisce.
- Dopo il successo, leggi data.results.items e continua a richiedere l’attività con next_cursor finché data.results.has_more è true.
curl -X POST "https://api.socq.ai/v1/x/following-list" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["@X"],"results_limit":200}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass next_cursor while data.results.has_more is trueCasi d’uso della X Following List API
- Ricerca sulle reti di interessi: Collega ogni nome utente di origine conservato con identità, biografie, link e posizioni dei profili seguiti per esaminare gli interessi pubblici intorno ad account noti.
- Scoperta di account a partire da profili seed: Usa nomi, biografie, immagini, segnali di verifica e contatori visibili per rivedere gli account candidati trovati nell’elenco pubblico dei seguiti di un profilo di origine.
- Arricchimento degli elenchi di relazioni: Aggiungi ID stabili, URL canonici dei profili, metadati pubblici degli account, contatori e orari di raccolta ai record di relazioni esistenti basati sui nomi utente.
Consigli degli esperti per la X Following List API
- Rimuovi le @ iniziali e deduplica i nomi utente di origine senza distinguere maiuscole e minuscole prima dell’invio, così handle equivalenti non ripetono il lavoro sull’account di origine.
- Dimensiona results_limit per nome utente a passi di 200; con più origini, pianifica fino a usernames × results_limit record prima della fine degli elenchi e della deduplicazione a livello di attività.
- Quando costruisci un grafo molti-a-molti, non presumere una riga salvata per ogni coppia profilo di origine e profilo seguito, perché un profilo seguito ripetuto può essere deduplicato e conservare un solo valore extra.input_username.
- Considera un elenco vuoto o breve come un risultato legato alla visibilità pubblica e lascia che immagini, segnali di stato e contatori facoltativi restino nullable nei record a valle.
- Non interpretare l’ordine restituito come anzianità della relazione, intensità dell’interazione o approvazione, perché la risposta espone l’ordine di raccolta e non quei segnali.
API correlate
Oltre alla X Following List API, usa queste API quando ti serve un altro tipo di dati pubblici di X.
- Twitter Profile Scraper API — Recupera identità dell’account pubblico, bio, avatar, immagini di copertina, stato dell’account e statistiche visibili del pubblico a partire dal nome utente.
- Twitter User Tweets Scraper API — Raccoglie i post pubblici recenti, autori, media, hashtag, menzioni ed engagement a partire dal nome utente, escludendo le risposte.
- X Followers List API — Raccoglie identità degli account follower pubblici e metriche visibili dei profili per uno o più nomi utente X.
- X Post Retweeters API — Raccoglie un insieme unico, a livello di attività, di profili pubblici normalizzati degli account che hanno fatto repost di URL di stato X o Twitter noti.
- X Community API — Leggi i link delle community per descrizioni, numero di membri, regole e criteri di ingresso.
- X Account Location API — Consulta il paese in cui si trova un account, il modo in cui si connette a X, la data di iscrizione e i cambi del nome utente.
- Twitter Tweet Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API