x/
followers-list

Raccogli gli account follower pubblici di uno o più nomi utente di X, con identità normalizzate, metriche visibili del profilo, attività asincrone e recupero a cursore.

X Followers List API

Account follower
Metriche del profilo
Raccolta in batch
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

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

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

  1. Prepara uno o più nomi utente pubblici di X; la @ iniziale è facoltativa.
  2. Invia con POST usernames e un results_limit valido a /v1/x/followers-list, poi conserva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività raggiunge succeeded o failed.
  4. 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 true

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

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.

Esplora altre piattaforme

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

X Followers List API — FAQ

X Followers List API è un’interfaccia programmatica per raccogliere i record di account pubblici delle persone che seguono uno o più nomi utente di X inviati.

Passa un array usernames non vuoto. Ogni valore può includere o omettere una @ iniziale; gli spazi circostanti vengono rimossi e gli handle duplicati vengono eliminati senza distinguere maiuscole e minuscole prima della raccolta dal provider.

Il valore si applica separatamente a ogni nome utente, ha come predefinito 200 e deve essere un multiplo di 200 tra 200 e 2.000. È un tetto, quindi la disponibilità pubblica e la paginazione possono produrre meno risultati.

Il serializzatore attuale dell’attività restituisce l’ID dell’account, l’URL canonico del profilo, l’ID dell’autore, nome utente e nome, le metriche visibili del profilo, l’ora normalizzata di creazione dell’account quando disponibile e l’ora di creazione del record salvato.

Le righe ripetute del provider vengono deduplicate per ID dell’account e lo stesso account viene salvato una sola volta in tutta l’attività, anche se segue più di un nome utente inviato.

Ogni risultato salvato in modo univoco costa 0,5 crediti SocQ. L’attività viene prepagata in base a results_limit moltiplicato per il numero di nomi utente inviati, poi i crediti non utilizzati vengono rimborsati dopo la chiusura riuscita; un risultato vuoto costa zero crediti.