x/
list-followers

Scopri chi segue le liste pubbliche di X: invia l’URL di una lista e ottieni bio, località, flag di verifica, data di iscrizione e numero di follower, seguiti e post di ogni follower.

Twitter List Followers API

Input con URL della lista
Follower della lista
Fino a 2.000 per lista
0,7 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

Twitter List Followers

I follower di una lista di Twitter, oggi X, sono gli account che la seguono per leggere i tweet dei suoi membri, e ognuno ha un profilo pubblico con bio, località, verifica, data di iscrizione e numero di follower, seguiti e post. Seguire una lista è una scelta precisa per restare aggiornati sul suo tema, quindi questi profili mostrano chi viene attirato da una nicchia, ti permettono di confrontare i lettori di liste affini e indicano le persone da contattare su quell’argomento.

Funzionalità della Twitter List Followers API

  • I follower di qualsiasi lista pubblicaInvia link x.com/i/lists/<id> e ottieni gli account che hanno scelto di seguire la timeline di ogni lista, fino a 2.000 per lista.
  • Chi è ogni followerOgni riga contiene username, nome visualizzato, la bio in text, avatar, immagine di copertina, sito web e location.name, che insieme mostrano che tipo di persone attira una lista.
  • Pubblico, attività, anzianità e verificametrics.followers_count, following_count e posts_count, published_at come data di iscrizione e is_verified aiutano a distinguere i follower affermati e attivi dagli account nuovi o poco attivi.

Parametri della Twitter List Followers API

ParametriObbligatorioDescrizione
urlsObbligatorioUno o più URL di liste pubbliche di X, ciascuno nel formato https://x.com/i/lists/<numeric id>. I follower vengono raccolti per ogni lista inclusa.
results_limitFacoltativoFollower da raccogliere per lista: un multiplo di 20 tra 20 e 2.000, con 100 come valore predefinito.

Come usare la Twitter List Followers API

Avvia un’attività con uno o più URL di liste, poi scorri pagina per pagina gli account che seguono ciascuna lista.

  1. Invia {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} con POST a /v1/x/list-followers e conserva il task_id.
  2. Chiama GET /v1/tasks/{task_id} a intervalli regolari finché status non diventa succeeded.
  3. Raccogli i follower da results.items, passando results.next_cursor nella chiamata successiva finché has_more è true.
curl -X POST "https://api.socq.ai/v1/x/list-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'

# Every item is an account that follows the list; the list's members come from /v1/x/list-members.

Casi d’uso della Twitter List Followers API

  • Vedere chi segue la tua lista: Raccogli i follower di una lista pubblica che curi per sapere chi la legge e quali lettori hanno il pubblico più ampio secondo followers_count.
  • Tracciare il profilo del pubblico di un tema: Leggi le bio e location.name delle persone che seguono una lista sulle climate tech o sui fondatori SaaS per descrivere chi si interessa a quell’argomento.
  • Selezionare le persone da contattare: Filtra i follower per parole chiave in text e per followers_count per scegliere gli account che già leggono contenuti sul tuo settore.
  • Confrontare i lettori di liste concorrenti: Raccogli in un’unica attività i follower di due liste sullo stesso argomento e abbinali tramite id per trovare i lettori in comune e quelli esclusivi di ciascuna lista.
  • Creare la base per un pubblico simile: Esporta i nomi utente e gli id dei follower di una lista ben curata come insieme di partenza per il targeting lookalike o per interessi nei tuoi strumenti pubblicitari.

Consigli degli esperti per la Twitter List Followers API

  • Abbina tramite id i follower con i membri della lista ottenuti da Twitter List Members API per trovare i membri che seguono anche la lista e i lettori che ne restano fuori.
  • Usa lo stesso results_limit per ogni lista che confronti, così ogni pubblico viene raccolto alla stessa profondità.
  • Salva gli id dei follower di ogni esecuzione; un’esportazione successiva della stessa lista mostra così chi ha iniziato a seguirla nel frattempo.

Oltre alla Twitter List Followers 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 Followers List API — Raccoglie identità degli account follower pubblici e metriche visibili dei profili per uno o più nomi utente X.
  • 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 List Tweets API — Legge la timeline di una lista a partire dal post più recente, con i repost segnalati e i rispettivi autori originali.
  • Twitter List Members API — Esporta gli account di una lista come profili completi con bio, località e contatori.

Esplora altre piattaforme

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

Twitter List Followers API — FAQ

Twitter List Followers API è un’interfaccia programmatica per raccogliere gli account che seguono le liste pubbliche di X, cioè che vi sono iscritti, usando l’URL di ogni lista. Restituisce nome utente, nome, bio, località, sito web, flag di verifica e di account privato, data di iscrizione e numero di follower, seguiti e post di ogni follower.

Sì, per le liste pubbliche. Invia l’URL della lista e ogni follower torna come riga di profilo, fino a 2.000 per lista.

I follower si sono iscritti a una lista per leggerne la timeline; i membri sono gli account che il proprietario della lista ha aggiunto. Questa API restituisce i follower, mentre Twitter List Members API restituisce i membri.

No. Restituisce gli iscritti a una lista. Per gli account che seguono un profilo utente, usa X Followers List API.

Le liste piccole hanno spesso pochi iscritti e il risultato contiene esattamente gli account che seguono la lista. Ogni follower restituito costa 0,7 crediti e un risultato vuoto non costa nulla.