X Followers List
Une liste d’abonnés X est l’ensemble des enregistrements de comptes publics renvoyés pour les personnes qui suivent un nom d’utilisateur envoyé, au moment de la collecte. Elle sert à étudier une audience et à enrichir des listes, sous réserve de la disponibilité publique, de la pagination du fournisseur et du dédoublonnage au niveau de la tâche.
Fonctionnalités de la X Followers List API
- Collecte d’abonnés pour plusieurs comptesEnvoyez un ou plusieurs noms d’utilisateur X publics dans une seule tâche, avec ou sans @ initial.
- Limite de résultats par nom d’utilisateurDemandez de 200 à 2 000 enregistrements d’abonnés par nom d’utilisateur, par pas de 200, la valeur par défaut étant 200.
- Comptes publics normalisésRecevez ID de comptes, URL de profil canoniques, identité de l’auteur, compteurs de profil visibles et horodatages normalisés dans le résultat public de la tâche.
- Récupération asynchrone des résultatsInterrogez les résultats de la tâche avec un curseur opaque jusqu’à la fin de la collecte, puis parcourez toutes les pages de résultats disponibles.
Paramètres de la X Followers List API
| Paramètres | Obligatoire | Description |
|---|---|---|
usernames | Obligatoire | Liste obligatoire de noms d’utilisateur X publics. Les valeurs peuvent comporter ou non un @ initial ; les espaces sont supprimés et les doublons écartés sans tenir compte de la casse avant la collecte. |
results_limit | Facultatif | Nombre maximal de résultats à collecter pour chaque nom d’utilisateur. Vaut 200 par défaut et accepte les multiples de 200 de 200 à 2 000. |
Comment utiliser la X Followers List API
Lancez une tâche de collecte d’abonnés, attendez sa fin, puis parcourez page par page les enregistrements de comptes publics sauvegardés.
- Préparez un ou plusieurs noms d’utilisateur X publics ; le @ initial est facultatif.
- Envoyez usernames et un results_limit valide en POST à /v1/x/followers-list, puis conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche atteigne succeeded ou failed.
- Après un succès, lisez data.results.items et renvoyez next_cursor à l’endpoint de tâche tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/x/followers-list" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["@X"],"results_limit":200}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage de la X Followers List API
- Constituer des échantillons pour l’étude d’audience : Collectez les comptes abonnés publics de profils X choisis et analysez l’ampleur visible des comptes sur l’échantillon renvoyé.
- Enrichir des annuaires de comptes connus : Ajoutez URL de profil X canoniques, identités affichées, ID de comptes et compteurs visibles aux fiches de comptes en aval.
- Produire des instantanés d’abonnés reproductibles : Relancez la même collecte bornée au fil du temps et conservez les horodatages des tâches pour comparer les ensembles de comptes publics sauvegardés.
Conseils d’expert pour la X Followers List API
- Dédoublonnez les noms d’utilisateur avant l’envoi : l’estimation provisoire de crédits se base sur la longueur du tableau envoyé, alors que la collecte normalise les identifiants en double.
- Voyez dans results_limit un plafond par nom d’utilisateur, et non la promesse que chaque compte renverra le nombre d’enregistrements publics demandé.
- Prenez l’id de chaque résultat comme clé stable ; un même abonné rencontré sous plusieurs noms d’utilisateur envoyés n’est sauvegardé qu’une fois dans une tâche.
- Séparez la pagination du fournisseur de la récupération des résultats : seul le next_cursor opaque de /v1/tasks/{task_id} est public.
- Gérez les résultats vides ou partiels sans faire échouer le workflow, car des comptes indisponibles, des restrictions d’accès ou une source épuisée peuvent raccourcir une collecte.
API associées
En complément de la X Followers List 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 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 Community API — Lisez des liens de communautés pour obtenir descriptions, nombres de membres, règles et conditions d’adhésion.
- X Verified Followers API — Collectez les comptes certifiés qui suivent un profil, avec leur nom d’utilisateur, leur nom affiché, leur photo de profil et leur date d’inscription.
- Twitter Follow Checker API — Vérifiez si un compte suit d’autres comptes et s’ils le suivent en retour.
- 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 Posts API
- X Thread Context API
- X Account Location API
- X List Tweets API
- Twitter List Members 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 Video Transcript API