v11

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0112893437.0 KB
Lists

List tweets from an X List

get/x/lists/{id}/tweets

Path parameters

idstring required

List ID for tweet lookup

Query parameters

cursorstring

Pagination cursor for list tweets

pageSizeinteger

Maximum page items (1-100, default 20). Source, filters, or credits can reduce results. Continue while has_next_page is true. Deprecated limit and count aliases remain accepted.

sinceTimestring

Unix timestamp - filter after

untilTimestring

Unix timestamp - filter before

includeRepliesboolean

Include replies (default false)

Response

List tweets

has_next_pageboolean required
next_cursorstring required

Example response

{
  "tweets": [
    {
      "id": "1234567890",
      "text": "Just launched our new feature!",
      "retweetCount": 5,
      "replyCount": 3,
      "likeCount": 42,
      "quoteCount": 1,
      "viewCount": 1500,
      "bookmarkCount": 2
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGRElMJcAAA"
}