Skip to main content
GET
/
x
/
lists
/
{id}
/
tweets
Get list tweets
curl --request GET \
  --url https://api.example.com/x/lists/{id}/tweets \
  --header 'x-api-key: <x-api-key>'
1 credit per tweet returned · All plans from $0.00012/credit
curl "https://xquik.com/api/v1/x/lists/1234567890/tweets" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

Path parameters

id
string
required
List ID (numeric string).

Query parameters

cursor
string
Pagination cursor from a previous response. Omit for the first page.
sinceTime
string
ISO 8601 timestamp. Only return tweets after this time.
untilTime
string
ISO 8601 timestamp. Only return tweets before this time.
includeReplies
boolean
Include reply tweets. Default: false.

Headers

x-api-key
string
required
Your API key. Session cookie authentication is also supported.

Response

tweets
object[]
Array of tweets from the list.
has_next_page
boolean
Whether more results are available.
next_cursor
string
Cursor for the next page. Pass as the cursor query parameter.
{
  "tweets": [
    {
      "id": "1893456789012345678",
      "text": "Hello from a list!",
      "createdAt": "2026-03-27T10:00:00.000Z",
      "likeCount": 42,
      "retweetCount": 5,
      "viewCount": 1200
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGE..."
}