x/
list-members

Exportez les comptes de listes X publiques à partir de leurs URL, avec pour chaque membre son nom d’utilisateur, sa bio, sa localisation, son site web, sa vérification et ses nombres d’abonnés, d’abonnements et de posts.

Twitter List Members API

URL de liste en entrée
Comptes ajoutés par le propriétaire
Profils complets des membres
0,7 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

Twitter List Members

Les membres d’une liste Twitter sont les comptes que le propriétaire d’une liste X a choisis et ajoutés à la main, et chacun dispose d’un profil public avec nom, bio, localisation, site web, vérification, date d’inscription et nombres d’abonnés, d’abonnements et de posts. Comme une personne du secteur a déjà fait la sélection, ces profils forment une présélection toute prête pour la prospection, la recherche d’influenceurs et l’enrichissement de comptes, et des instantanés répétés retracent l’évolution d’un groupe choisi.

Fonctionnalités de la Twitter List Members API

  • Les comptes choisis par le propriétaire à partir d’une URL de listeChaque URL x.com/i/lists/<id> envoyée renvoie les comptes que son propriétaire a placés dans la liste, jusqu’à 2 000 par liste : un groupe constitué à la main devient des lignes que vous pouvez trier et filtrer.
  • Un profil complet pour chaque membreLes lignes contiennent username, le nom affiché, la bio dans text, l’avatar et l’image de couverture, le site web et location.name, de quoi juger directement depuis la ligne si un compte correspond.
  • Audience, activité et ancienneté du comptemetrics.followers_count, following_count et posts_count montrent l’audience et la production de chaque membre, et published_at donne la date à laquelle le compte a rejoint X.
  • Indicateurs de vérification et de confidentialitéis_verified et is_private signalent les membres vérifiés et les comptes protégés, pour traiter chaque groupe séparément.

Paramètres de la Twitter List Members API

ParamètresObligatoireDescription
urlsObligatoireURL de listes X publiques se terminant par /i/lists/<numeric id>, par exemple https://x.com/i/lists/1940592907737845989. Les membres de chaque liste sont renvoyés séparément.
results_limitFacultatifNombre maximal de membres à exporter pour chaque liste, par pas de 20, de 20 à 2 000. 100 par défaut.

Comment utiliser la Twitter List Members API

Envoyez les URL des listes à exporter et récupérez les profils des membres une fois la tâche terminée.

  1. Copiez l’URL de chaque liste sur x.com et envoyez {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} en POST à /v1/x/list-members.
  2. Interrogez GET /v1/tasks/{task_id} toutes les quelques secondes jusqu’à ce que status indique succeeded.
  3. Enregistrez les profils des membres présents dans results.items ; tant que has_more vaut true, demandez la page suivante avec 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.

Cas d’usage de la Twitter List Members API

  • Transformer une liste choisie en présélection de prospects : Exportez une liste de fondateurs de fintech ou de chercheurs en IA, par exemple, puis gardez les membres dont la bio (text) et le site web correspondent à votre offre avant de les contacter.
  • Classer et hiérarchiser les comptes d’une niche : Triez les membres par metrics.followers_count et répartissez-les selon is_verified ou location.name pour isoler les voix les plus influentes et les groupes régionaux.
  • Enrichir les fiches CRM et les leads : Ajoutez username, website, location.name et la bio aux fiches de contact, en les rapprochant grâce à l’id du compte de chaque membre.
  • Retracer l’évolution d’une liste : Exportez la même liste à intervalles réguliers et comparez les id des membres d’une collecte à l’autre pour voir qui a été ajouté ou retiré.

Conseils d’expert pour la Twitter List Members API

  • Rapprochez les membres d’un export à l’autre par id, car les noms d’utilisateur peuvent changer.
  • Lisez location.name pour savoir où un membre dit se trouver ; city, region et country peuvent valoir null même lorsqu’un lieu est affiché, alors analysez vous-même location.name avant de regrouper par pays.
  • Réglez results_limit sur le multiple de 20 immédiatement supérieur au nombre de membres de la liste pour l’exporter entièrement en une tâche ; seuls les membres renvoyés sont facturés.
  • Envoyez la même URL de liste à X List Tweets API pour lire ce que publient ces membres, et à Twitter List Followers API pour voir qui suit la liste.

En complément de la Twitter List Members API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques X.

  • Twitter Profile Scraper API — Récupérez par nom d’utilisateur l’identité publique d’un compte, ses biographies, avatars, images de couverture, statut du compte et statistiques d’audience visibles.
  • X Followers List API — Collectez les identités des abonnés publics et les indicateurs de profil visibles pour un ou plusieurs noms d’utilisateur X.
  • X Following List API — Collectez les profils suivis par des comptes X publics, avec identité, biographies, signaux de compte, compteurs visibles et noms d’utilisateur sources.
  • X Post Retweeters API — Collectez, au niveau de la tâche, un ensemble unique de profils publics normalisés des comptes ayant reposté des URL de statuts X ou Twitter connues.
  • X Account Location API — Consultez le pays où un compte est basé, son mode de connexion à X, sa date d’inscription et ses changements de nom d’utilisateur.
  • X List Tweets API — Lisez la timeline d’une liste, du plus récent au plus ancien, avec les reposts signalés et leur auteur d’origine.

Explorer d’autres plateformes

Combinez les données X avec les données publiques d’autres plateformes sociales prises en charge.

Twitter List Members API — FAQ

Twitter List Members API est une interface programmatique qui exporte les comptes appartenant à des listes X publiques à partir de l’URL x.com/i/lists de chaque liste ; elle renvoie pour chaque membre un profil avec nom d’utilisateur, nom, bio, localisation, site web, indicateurs de vérification et de confidentialité, date d’inscription et nombres d’abonnés, d’abonnements et de posts.

Copiez l’URL de la liste sur x.com, envoyez-la dans urls avec un results_limit, puis lisez les profils des membres dans la tâche terminée en suivant next_cursor tant que has_more vaut true. Chaque membre est un enregistrement JSON que vous pouvez écrire dans un tableur ou un CRM.

Oui. Toute liste publique peut être exportée à partir de son URL, quelle que soit la personne qui l’a créée.

Jusqu’à 2 000 par liste, à régler avec results_limit par pas de 20 ; la valeur par défaut est 100. Si vous envoyez plusieurs listes, la limite s’applique à chacune.

Chaque membre renvoyé coûte 0,7 crédit : une liste de 100 membres coûte donc 70 crédits. Un résultat vide ne coûte rien.