Gérer les signets

Ajouter et supprimer des signets à l’aide de l’API X

Ce guide vous explique comment ajouter et supprimer des signets via la X API.

Prérequis

Avant de commencer, vous aurez besoin :

• d’un compte développeur avec une App approuvée
• d’un jeton d’accès utilisateur avec le scope bookmark.write (OAuth 2.0 PKCE)

---

​

Ajouter un signet

1. Récupérer l'identifiant utilisateur

   Vous avez besoin de l’identifiant de l’utilisateur authentifié. Vous pouvez le trouver en utilisant l’endpoint /2/users/me ou l’endpoint de recherche d’utilisateur.

2. Récupérer l'ID de la Publication

   Trouvez l’ID de la Publication dans l’URL lorsque vous affichez une Publication :

   https://x.com/XDevelopers/status/1460323737035677698
                                   └── Ceci est l'ID de la Publication
   
3. Ajouter le signet

   cURL

   shellscript

   curl -X POST "https://api.x.com/2/users/2244994945/bookmarks" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"tweet_id": "1460323737035677698"}'
   
4. Examiner la réponse

   {
     "data": {
       "bookmarked": true
     }
   }
   

---

​

Supprimer un signet

Supprimez une Publication de vos signets :

cURL

shellscript

curl -X DELETE "https://api.x.com/2/users/2244994945/bookmarks/1460323737035677698" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

Réponse :

{
  "data": {
    "bookmarked": false
  }
}

---

​

Scopes requis

Lorsque vous utilisez OAuth 2.0 PKCE, votre jeton d’accès doit inclure les scopes suivants :

Scope	Description
bookmark.write	Ajouter et supprimer des signets
tweet.read	Lire les données de Publication
users.read	Lire les données d’utilisateur

---

​

Étapes suivantes

Consultation des signets

Récupérez vos Publications enregistrées dans vos signets

Référence de l’API

Documentation complète de l’endpoint