Consultation des signets

Récupérer vos Publications mises en signet

Ce guide vous explique comment récupérer vos Publications que vous avez ajoutées aux signets à l’aide de la X API.

Prérequis

Avant de commencer, vous aurez besoin de :

• D’un compte développeur avec une App approuvée
• D’un jeton d’accès utilisateur avec la portée bookmark.read (OAuth 2.0 PKCE)

---

​

Récupérez vos signets

1. Récupérez votre ID utilisateur

   Vous avez besoin de l’ID de votre utilisateur authentifié. Vous pouvez le récupérer à l’aide de l’endpoint /2/users/me ou à partir de l’endpoint de recherche d’utilisateurs.

2. Récupérez vos signets

   cURL

   shellscript

   curl "https://api.x.com/2/users/2244994945/bookmarks?\
   tweet.fields=created_at,public_metrics,author_id&\
   max_results=10" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN"
   
3. Analyser la réponse

   {
     "data": [
       {
         "id": "1501258597237342208",
         "text": "Have you built a project using the X API you'd like to share with the community? We'd love to hear from you!",
         "created_at": "2024-01-15T10:30:00.000Z",
         "author_id": "2244994945",
         "public_metrics": {
           "retweet_count": 15,
           "reply_count": 8,
           "like_count": 89,
           "quote_count": 3
         }
       },
       {
         "id": "1501258542258348032",
         "text": "This is just one way developer innovation helps make X a better place...",
         "created_at": "2024-01-15T09:15:00.000Z",
         "author_id": "2244994945",
         "public_metrics": {
           "retweet_count": 22,
           "reply_count": 5,
           "like_count": 156,
           "quote_count": 7
         }
       }
     ],
     "meta": {
       "result_count": 2,
       "next_token": "7140dibdnow9c7btw4539n0vybdnx19ylpayqf16fjt4l"
     }
   }
   

---

​

Inclure les informations sur l’auteur

Utilisez le paramètre expansions pour obtenir des données sur les auteurs de Publications :

cURL

shellscript

curl "https://api.x.com/2/users/2244994945/bookmarks?\
tweet.fields=created_at,author_id&\
expansions=author_id&\
user.fields=username,verified" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

---

​

Scopes requis

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

Scope	Description
bookmark.read	Lire les signets
tweet.read	Lire les données de Publication
users.read	Lire les données utilisateur (pour les expansions)

---

​

Étapes suivantes

Gérer les signets

Ajouter et supprimer des signets

Référence de l’API

Documentation complète de l’endpoint