X Account Location
Le panneau « À propos de ce compte » de X est une courte fiche associée à chaque profil : le pays ou la région où le compte est basé, la boutique d’applications, l’application ou le client web par lequel il se connecte, sa date d’inscription, le nombre de changements de son nom d’utilisateur et l’organisation à laquelle il est affilié. Croisés, ces éléments permettent de vérifier si un compte opère bien depuis l’endroit que suggèrent ses contenus, d’évaluer des créateurs avant un partenariat et de repérer des groupes de comptes qui partagent une origine inattendue.
Fonctionnalités de la X Account Location API
- Le pays que X indique pour chaque comptecountry reprend le pays où le compte est basé (« Account based in » dans l’interface anglaise), tel qu’il figure dans le panneau « À propos de ce compte » du profil, par exemple United States ou United Kingdom.
- La façon dont le compte accède à Xconnected_via nomme le canal que X associe au compte, par exemple United States App Store, Android App ou Web, à mettre en regard de country.
- Date d’inscription et historique de l’identifiantpublished_at contient la date à laquelle le compte a rejoint X et username_changes_count compte ses changements de nom : deux indices rapides pour juger si un identifiant est bien établi.
- Affiliation et vérification d’identitéaffiliate_username indique le badge d’organisation affiché sur le profil, comme X pour elonmusk ou BBCNews pour BBCWorld, à côté de is_identity_verified et de l’indicateur de coche bleue is_verified.
- Une ligne par nom d’utilisateur dans une seule tâcheEnvoyez une liste de noms d’utilisateur, avec ou sans @ initial : chaque compte revient sous forme de ligne distincte avec id, username, name, avatar_url et is_private en plus de ses informations de localisation.
Paramètres de la X Account Location API
| Paramètres | Obligatoire | Description |
|---|---|---|
usernames | Obligatoire | Noms d’utilisateur X à consulter, avec ou sans le @ initial. Chaque compte renvoie sa propre ligne. |
Comment utiliser la X Account Location API
Envoyez des noms d’utilisateur et lisez une ligne « À propos de ce compte » par compte.
- Envoyez {"usernames": ["elonmusk", "BBCWorld"]} en POST à /v1/x/user-about.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez une ligne par compte dans results.items et renvoyez results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/x/user-about" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["elonmusk","BBCWorld"]}'
# An account that shows no country on X still returns a row, with country set to null.Cas d’usage de la X Account Location API
- Vérifier d’où opèrent les comptes politiques et d’actualité : Passez en revue les comptes qui animent un sujet politique ou d’actualité et signalez ceux dont country ou connected_via renvoie à une autre région du monde que le public auquel ils s’adressent.
- Évaluer un créateur avant un partenariat rémunéré : Vérifiez que country correspond au marché que vous payez pour atteindre, et examinez published_at et username_changes_count pour repérer un identifiant créé récemment ou souvent renommé.
- Regrouper des comptes potentiellement coordonnés : Classez un ensemble de comptes suspects par country, connected_via et mois d’inscription pour faire apparaître des lots créés à la même période depuis le même endroit.
- Compter les pays derrière une conversation : Transmettez les noms d’utilisateur qui ont répondu à un post ou l’ont reposté, collectés avec d’autres endpoints X, puis comptez les valeurs de country pour voir de quelles régions vient la discussion.
Conseils d’expert pour la X Account Location API
- Avant de conclure qu’un compte est piloté depuis l’étranger, lisez country avec connected_via et published_at : un champ isolé peut induire en erreur.
- Stockez les comptes par id, puisque username_changes_count montre à quel point un identifiant peut changer souvent.
- Conservez collected_at avec chaque ligne et relancez plus tard les mêmes noms d’utilisateur pour détecter un changement de country, de connected_via ou de username_changes_count.
- Rapprochez les lignes renvoyées de votre liste d’entrée par username : si certains comptes manquent, les autres sont tout de même renvoyés et les comptes manquants n’ont simplement pas de ligne.
API associées
En complément de la X Account Location 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.
- Twitter User Tweets Scraper API — Collectez par nom d’utilisateur les posts publics récents, auteurs, médias, hashtags, mentions et l’engagement, hors réponses.
- 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 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 Tweet 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 Follow Checker API
- Twitter Video Transcript API