Passer au contenu principal
Ce guide vous explique comment effectuer votre première requête de récupération d’une Publication à l’aide de la X API v2.
PrérequisAvant de commencer, vous aurez besoin :
  • D’un compte développeur avec une App approuvée
  • Du Jeton Bearer de votre App (disponible dans la Console de développement sous « Keys and tokens »)
1

Trouver l’identifiant d’une Publication

Chaque Publication a un ID unique. Vous pouvez le trouver dans l’URL de la Publication :
https://x.com/XDevelopers/status/1228393702244134912
                                └── Il s'agit de l'ID de la Publication
2

Envoyer une requête

cURL
curl "https://api.x.com/2/tweets/1228393702244134912" \
  -H "Authorization: Bearer $BEARER_TOKEN"
3

Examiner la réponse

La réponse par défaut inclut l’id, le text et les edit_history_tweet_ids de la Publication :
{
  "data": {
    "id": "1228393702244134912",
    "text": "What did the developer write in their Valentine's card?\n\nwhile(true) {\n    I = Love(You);\n}",
    "edit_history_tweet_ids": ["1228393702244134912"]
  }
}
4

Demander des champs supplémentaires

Utilisez des paramètres de requête pour obtenir davantage de données :
cURL
curl "https://api.x.com/2/tweets/1228393702244134912?\
tweet.fields=created_at,public_metrics,author_id&\
expansions=author_id&\
user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"
Réponse :
{
  "data": {
    "id": "1228393702244134912",
    "text": "What did the developer write in their Valentine's card?...",
    "created_at": "2020-02-14T19:00:55.000Z",
    "author_id": "2244994945",
    "public_metrics": {
      "retweet_count": 156,
      "reply_count": 23,
      "like_count": 892,
      "quote_count": 12
    },
    "edit_history_tweet_ids": ["1228393702244134912"]
  },
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "username": "XDevelopers",
        "verified": true
      }
    ]
  }
}
5

Rechercher plusieurs Publications

Récupérez jusqu’à 100 Publications en une seule requête :
cURL
curl "https://api.x.com/2/tweets?\
ids=1228393702244134912,1227640996038684673,1199786642791452673&\
tweet.fields=created_at,author_id" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
Prochaines étapes

Guide d’intégration

Découvrez l’authentification, les limites de taux et les meilleures pratiques

Champs et Expansions

Maîtrisez le système des champs et des expansions

Référence de l’API

Consultez tous les paramètres disponibles

Exemples de code

Explorez d’autres exemples