x/
list-followers

Découvrez qui suit des listes X publiques : envoyez l’URL d’une liste et obtenez pour chaque abonné sa bio, sa localisation, son indicateur de vérification, sa date d’inscription et ses nombres d’abonnés, d’abonnements et de posts.

Twitter List Followers API

URL de liste en entrée
Abonnés de la liste
Jusqu’à 2 000 par liste
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 Followers

Les abonnés d’une liste Twitter sont les comptes qui se sont abonnés à une liste X pour lire les tweets de ses membres, et chacun dispose d’un profil public avec bio, localisation, vérification, date d’inscription et nombres d’abonnés, d’abonnements et de posts. Suivre une liste, c’est choisir de se tenir au courant de son sujet : ces profils montrent donc qui une niche attire, permettent de comparer les lecteurs de listes voisines et désignent les personnes à approcher sur ce thème.

Fonctionnalités de la Twitter List Followers API

  • Les abonnés de toute liste publiqueEnvoyez des liens x.com/i/lists/<id> et obtenez les comptes qui ont choisi de suivre la timeline de chaque liste, jusqu’à 2 000 par liste.
  • Qui est chaque abonnéChaque ligne contient username, le nom affiché, la bio dans text, l’avatar, l’image de couverture, le site web et location.name, qui montrent ensemble quel type de personnes une liste attire.
  • Audience, activité, ancienneté et vérificationmetrics.followers_count, following_count et posts_count, published_at comme date d’inscription et is_verified aident à distinguer les abonnés établis et actifs des comptes récents ou peu actifs.

Paramètres de la Twitter List Followers API

ParamètresObligatoireDescription
urlsObligatoireUne ou plusieurs URL de listes X publiques, chacune au format https://x.com/i/lists/<numeric id>. Les abonnés sont collectés pour chaque liste incluse.
results_limitFacultatifNombre d’abonnés à collecter par liste : un multiple de 20 compris entre 20 et 2 000, 100 par défaut.

Comment utiliser la Twitter List Followers API

Lancez une tâche avec une ou plusieurs URL de listes, puis parcourez page par page les comptes qui suivent chaque liste.

  1. Envoyez {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} en POST à /v1/x/list-followers et conservez le task_id.
  2. Appelez GET /v1/tasks/{task_id} à intervalles réguliers jusqu’à ce que status passe à succeeded.
  3. Récupérez les abonnés dans results.items en transmettant results.next_cursor à l’appel suivant tant que has_more vaut 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.

Cas d’usage de la Twitter List Followers API

  • Voir qui suit votre propre liste : Collectez les abonnés d’une liste publique que vous gérez pour savoir qui la lit et quels lecteurs ont la plus grande audience selon followers_count.
  • Dresser le profil de l’audience d’un sujet : Lisez les bios et location.name des personnes qui suivent une liste consacrée à la climate tech ou aux fondateurs SaaS pour décrire qui s’intéresse à ce sujet.
  • Présélectionner des personnes à contacter : Filtrez les abonnés par mots-clés dans text et par followers_count pour retenir des comptes qui lisent déjà sur votre domaine.
  • Comparer les lecteurs de listes concurrentes : Collectez dans une même tâche les abonnés de deux listes sur le même sujet et rapprochez-les par id pour trouver les lecteurs communs et ceux propres à chaque liste.
  • Amorcer une audience similaire : Exportez les noms d’utilisateur et les id des abonnés d’une liste bien choisie comme ensemble de départ pour un ciblage lookalike ou par centres d’intérêt dans vos outils publicitaires.

Conseils d’expert pour la Twitter List Followers API

  • Rapprochez par id les abonnés et les membres de la liste obtenus avec Twitter List Members API pour trouver les membres qui suivent aussi la liste et les lecteurs qui n’en font pas partie.
  • Utilisez le même results_limit pour toutes les listes que vous comparez, afin que chaque audience soit collectée à la même profondeur.
  • Stockez les id des abonnés de chaque collecte ; un export ultérieur de la même liste montre alors qui a commencé à la suivre entre-temps.

En complément de la Twitter List Followers 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 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.
  • Twitter List Members API — Exportez les comptes d’une liste sous forme de profils complets avec bio, localisation et compteurs.

Explorer d’autres plateformes

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

Twitter List Followers API — FAQ

Twitter List Followers API est une interface programmatique qui collecte les comptes qui suivent des listes X publiques, autrement dit leurs abonnés, à partir de l’URL x.com/i/lists de chaque liste ; elle renvoie pour chaque abonné son nom d’utilisateur, son nom, sa bio, sa localisation, son site web, ses indicateurs de vérification et de confidentialité, sa date d’inscription et ses nombres d’abonnés, d’abonnements et de posts.

Oui, pour les listes publiques. Envoyez l’URL de la liste et chaque abonné revient sous forme de ligne de profil, jusqu’à 2 000 par liste.

Les abonnés se sont abonnés à une liste pour lire sa timeline ; les membres sont les comptes que le propriétaire de la liste a ajoutés. Cet endpoint renvoie les abonnés, et Twitter List Members API renvoie les membres.

Non. Il renvoie les abonnés d’une liste. Pour les comptes qui suivent un profil d’utilisateur, utilisez X Followers List API.

Les petites listes n’ont souvent que quelques abonnés, et le résultat contient exactement les comptes qui suivent la liste. Chaque abonné renvoyé coûte 0,7 crédit, et un résultat vide ne coûte rien.