X API

Accès programmatique aux Publications, aux utilisateurs, aux Espaces de X et plus encore

X API vous donne un accès programmatique à la conversation publique d’X. Lisez des publications, publiez du contenu, gérez des utilisateurs et analysez les tendances — le tout via des endpoints REST modernes avec une tarification flexible à l’usage.

Premiers pas

Créez une App et effectuez votre première requête en quelques minutes.

Référence de l’API

Explorez tous les endpoints disponibles.

SDKs

Bibliothèques officielles Python et TypeScript.

---

​

Ce que vous pouvez développer

Publications

Recherchez, récupérez et publiez des publications. Accédez aux fils, aux fils de discussion et aux publications citées.

Utilisateurs

Recherchez des utilisateurs, gérez les abonnements, les blocages et les mises en sourdine.

Spaces

Trouvez des conversations audio en direct et leurs participants.

Messages privés

Envoyez et recevez des messages privés.

Listes

Créez et gérez des listes de comptes sélectionnées.

Tendances

Accédez aux sujets tendances en fonction de la localisation.

---

​

Tarification

La X API utilise une tarification à l’usage. Pas d’abonnements, pas de plafonds mensuels : payez uniquement ce que vous utilisez.

Mise à l’échelle flexible

Commencez modestement et grandissez. Les coûts évoluent en fonction de votre utilisation réelle.

Aucun engagement

Aucun contrat ni dépense minimale. Arrêtez quand vous le souhaitez.

Suivi en temps réel

Surveillez l’utilisation et les coûts en direct dans la Console de développement.

Basée sur des crédits

Achetez des crédits à l’avance. Ils sont débités à mesure que vous utilisez l’API.

---

​

Fonctionnalités clés

Accès aux données

​

Objets de données riches

Accédez à des données détaillées et structurées pour les publications, les utilisateurs, les médias et plus encore :

• Publications : texte complet, métriques, entités, annotations, fils de conversation
• Utilisateurs : profils, nombre d’abonnés, statut de vérification du compte
• Médias : images, vidéos, GIFs avec métadonnées
• Sondages : options et nombre de votes

Personnalisez les réponses avec les fields et les expansions pour obtenir exactement les données dont vous avez besoin.

Diffusion en temps réel

​

Flux filtré

Recevez les publications en temps réel, au moment où elles sont publiées. Définissez jusqu’à 1 000 règles de filtrage pour ne recevoir que les publications correspondantes.

# Ajouter une règle
curl -X POST "https://api.x.com/2/tweets/search/stream/rules" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"add": [{"value": "from:xdevelopers"}]}'

# Se connecter au flux
curl "https://api.x.com/2/tweets/search/stream" \
  -H "Authorization: Bearer $TOKEN"

En savoir plus sur le flux filtré →

Recherche et analyses

​

Recherche sur l’ensemble des archives

Recherchez dans l’intégralité de l’historique des publications publiques — depuis 2006. Créez des requêtes avec des opérateurs pour les utilisateurs, mots-clés, dates, et plus encore.

curl "https://api.x.com/2/tweets/search/all?query=AI%20lang:en" \
  -H "Authorization: Bearer $TOKEN"

​

Métriques

Accédez aux métriques d’engagement, notamment les impressions, mentions « J’aime », republications, réponses et vues vidéo.

En savoir plus sur la recherche →

---

​

Versions de l’API

Version	Statut	Description
v2	Active	Endpoints modernes, tarification flexible et toutes les nouvelles fonctionnalités
Enterprise	Disponible	Accès à haut volume avec assistance dédiée

Utilisez X API v2 pour tous les nouveaux projets. C’est là que sont publiées toutes les nouvelles fonctionnalités et améliorations.

---

​

Démarrage rapide

1. Créer un compte développeur

   Inscrivez-vous sur console.x.com et créez une App.

2. Obtenir vos identifiants

   Générez votre Jeton Bearer pour les requêtes en mode app-only.

3. Envoyer une requête

   Essayez de rechercher un utilisateur :

   curl "https://api.x.com/2/users/by/username/xdevelopers" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   

---

​

Outils et bibliothèques

SDK Python

Bibliothèque Python officielle avec prise en charge asynchrone.

SDK TypeScript

Bibliothèque TypeScript/JavaScript officielle.

Postman

Explorateur d’API interactif.

Parcourir toutes les bibliothèques →

---

​

Assistance

Forum des développeurs

Obtenez de l’aide auprès de la communauté et de l’équipe X.

Centre d'assistance

FAQ et guides de dépannage.