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ètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Une 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_limit | Facultatif | Nombre 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.
- Envoyez {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} en POST à /v1/x/list-followers et conservez le task_id.
- Appelez GET /v1/tasks/{task_id} à intervalles réguliers jusqu’à ce que status passe à succeeded.
- 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.
API associées
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.
- 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