Guide d’intégration

Concepts clés et bonnes pratiques pour intégrer la consultation de listes

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

shellscript

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

---

​

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

shellscript

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"

​

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

shellscript

# 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"

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