Skip to main content
GET
Get List Tweet Timeline
Get the tweet timeline of an X List by listId, up to 20 per page, cursor-paginated. Use this to monitor a hand-curated set of accounts as a single feed — Lists are the cheapest way to track a fixed cohort (competitors, analysts, a beat) without polling each account. Returns tweets with has_next_page and next_cursor. To see who is in the List use get_twitter_list_members.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

listId
string
required

The list ID to get tweets from. e.g. 1846987139428634858

cursor
string

Cursor for paginating through results. Leave empty for the first page.

Response

200 - application/json

List tweet timeline response

tweets
object[]

Array of tweets from the list

has_next_page
boolean

Indicates if there are more results available

next_cursor
string

Cursor for fetching the next page of results

status
enum<string>

Status of the request

Available options:
success,
error
Example:

"success"

msg
string

Message of the request, error message if status is error