X Followers List
L’elenco dei follower di X è l’insieme dei record di account pubblici restituiti per le persone che seguono un nome utente inviato al momento della raccolta. Supporta la ricerca sul pubblico e l’arricchimento degli elenchi, restando soggetto alla disponibilità pubblica, alla paginazione del provider e alla deduplicazione a livello di attività.
Funzionalità della X Followers List API
- Raccolta dei follower di più accountInvia uno o più nomi utente pubblici di X in una sola attività, con o senza @ iniziale.
- Controlli dei risultati per nome utenteRichiedi da 200 a 2.000 record di follower per nome utente a passi di 200, con 200 come valore predefinito.
- Record normalizzati di account pubbliciRicevi ID degli account, URL canonici dei profili, identità dell’autore, contatori visibili del profilo e timestamp normalizzati tramite il risultato pubblico dell’attività.
- Opzioni di consegna asincronaInterroga i risultati dell’attività con un cursore opaco finché la raccolta termina, poi continua attraverso tutte le pagine di risultati disponibili.
Parametri della X Followers List API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
usernames | Obbligatorio | Elenco obbligatorio di nomi utente pubblici di X. I valori possono includere o omettere la @ iniziale; gli spazi vengono rimossi e i nomi utente duplicati vengono eliminati senza distinguere maiuscole e minuscole prima della raccolta. |
results_limit | Facoltativo | Numero massimo di risultati da raccogliere per ogni nome utente. Il valore predefinito è 200 e sono accettati multipli di 200 da 200 a 2.000. |
Come usare la X Followers List API
Avvia un’attività di raccolta dei follower, attendi il completamento, poi scorri i record degli account pubblici salvati.
- Prepara uno o più nomi utente pubblici di X; la @ iniziale è facoltativa.
- Invia con POST usernames e un results_limit valido a /v1/x/followers-list, poi conserva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività raggiunge succeeded o failed.
- Dopo il successo, leggi data.results.items e passa di nuovo next_cursor all’endpoint dell’attività finché has_more è true.
curl -X POST "https://api.socq.ai/v1/x/followers-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 follow next_cursor while has_more is trueCasi d’uso della X Followers List API
- Crea campioni per la ricerca sul pubblico: Raccogli gli account follower pubblici di profili X selezionati e analizza la scala visibile degli account nel campione restituito.
- Arricchisci le directory di account noti: Aggiungi URL canonici dei profili X, identità visualizzate, ID degli account e contatori visibili ai record di account a valle.
- Crea istantanee ripetibili dei follower: Esegui nel tempo la stessa raccolta con limite e conserva i timestamp delle attività per confrontare gli insiemi di account pubblici salvati.
Consigli degli esperti per la X Followers List API
- Deduplica i nomi utente prima dell’invio, perché la stima temporanea dei crediti usa la lunghezza dell’array inviato, mentre la raccolta normalizza gli handle duplicati.
- Considera results_limit un tetto per nome utente e non una promessa che ogni account restituisca il numero richiesto di record pubblici.
- Usa l’id di ogni risultato come chiave stabile; lo stesso follower incontrato con più nomi utente inviati viene salvato una sola volta all’interno di un’attività.
- Tieni separata la paginazione del provider dal recupero dei risultati: è pubblico solo il next_cursor opaco di /v1/tasks/{task_id}.
- Gestisci i risultati vuoti e parziali senza far fallire il flusso di lavoro, perché account non disponibili, restrizioni di accesso o una fonte esaurita possono accorciare una raccolta.
API correlate
Oltre alla X Followers 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.
- X Following List API — Raccoglie i profili seguiti dagli account X pubblici, inclusi identità, bio, segnali dell’account, contatori visibili e nomi utente di origine.
- 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 Verified Followers API — Raccoglie gli account verificati che seguono un profilo, con nome utente, nome, avatar e data di iscrizione.
- Twitter Follow Checker API — Verifica se un account ne segue altri e se questi lo seguono a loro volta.
- Twitter Tweet Scraper API
- Twitter User Tweets 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 Account Location 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 Video Transcript API