Démarrage rapide

Ce guide vous explique comment créer et supprimer des Publications à l’aide de la X API.

PrérequisAvant de commencer, vous aurez besoin :

d’un compte développeur avec une App approuvée
de jetons d’accès utilisateur (OAuth 1.0a ou OAuth 2.0 PKCE)

Créer une Publication

Préparer votre requête

Le point de terminaison POST /2/tweets nécessite un corps JSON contenant au minimum text ou media :

{
  "text": "Hello from the X API!"
}

Envoyer la requête

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello from the X API!"}'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# Créer une Publication
response = client.posts.create(text="Hello from the X API!")
print(f"Created Post: {response.data.id}")

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

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// Créer une Publication
const response = await client.posts.create({ text: "Hello from the X API!" });
console.log(`Created Post: ${response.data?.id}`);

Vérifier la réponse

Une réponse réussie contient l’id et le champ text de la nouvelle Publication :

{
  "data": {
    "id": "1445880548472328192",
    "text": "Hello from the X API!"
  }
}

Exemples avancés

Répondre à une publication

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Ceci est une réponse !",
    "reply": {
      "in_reply_to_tweet_id": "1234567890"
    }
  }'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# Créer une réponse
response = client.posts.create(
    text="Ceci est une réponse !",
    reply={"in_reply_to_tweet_id": "1234567890"}
)
print(f"Réponse créée : {response.data.id}")

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

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// Créer une réponse
const response = await client.posts.create({
  text: "Ceci est une réponse !",
  reply: { inReplyToTweetId: "1234567890" },
});
console.log(`Réponse créée : ${response.data?.id}`);

Citer une publication

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Regardez ça !",
    "quote_tweet_id": "1234567890"
  }'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# Citer une Publication
response = client.posts.create(
    text="Regardez ça !",
    quote_tweet_id="1234567890"
)
print(f"Citation créée : {response.data.id}")

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

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// Citer une Publication
const response = await client.posts.create({
  text: "Regardez ça !",
  quoteTweetId: "1234567890",
});
console.log(`Citation créée : ${response.data?.id}`);

Publication avec média intégré

Commencez par téléverser le média à l’aide du point de terminaison Media Upload, puis référencez le media_id :

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Photo du jour !",
    "media": {
      "media_ids": ["1234567890123456789"]
    }
  }'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# Publication avec média
response = client.posts.create(
    text="Photo du jour !",
    media={"media_ids": ["1234567890123456789"]}
)
print(f"Publication avec média créée : {response.data.id}")

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

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// Publication avec média
const response = await client.posts.create({
  text: "Photo du jour !",
  media: { mediaIds: ["1234567890123456789"] },
});
console.log(`Publication avec média créée : ${response.data?.id}`);

Publication contenant un sondage

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Quelle est votre couleur préférée ?",
    "poll": {
      "options": ["Rouge", "Bleu", "Vert", "Jaune"],
      "duration_minutes": 1440
    }
  }'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# Publication avec sondage
response = client.posts.create(
    text="Quelle est votre couleur préférée ?",
    poll={"options": ["Rouge", "Bleu", "Vert", "Jaune"], "duration_minutes": 1440}
)
print(f"Sondage créé : {response.data.id}")

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

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// Publication avec sondage
const response = await client.posts.create({
  text: "Quelle est votre couleur préférée ?",
  poll: { options: ["Rouge", "Bleu", "Vert", "Jaune"], durationMinutes: 1440 },
});
console.log(`Sondage créé : ${response.data?.id}`);

Supprimer une Publication

Obtenir l’identifiant de la Publication

Vous avez besoin de l’identifiant de la Publication que vous souhaitez supprimer. Celui-ci vous est renvoyé lorsque vous créez une Publication.

Envoyer une requête DELETE

cURL

curl -X DELETE "https://api.x.com/2/tweets/1445880548472328192" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# Supprimer une Publication
response = client.posts.delete("1445880548472328192")
print(f"Deleted: {response.data.deleted}")

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

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// Supprimer une Publication
const response = await client.posts.delete("1445880548472328192");
console.log(`Deleted: ${response.data?.deleted}`);

Confirmer la suppression

{
  "data": {
    "deleted": true
  }
}

Vous pouvez uniquement supprimer les Publications que vous avez créées.

Prochaines étapes

Guide d’intégration

Concepts clés et bonnes pratiques

Téléversement de médias

Importez des médias pour vos Publications

Référence de l’API

Documentation complète de l’endpoint

Exemples de code

Exemples de code prêts à l’emploi

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

Créer une Publication

Exemples avancés

Supprimer une Publication

Prochaines étapes

Guide d’intégration

Téléversement de médias

Référence de l’API

Exemples de code

​Créer une Publication

​Exemples avancés

​Supprimer une Publication

​Prochaines étapes

Guide d’intégration

Téléversement de médias

Référence de l’API

Exemples de code

Créer une Publication

Exemples avancés

Supprimer une Publication

Prochaines étapes