Listes épinglées

Afficher et gérer les listes épinglées

Les endpoints Pinned Lists vous permettent de consulter, d’épingler et de désépingler des Listes pour l’utilisateur authentifié. Les Listes épinglées sont mises en avant dans l’interface X de l’utilisateur.

​

Vue d’ensemble

Voir les Listes épinglées

Obtenir les Listes épinglées d’un utilisateur

Épingler une Liste

Épingler une Liste

Retirer l’épingle d’une Liste

Retirer l’épingle d’une Liste

---

​

Points de terminaison

Méthode	Point de terminaison	Description
GET	/2/users/:id/pinned_lists	Obtenir les Listes épinglées
POST	/2/users/:id/pinned_lists	Épingler une Liste
DELETE	/2/users/:id/pinned_lists/:list_id	Désépingler une Liste

---

​

Exemple : obtenir les Listes épinglées

curl "https://api.x.com/2/users/123456789/pinned_lists?\
list.fields=name,description,member_count" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

​

Exemple : épingler une liste

curl -X POST "https://api.x.com/2/users/123456789/pinned_lists" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"list_id": "9876543210"}'

---

​

Pour commencer

Prérequis

• Un compte développeur approuvé
• Un projet et une App dans la Console de développement
• Des jetons d’accès utilisateur via OAuth 2.0 PKCE

Démarrage rapide pour la consultation

Récupérer les listes épinglées

Démarrage rapide pour la gestion

Épingler et désépingler des listes

Guide d'intégration

Concepts clés et bonnes pratiques

Référence de l’API

Documentation complète de l’endpoint