x/
list-members

Esporta gli account delle liste pubbliche di X dai loro URL, con nome utente, bio, località, sito web, verifica e numero di follower, seguiti e post di ogni membro.

Twitter List Members API

Input con URL della lista
Account scelti dal proprietario
Profili completi dei membri
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 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

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

  1. 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.
  2. Controlla GET /v1/tasks/{task_id} a intervalli di pochi secondi finché lo stato non diventa succeeded.
  3. 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.

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.

Esplora altre piattaforme

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

Twitter List Members API — FAQ

Twitter List Members API è un’interfaccia programmatica per esportare gli account che fanno parte delle liste pubbliche di X, usando l’URL di ogni lista. Restituisce per ogni membro un profilo con nome utente, nome, bio, località, sito web, flag di verifica e di account privato, data di iscrizione e numero di follower, seguiti e post.

Copia l’URL della lista da x.com, invialo in urls con un valore di results_limit e leggi i profili dei membri dall’attività completata, seguendo next_cursor finché has_more è true. Ogni membro è un record JSON che puoi scrivere in un foglio di calcolo o in un CRM.

Sì. Qualsiasi lista pubblica può essere esportata dal suo URL, chiunque l’abbia creata.

Fino a 2.000 per lista, impostati con results_limit a passi di 20; il valore predefinito è 100. Quando invii più liste, il limite vale per ciascuna.

Ogni membro restituito costa 0,7 crediti, quindi una lista di 100 membri costa 70 crediti. Un risultato vuoto non costa nulla.