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.
First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. The commands per client, and what each call costs, are on aisa.one/mcp.
Set this endpoint up in your agent →

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