Twitter List Members
I membri di una lista di Twitter sono gli account che il proprietario della lista su X ha scelto e aggiunto a mano, e ognuno ha un profilo pubblico con nome, bio, località, sito web, verifica, data di iscrizione e numero di follower, seguiti e post. Dato che qualcuno del settore ha già fatto la selezione, questi profili formano una rosa pronta per la ricerca di clienti, l’analisi degli influencer e l’arricchimento degli account, mentre istantanee ripetute registrano come cambia un gruppo curato.
Funzionalità della Twitter List Members API
- Gli account scelti dal proprietario a partire dall’URL della listaOgni URL x.com/i/lists/<id> che invii restituisce gli account che il proprietario ha inserito nella lista, fino a 2.000 per lista, e trasforma un gruppo curato a mano in righe da ordinare e filtrare.
- Un profilo completo per ogni membroLe righe contengono username, nome visualizzato, la bio in text, immagini dell’avatar e della copertina, sito web e location.name, quanto basta per capire già dalla riga se un account fa al caso tuo.
- Pubblico, attività e anzianità dell’accountmetrics.followers_count, following_count e posts_count mostrano il pubblico e la produzione di ogni membro, mentre published_at indica la data in cui l’account si è iscritto a X.
- Flag di verifica e privacyis_verified e is_private contrassegnano i membri verificati e gli account protetti, così puoi gestire ciascun gruppo per conto suo.
Parametri della Twitter List Members API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | URL di liste pubbliche di X che terminano con /i/lists/<numeric id>, per esempio https://x.com/i/lists/1940592907737845989. I membri di ogni lista vengono restituiti separatamente. |
results_limit | Facoltativo | Numero massimo di membri da esportare da ogni lista, a passi di 20 da 20 a 2.000. Il valore predefinito è 100. |
Come usare la Twitter List Members API
Invia gli URL delle liste da esportare e raccogli i profili dei membri quando l’attività è terminata.
- Copia l’URL di ogni lista da x.com e invia con POST {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} a /v1/x/list-members.
- Controlla GET /v1/tasks/{task_id} a intervalli di pochi secondi finché lo stato non diventa succeeded.
- Salva i profili dei membri in results.items; finché has_more è true, richiedi la pagina successiva con results.next_cursor.
curl -X POST "https://api.socq.ai/v1/x/list-members" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'
# Each member's bio is in text and the date the account joined X is in published_at.Casi d’uso della Twitter List Members API
- Trasformare una lista curata in una rosa di potenziali clienti: Esporta una lista, per esempio di fondatori fintech o di ricercatori di AI, e tieni i membri la cui bio in text e il cui sito web corrispondono alla tua offerta prima di contattarli.
- Classificare e suddividere in fasce gli account di una nicchia: Ordina i membri per metrics.followers_count e dividili per is_verified o location.name per separare le voci più forti e i gruppi regionali.
- Arricchire i record del CRM e dei lead: Aggiungi username, sito web, location.name e bio alle schede dei contatti, abbinandoli tramite l’id dell’account di ogni membro.
- Registrare come cambia una lista: Esporta la stessa lista a intervalli programmati e confronta gli id dei membri tra un’esecuzione e l’altra per vedere chi è stato aggiunto o rimosso.
Consigli degli esperti per la Twitter List Members API
- Abbina i membri tra un’esportazione e l’altra tramite id, perché i nomi utente possono cambiare.
- Leggi location.name per sapere dove un membro dice di trovarsi; città, regione e Paese possono essere null anche quando un luogo è indicato, quindi analizza tu location.name prima di raggruppare per Paese.
- Imposta results_limit sul primo multiplo di 20 superiore al numero di membri della lista per esportarla tutta in un’unica attività; vengono addebitati solo i membri restituiti.
- Invia lo stesso URL della lista a X List Tweets API per leggere cosa pubblicano questi membri e a Twitter List Followers API per vedere chi legge la lista.
API correlate
Oltre alla Twitter List Members 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 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.
- 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 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 Verified Followers 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