Skip to main content
GET
Get User TimeLine
Retrieve a user’s own tweets by numeric userId, newest first, matching the order shown on their profile in the X app. Up to 20 tweets per page; pass the returned cursor for more. Optionally include replies and the parent tweet of each reply. Use this to read what an account publishes over time. Time-range filtering is NOT supported here — if you need tweets within a specific time window, use get_twitter_user_mentions (which accepts sinceTime/untilTime) or get_twitter_tweet_advanced_search with date operators in the query. If you only have a @handle, get_twitter_user_last_tweets accepts either handle or ID.
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/user/tweet_timeline
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/twitter/user/tweet_timeline
  • cursor: query; optional
  • includeParentTweet: query; optional
  • includeReplies: query; optional
  • userId: query; optional
  • userName: query; optional
  • Runtime facts: 4fdc418106627f05544fcd24ae144896651876a511bab40974894d8c4c6f83cd
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Usage-based billing; Default request estimate: $0.0057 USD (not a fixed price). 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.0057
  • Cost contract: response_count
  • Published reference multiplier: 1.0
  • Settlement evidence source: response_body

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.

includeParentTweet
string

Whether to include the parent tweet when a tweet is a reply. Defaults to false.

Provider reference (supplier schema): {"default":false,"type":"boolean"}.

includeReplies
string

Whether to include replies in the results. Defaults to false.

Provider reference (supplier schema): {"default":false,"type":"boolean"}.

userId
string

User ID of the user whose timeline to retrieve.

userName
string

Response

User tweet timeline

code
integer

Provider status code returned by the AIsa wrapper.

data
object
has_next_page
boolean
msg
string
next_cursor
string | null
status
enum<string>
Available options:
success,
error