x/
verified-followers

Collectez les comptes certifiés qui suivent un profil X à partir de son nom d’utilisateur, avec l’identifiant, le nom, le lien de profil, la photo de profil et la date d’inscription de chaque abonné, jusqu’à 2 000 par compte.

X Verified Followers API

Onglet Abonnés certifiés
Jusqu’à 2 000 par compte
Date d’inscription des abonnés
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

X Verified Followers

Les abonnés certifiés d’un compte X forment la partie de son audience qui porte une coche de vérification ; ils figurent dans l’onglet « Abonnés certifiés » du profil, où chacun apparaît avec son identifiant, son nom affiché, sa photo de profil et sa date d’inscription sur X. Comme cette liste réunit des créateurs, des marques et des utilisateurs payants, elle montre quels comptes établis suivent déjà un profil et fournit un échantillon compact pour la prospection, l’analyse concurrentielle et le contrôle de la qualité d’une audience.

Fonctionnalités de la X Verified Followers API

  • Les abonnés de l’onglet Abonnés certifiésLes lignes proviennent de la liste que X affiche dans l’onglet « Abonnés certifiés » d’un profil : chaque abonné renvoyé a donc is_verified à true.
  • Les deux comptes nommés sur chaque ligneactor est le compte que vous avez demandé, related_actor est l’abonné certifié et relationship vaut follower, ce qui permet de distinguer dans un même jeu de résultats les lignes issues de plusieurs noms d’utilisateur.
  • Identité de l’abonné et lien vers son profilrelated_actor fournit l’id, le username, le nom affiché, l’url du profil et l’avatar_url de chaque abonné, de quoi ouvrir, examiner ou exporter le compte.
  • La date d’arrivée de chaque abonné sur XSur chaque ligne, published_at correspond à la date d’inscription du compte de l’abonné certifié, ce qui sépare les comptes anciens de ceux créés récemment.
  • De 20 à 2 000 abonnés par nom d’utilisateurresults_limit s’applique à chaque nom d’utilisateur par pas de 20, d’un échantillon rapide de 20 comptes jusqu’à 2 000 abonnés certifiés.

Paramètres de la X Verified Followers API

ParamètresObligatoireDescription
usernamesObligatoireNoms d’utilisateur X dont vous voulez collecter les abonnés certifiés. Chaque compte est collecté séparément.
results_limitFacultatifNombre d’abonnés certifiés à renvoyer pour chaque nom d’utilisateur, multiple de 20 compris entre 20 et 2 000. 100 par défaut.

Comment utiliser la X Verified Followers API

Envoyez des noms d’utilisateur, choisissez combien d’abonnés certifiés collecter pour chacun, puis parcourez les lignes page par page.

  1. Envoyez {"usernames": ["NASA"], "results_limit": 100} en POST à /v1/x/verified-followers.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. Lisez les abonnés certifiés dans results.items et renvoyez results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/x/verified-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["NASA"],"results_limit":100}'

# related_actor is the verified follower; actor is the account you asked about.

Cas d’usage de la X Verified Followers API

  • Constituer une liste de prospection à partir de l’audience certifiée d’un concurrent : Collectez les abonnés certifiés d’un concurrent et exportez related_actor.username et url pour contacter les créateurs, les marques et les abonnés payants qui suivent déjà votre secteur.
  • Repérer les comptes certifiés qui suivent uniquement un concurrent : Collectez dans une même tâche les abonnés certifiés de votre compte et ceux d’un concurrent, puis gardez les valeurs de related_actor.id présentes seulement dans la liste du concurrent.
  • Comparer les audiences certifiées de plusieurs profils : Envoyez un ensemble de noms d’utilisateur en une fois et comparez le nombre de lignes et les valeurs de related_actor.id communes pour voir quels profils attirent les mêmes comptes certifiés.
  • Détecter une vague d’abonnés certifiés récemment créés : Triez les abonnés certifiés d’un profil par published_at pour voir si son audience à coche s’appuie sur des comptes anciens ou sur des comptes arrivés récemment sur X.

Conseils d’expert pour la X Verified Followers API

  • Commencez avec results_limit à 20 pour confirmer qu’un profil a une audience certifiée qui vaut la peine d’être collectée, puis augmentez la valeur ; chaque abonné renvoyé coûte 0,7 crédit.
  • Quand un nom d’utilisateur renvoie exactement results_limit lignes, sa liste certifiée peut aller plus loin : augmentez la limite jusqu’à 2 000 pour une vue plus complète.
  • Identifiez les abonnés par related_actor.id et comparez les collectes grâce à collected_at pour voir quels comptes certifiés sont apparus depuis votre dernière vérification.
  • Lisez le compte demandé dans actor.username ; les autres champs de actor peuvent être vides, alors que related_actor contient le détail de l’abonné.

En complément de la X Verified 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 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.
  • 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 Verified Followers API — FAQ

X Verified Followers API est une interface programmatique qui collecte les abonnés à coche de comptes X à partir de leurs noms d’utilisateur, jusqu’à 2 000 par compte. Chaque ligne relie le compte demandé à un abonné certifié, avec l’id, le nom d’utilisateur, le nom, l’URL du profil, la photo de profil et la date d’inscription de cet abonné.

Sur X, ils figurent dans l’onglet « Abonnés certifiés » de la liste des abonnés d’un profil. Envoyez ici ce nom d’utilisateur pour recevoir la même liste sous forme de lignes que vous pouvez trier, filtrer et exporter.

Tout abonné qui porte une coche de vérification sur X, c’est-à-dire les comptes que X liste dans l’onglet « Abonnés certifiés ». Chaque abonné renvoyé a related_actor.is_verified à true.

Oui, en comptant les lignes renvoyées pour ce nom d’utilisateur. Réglez results_limit sur 2 000 pour la vue la plus large ; un compte dont la liste certifiée est plus longue renvoie 2 000 lignes, et ce nombre doit alors se lire comme un minimum.

Non. Les lignes contiennent l’id, le nom d’utilisateur, le nom, l’URL du profil, la photo de profil, l’indicateur de certification et la date d’inscription de l’abonné. Transmettez ces noms d’utilisateur à Twitter Profile Scraper API si vous avez besoin du nombre d’abonnés ou des bios.

Non. Ici, published_at est la date à laquelle l’abonné certifié s’est inscrit sur X ; la date de l’abonnement lui-même ne figure pas dans le résultat.