Guide d’intégration

Ce guide présente les principaux concepts nécessaires pour intégrer les endpoints de consultation de Listes à votre application.

Authentification

Les endpoints de recherche de listes prennent en charge plusieurs méthodes d’authentification :

Méthode	Idéal pour	Accès aux listes privées ?
OAuth 2.0 App-Only	Données de listes publiques	Non
OAuth 2.0 Authorization Code with PKCE	Applications destinées aux utilisateurs finaux	Oui (possédées/suivies)
OAuth 1.0a User Context	Anciennes intégrations	Oui (possédées/suivies)

Exemple de requête

cURL

curl "https://api.x.com/2/lists/84839422?\
list.fields=description,member_count,follower_count,private" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Récupérer une Liste par identifiant
response = client.lists.get(
    list_id="84839422",
    list_fields=["description", "member_count", "follower_count", "private"]
)
print(response.data)

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

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

const response = await client.lists.get("84839422", {
  listFields: ["description", "member_count", "follower_count", "private"],
});
console.log(response.data);

Aperçu des points de terminaison

Méthode	Endpoint	Description
GET	`/2/lists/:id`	Obtenir une liste par identifiant
GET	`/2/users/:id/owned_lists`	Obtenir les listes dont un utilisateur est propriétaire

Champs et expansions

Réponse par défaut

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

Champs disponibles

list.fields

Champ	Description
`created_at`	Horodatage de création de la Liste
`description`	Description de la Liste
`follower_count`	Nombre d’abonnés
`member_count`	Nombre de membres
`owner_id`	ID utilisateur du propriétaire
`private`	Indique si la Liste est privée

user.fields (requiert l'expansion owner_id)

Champ	Description
`username`	@handle du propriétaire
`name`	Nom d’affichage du propriétaire
`verified`	Statut de vérification du propriétaire
`profile_image_url`	URL de l’avatar du propriétaire

Exemple avec expansions

cURL

curl "https://api.x.com/2/lists/84839422?\
list.fields=description,member_count,follower_count,owner_id&\
expansions=owner_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 Liste avec expansion du propriétaire
response = client.lists.get(
    list_id="84839422",
    list_fields=["description", "member_count", "follower_count", "owner_id"],
    expansions=["owner_id"],
    user_fields=["username", "verified"]
)

print(response.data)
print(response.includes)  # Contient l'objet utilisateur du propriétaire

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

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

const response = await client.lists.get("84839422", {
  listFields: ["description", "member_count", "follower_count", "owner_id"],
  expansions: ["owner_id"],
  userFields: ["username", "verified"],
});

console.log(response.data);
console.log(response.includes); // Contient l'objet utilisateur du propriétaire

Réponse avec expansion

{
  "data": {
    "id": "84839422",
    "name": "Tech News",
    "description": "Top tech journalists",
    "member_count": 50,
    "follower_count": 1250,
    "owner_id": "2244994945"
  },
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "username": "XDevelopers",
        "verified": true
      }
    ]
  }
}

Guide sur les champs et les expansions

En savoir plus sur la personnalisation des réponses

Pagination

Lorsque vous récupérez les Listes dont vous êtes le propriétaire, les résultats sont paginés :

cURL

# Première requête
curl "https://api.x.com/2/users/123/owned_lists?max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

# Requête suivante avec jeton de pagination
curl "https://api.x.com/2/users/123/owned_lists?max_results=100&pagination_token=NEXT_TOKEN" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Le SDK gère la pagination automatiquement
all_lists = []

for page in client.lists.get_user_owned_lists(user_id="123", max_results=100):
    if page.data:
        all_lists.extend(page.data)

print(f"Nombre de listes trouvées : {len(all_lists)}")

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

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

async function getAllOwnedLists(userId) {
  const allLists = [];

  // Le SDK gère la pagination automatiquement
  const paginator = client.lists.getUserOwnedLists(userId, { maxResults: 100 });

  for await (const page of paginator) {
    if (page.data) {
      allLists.push(...page.data);
    }
  }

  return allLists;
}

// Utilisation
const lists = await getAllOwnedLists("123");
console.log(`Nombre de listes trouvées : ${lists.length}`);

Guide de pagination

En savoir plus sur la pagination

Listes privées

Les Listes privées ne sont visibles que de leur propriétaire
Vous devez vous authentifier en tant que propriétaire pour accéder aux détails d’une Liste privée
Le champ private indique si une Liste est privée

Gestion des erreurs

Statut	Erreur	Solution
400	Requête invalide	Vérifiez le format de l’id de la liste
401	Non autorisé	Vérifiez l’authentification
403	Accès interdit	La liste est peut-être privée
404	Introuvable	La liste n’existe pas
429	Trop de requêtes	Patientez avant de réessayer

Prochaines étapes

Démarrage rapide

Envoyez votre première requête de recherche de Liste

Publications d’une Liste

Récupérez des Publications à partir d’une Liste

Référence de l’API

Documentation complète de l’endpoint

Exemples de code

Exemples de code fonctionnels

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

Guide d’intégration

Authentification

Exemple de requête

Aperçu des points de terminaison

Champs et expansions

Réponse par défaut

Champs disponibles

Exemple avec expansions

Réponse avec expansion

Guide sur les champs et les expansions

Guide de pagination

Listes privées

Gestion des erreurs

Prochaines étapes

Démarrage rapide

Publications d’une Liste

Référence de l’API

Exemples de code