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. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.
Set this endpoint up in your agent →

Request contract

  • Method and path: GET /apis/v1/twitter/list/tweets_timeline
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/twitter/list/tweets_timeline
  • cursor: query; optional
  • listId: query; required
  • Runtime facts: 4fdc418106627f05544fcd24ae144896651876a511bab40974894d8c4c6f83cd
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Published reference price: $0.0015 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.0015
  • Cost contract: fixed_success
  • Published reference multiplier: 1.0
  • Settlement evidence source: request_snapshot

Authorizations

Authorization
string
header
required

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

Query Parameters

cursor
string

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

listId
string
required

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

Response

List tweet timeline response

has_next_page
boolean

Indicates if there are more results available

msg
string

Message of the request, error message if status is error

next_cursor
string

Cursor for fetching the next page of results

status
enum<string>

Status of the request

Available options:
success,
error
Example:

"success"

tweets
object[]

Array of tweets from the list