Démarrage rapide

Ce guide vous explique comment créer, mettre à jour et supprimer des listes.

PrérequisAvant de commencer, vous aurez besoin :

d’un compte développeur avec une App approuvée
d’un jeton d’accès utilisateur (User Access Token) (OAuth 1.0a ou OAuth 2.0 PKCE)

Créer une Liste

Préparer votre requête

Définissez le nom de la Liste (obligatoire), ainsi qu’éventuellement une description et des paramètres de confidentialité :

{
  "name": "Tech News",
  "description": "Top tech journalists and publications",
  "private": false
}

Envoyer la requête

cURL

curl -X POST "https://api.x.com/2/lists" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tech News",
    "description": "Top tech journalists and publications",
    "private": false
  }'

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 nouvelle Liste
response = client.lists.create(
    name="Tech News",
    description="Top tech journalists and publications",
    private=False
)

print(f"List created: {response.data.id} - {response.data.name}")

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 nouvelle Liste
const response = await client.lists.create({
  name: "Tech News",
  description: "Top tech journalists and publications",
  private: false,
});

console.log(`List created: ${response.data?.id} - ${response.data?.name}`);

Examiner la réponse

{
  "data": {
    "id": "1441162269824405510",
    "name": "Tech News"
  }
}

Enregistrez l’id afin de pouvoir mettre à jour ou supprimer la Liste ultérieurement.

Mettre à jour une liste

Modifiez le nom, la description ou les paramètres de confidentialité d’une liste :

cURL

curl -X PUT "https://api.x.com/2/lists/1441162269824405510" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tech News & Insights",
    "description": "Updated description"
  }'

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)

# Mettre à jour une liste
response = client.lists.update(
    "1441162269824405510",
    name="Tech News & Insights",
    description="Updated description"
)

print(f"Updated: {response.data.updated}")

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 });

// Mettre à jour une liste
const response = await client.lists.update("1441162269824405510", {
  name: "Tech News & Insights",
  description: "Updated description",
});

console.log(`Updated: ${response.data?.updated}`);

Réponse :

{
  "data": {
    "updated": true
  }
}

Supprimer une Liste

Récupérer l'identifiant de la Liste

Vous avez besoin de l’identifiant de la Liste que vous souhaitez supprimer.

Envoyer la requête de suppression

cURL

curl -X DELETE "https://api.x.com/2/lists/1441162269824405510" \
  -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 Liste
response = client.lists.delete("1441162269824405510")
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 Liste
const response = await client.lists.delete("1441162269824405510");
console.log(`Deleted: ${response.data?.deleted}`);

Confirmer la suppression

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

Vous ne pouvez supprimer que les Listes que vous possédez.

Étapes suivantes

Membres de liste

Ajouter et supprimer des membres de liste

Recherche de liste

Récupérer les détails de la liste

Guide d’intégration

Concepts clés et bonnes pratiques

Référence de l’API

Documentation complète de l’endpoint

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 Liste

Mettre à jour une liste

Supprimer une Liste

Étapes suivantes

Membres de liste

Recherche de liste

Guide d’intégration

Référence de l’API

​Créer une Liste

​Mettre à jour une liste

​Supprimer une Liste

​Étapes suivantes

Membres de liste

Recherche de liste

Guide d’intégration

Référence de l’API

Créer une Liste

Mettre à jour une liste

Supprimer une Liste

Étapes suivantes