Démarrage rapide

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 »)

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

Envoyer une requête

cURL

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

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Récupérer une Publication unique par identifiant
response = client.posts.get("1228393702244134912")
print(response.data)

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

const response = await client.posts.get("1228393702244134912");
console.log(response.data);

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"]
  }
}

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"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Récupérer une Publication avec des champs supplémentaires et des expansions
response = client.posts.get(
    "1228393702244134912",
    tweet_fields=["created_at", "public_metrics", "author_id"],
    expansions=["author_id"],
    user_fields=["username", "verified"]
)

print(response.data)
print(response.includes)  # Contient l'objet utilisateur de l'auteur

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

const response = await client.posts.get("1228393702244134912", {
  tweetFields: ["created_at", "public_metrics", "author_id"],
  expansions: ["author_id"],
  userFields: ["username", "verified"],
});

console.log(response.data);
console.log(response.includes); // Contient l'objet utilisateur de l'auteur

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
      }
    ]
  }
}

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"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Récupérez plusieurs Publications par leurs identifiants
response = client.posts.get_posts(
    ids=["1228393702244134912", "1227640996038684673", "1199786642791452673"],
    tweet_fields=["created_at", "author_id"]
)

for post in response.data:
    print(f"{post.id}: {post.text[:50]}...")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

const response = await client.posts.getPosts({
  ids: ["1228393702244134912", "1227640996038684673", "1199786642791452673"],
  tweetFields: ["created_at", "author_id"],
});

response.data?.forEach((post) => {
  console.log(`${post.id}: ${post.text?.slice(0, 50)}...`);
});

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

Vue d’ensemble

Publications

Utilisateurs

Messages privés

Mentions J’aime

Listes

Espaces

Communautés

Notes de la communauté

Tendances

Actualités

Médias

Activité sur X

Utilisation

Connexions de flux

Conformité

Enterprise v2

Flux des J’aime

GNIP 2.0

Démarrage rapide

Prochaines étapes

Guide d’intégration

Champs et Expansions

Référence de l’API

Exemples de code

​Prochaines étapes

Guide d’intégration

Champs et Expansions

Référence de l’API

Exemples de code

Prochaines étapes