Effectuer votre première requête

Prenez en main la X API en quelques minutes

Ce guide vous accompagne pour effectuer votre première requête vers l’X API. Vous aurez besoin d’un compte développeur avec des identifiants d’App avant de commencer.

---

Démarrage rapide avec cURL

Le moyen le plus rapide de tester l’API est d’utiliser cURL. Recherchons un utilisateur :

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

Remplacez $BEARER_TOKEN par votre jeton Bearer réel. Vous recevrez une réponse de ce type :

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "xdevelopers"
  }
}

---

Guide étape par étape

1. Récupérer votre Jeton Bearer

   Dans la Console de développement, accédez à votre App et copiez le Jeton Bearer.

2. Choisir un endpoint

   Commencez avec l’un de ces endpoints simples pour débuter :

   Endpoint	Ce qu’il fait
   User lookup	Récupérer un profil utilisateur par nom d’utilisateur ou id
   Post lookup	Récupérer une Publication par id
   Recent search	Rechercher des Publications des 7 derniers jours

3. Effectuer la requête

   Utilisez cURL, Postman ou votre client HTTP préféré :

   # Rechercher un utilisateur par nom d’utilisateur
   curl "https://api.x.com/2/users/by/username/xdevelopers" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   
4. Analyser la réponse

   Les réponses sont au format JSON. Les données principales se trouvent dans le champ data :

   {
     "data": {
       "id": "2244994945",
       "name": "X Developers",
       "username": "xdevelopers"
     }
   }
   

---

Obtenir plus de données avec les champs

Par défaut, les endpoints renvoient un ensemble minimal de champs. Utilisez le paramètre de requête fields pour récupérer des données supplémentaires :

curl "https://api.x.com/2/users/by/username/xdevelopers?user.fields=created_at,description,public_metrics" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Réponse :

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "xdevelopers",
    "created_at": "2013-12-14T04:35:55.000Z",
    "description": "La voix de la plateforme X Developer",
    "public_metrics": {
      "followers_count": 570842,
      "following_count": 2048,
      "tweet_count": 14052,
      "listed_count": 1672
    }
  }
}

En savoir plus sur les champs →

---

Autres exemples

Consulter une publication

curl "https://api.x.com/2/tweets/1460323737035677698?tweet.fields=created_at,public_metrics" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Rechercher des publications récentes

curl "https://api.x.com/2/tweets/search/recent?query=from:xdevelopers&tweet.fields=created_at" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Obtenir les publications d’un utilisateur

curl "https://api.x.com/2/users/2244994945/tweets?max_results=5" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

Utiliser du code plutôt que cURL

Python

import requests

bearer_token = "YOUR_BEARER_TOKEN"
url = "https://api.x.com/2/users/by/username/xdevelopers"

headers = {"Authorization": f"Bearer {bearer_token}"}
response = requests.get(url, headers=headers)

print(response.json())

JavaScript

const bearerToken = "YOUR_BEARER_TOKEN";
const url = "https://api.x.com/2/users/by/username/xdevelopers";

fetch(url, {
  headers: { Authorization: `Bearer ${bearerToken}` }
})
  .then(res => res.json())
  .then(data => console.log(data));

SDK officiels

Pour un usage en production, nous recommandons d’utiliser les SDK officiels :

• SDK Python
• SDK TypeScript

Ils gèrent automatiquement l’authentification, la pagination et la limitation de débit.

---

Outils de test

Postman

Tests de l’API via une interface visuelle à l’aide de notre collection.

Exemples de code

Exemples dans plusieurs langages de programmation.

Référence de l’API

Documentation complète des endpoints.

---

Dépannage

401 Non autorisé

• Vérifiez que votre Jeton Bearer est correct
• Assurez-vous que le jeton n’a pas été régénéré
• Vérifiez le format de l’en-tête Authorization : Bearer YOUR_TOKEN

403 Interdit

• Votre app n’a peut-être pas accès à ce point de terminaison
• Certains points de terminaison nécessitent une authentification en contexte utilisateur (OAuth 1.0a ou 2.0)
• Vérifiez les autorisations de votre app dans la Console de développement

429 Trop de requêtes

• Vous avez atteint une limite de taux de requêtes
• Vérifiez l’en-tête x-rate-limit-reset pour savoir quand réessayer
• Mettez en place une stratégie de backoff exponentiel dans votre code

Référence complète des erreurs →

---

Prochaines étapes

Apprendre l’authentification

Comprendre OAuth pour les requêtes en contexte utilisateur.

Explorer les endpoints

Découvrez ce que vous pouvez créer.

Utiliser un SDK

Accélérez votre développement avec les bibliothèques officielles.

Créer quelque chose

Idées de projets à réaliser.