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ètres | Obligatoire | Description |
|---|---|---|
usernames | Obligatoire | Noms d’utilisateur X dont vous voulez collecter les abonnés certifiés. Chaque compte est collecté séparément. |
results_limit | Facultatif | Nombre 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.
- Envoyez {"usernames": ["NASA"], "results_limit": 100} en POST à /v1/x/verified-followers.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- 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é.
API associées
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.
- 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 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