Démarrage rapide

Récupérer des publications à partir du fil d’une Liste

Ce guide vous explique comment récupérer des Publications à partir de la chronologie d’une Liste.

Prérequis

Avant de commencer, vous aurez besoin :

• D’un compte développeur avec une App approuvée
• Du Jeton Bearer de votre App

---

1. Trouver l’ID d’une Liste

   Vous pouvez trouver l’ID d’une Liste dans l’URL lorsque vous consultez une Liste sur x.com :

   https://x.com/i/lists/84839422
                         └── Il s’agit de l’ID de la Liste
   
2. Interroger la chronologie de la Liste

   cURL

   shellscript

   curl "https://api.x.com/2/lists/84839422/tweets?\
   tweet.fields=created_at,public_metrics,author_id&\
   expansions=author_id&\
   user.fields=username,verified&\
   max_results=10" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   
3. Examiner la réponse

   {
     "data": [
       {
         "id": "1458172421115101189",
         "text": "Check out our latest announcement...",
         "author_id": "4172587277",
         "created_at": "2024-01-15T10:30:00.000Z",
         "public_metrics": {
           "retweet_count": 42,
           "reply_count": 5,
           "like_count": 156,
           "quote_count": 3
         },
         "edit_history_tweet_ids": ["1458172421115101189"]
       }
     ],
     "includes": {
       "users": [
         {
           "id": "4172587277",
           "username": "TechNews",
           "verified": true
         }
       ]
     },
     "meta": {
       "result_count": 1,
       "next_token": "7140dibdnow9c7btw3z2vwioavpvutgzrzm9icis4ndix"
     }
   }
   
4. Parcourir les résultats avec pagination

   Les SDK gèrent la pagination automatiquement. Pour cURL, utilisez le next_token renvoyé dans la réponse pour obtenir davantage de Publications :

   curl "https://api.x.com/2/lists/84839422/tweets?\
   max_results=10&\
   pagination_token=7140dibdnow9c7btw3z2vwioavpvutgzrzm9icis4ndix" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   

Ce endpoint renvoie jusqu’à 800 des Publications les plus récentes de la Liste.

---

​

Prochaines étapes

Recherche de liste

Obtenir les détails de la liste

Membres de la liste

Obtenir les membres de la liste

Guide d’intégration

Concepts clés et bonnes pratiques

Référence de l’API

Documentation complète du point de terminaison