x/
followers-list

Collectez les comptes abonnés publics d’un ou plusieurs noms d’utilisateur X, avec identités normalisées, métriques de profil visibles, tâches asynchrones et récupération par curseur.

X Followers List API

Comptes abonnés
Métriques de profil
Collecte par lot
0,5 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

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ètresObligatoireDescription
usernamesObligatoireListe 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_limitFacultatifNombre 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.

  1. Préparez un ou plusieurs noms d’utilisateur X publics ; le @ initial est facultatif.
  2. Envoyez usernames et un results_limit valide en POST à /v1/x/followers-list, puis conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche atteigne succeeded ou failed.
  4. 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 true

Cas 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.

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.

Explorer d’autres plateformes

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

X Followers List API — FAQ

X Followers List API est une interface programmatique qui collecte les enregistrements de comptes publics des personnes abonnées à un ou plusieurs noms d’utilisateur X envoyés.

Transmettez un tableau usernames non vide. Chaque valeur peut comporter ou non un @ initial ; les espaces autour sont supprimés et les identifiants en double écartés sans tenir compte de la casse avant la collecte auprès du fournisseur.

La valeur s’applique séparément à chaque nom d’utilisateur, vaut 200 par défaut et doit être un multiple de 200 compris entre 200 et 2 000. C’est un plafond : la disponibilité publique et la pagination peuvent donc produire moins de résultats.

Le sérialiseur actuel de la tâche renvoie l’ID du compte, l’URL de profil canonique, l’ID de l’auteur, le nom d’utilisateur et le nom, les métriques de profil visibles, la date de création du compte normalisée lorsqu’elle est disponible, ainsi que la date de création de l’enregistrement sauvegardé.

Les lignes répétées du fournisseur sont dédoublonnées par ID de compte, et un même compte n’est sauvegardé qu’une fois pour l’ensemble de la tâche, même s’il suit plusieurs noms d’utilisateur envoyés.

Chaque résultat sauvegardé de façon unique coûte 0,5 crédit SocQ. La tâche est préfacturée à hauteur de results_limit multiplié par le nombre de noms d’utilisateur envoyés, puis les crédits inutilisés sont remboursés après un règlement réussi ; un résultat vide coûte zéro crédit.