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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Uno 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_limit | Facoltativo | Follower 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.
- Invia {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} con POST a /v1/x/list-followers e conserva il task_id.
- Chiama GET /v1/tasks/{task_id} a intervalli regolari finché status non diventa succeeded.
- 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.
API correlate
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.
- 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 API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified 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