Skip to main content
GET
Get User Tweet 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.

Authorizations

Authorization
string
header
required

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

Query Parameters

userId
string

User ID of the user whose timeline to retrieve.

includeReplies
boolean
default:false

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

includeParentTweet
boolean
default:false

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

cursor
string

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

Response

200 - application/json

User tweet timeline

status
enum<string>
Available options:
success,
error
code
integer

Provider status code returned by the AIsa wrapper.

msg
string
data
object
has_next_page
boolean
next_cursor
string | null