Passer au contenu principal
Ce guide vous explique comment récupérer des Publications à partir de la chronologie d’une Liste.
PrérequisAvant de commencer, vous aurez besoin :

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

Interroger la chronologie de la Liste

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

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

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