Vee3

Get X user timeline

Fetch recent posts from an X (Twitter) user profile with optional pagination.

← All X / Twitter endpoints · Capability overview

GET/v1/x-twitter/user-timeline

https://api.vee3.io/v1/x-twitter/user-timeline

10 tokens

Fetch recent posts from an X (Twitter) user profile with optional pagination.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

get_x_user_timeline
Parameters3 fields
screennamestringOptional

X handle without the leading @ (for example elonmusk). Required when rest_id is omitted.

max length 50

rest_idstringOptional

Numeric X user id (rest_id). When provided, screenname is ignored.

max length 32

cursorstringOptional

Pagination cursor from a previous response next_cursor field.

max length 4096

Response69 fields
statusstring

Timeline fetch status from the upstream provider (ok on success).

timelinearrayitems
50 fields

Recent posts from the user. Additional provider-specific fields may appear on each entry.

typestring

Timeline entry type (for example tweet).

tweet_idstring

Numeric tweet id.

screen_namestring

Author handle without the leading @.

textstring

Tweet body text.

created_atstring

Tweet creation timestamp from X.

langstring

Detected language code.

favoritesinteger

Like count.

retweetsinteger

Repost count.

repliesinteger

Reply count.

quotesinteger

Quote count.

bookmarksinteger

Bookmark count.

viewsstring

View count when provided by the upstream provider.

conversation_idstring

Conversation thread id for the tweet.

sourcestring

Client or app source string from X.

display_text_rangearrayitems
1 field

Start and end indices for the display text range.

indexinteger

Character index in the tweet text.

user_infoobject
7 fields

Embedded author profile for the tweet.

screen_namestring

Author handle without the leading @.

namestring

Author display name.

rest_idstring

Numeric X user id.

avatarstring

Profile avatar image URL.

verifiedboolean

Whether the author account is verified.

followers_countinteger

Follower count when provided by the upstream provider.

friends_countinteger

Following count when provided by the upstream provider.

authorobject
3 fields

Author profile summary embedded in the timeline entry.

rest_idstring

Numeric X user id.

namestring

Author display name.

screen_namestring

Author handle without the leading @.

mediaarrayitems
2 fields

Attached media items when present.

typestring

Media type (for example photo or video).

media_url_httpsstring

HTTPS URL for the media asset.

entitiesobject
14 fields

Parsed entities from the tweet text.

user_mentionsarrayitems
5 fields

User mentions parsed from the tweet text.

id_strstring

Mentioned user id.

namestring

Mentioned user display name.

screen_namestring

Mentioned user handle without the leading @.

indicesarrayitems
1 field

Start and end indices in the tweet text.

indexinteger

Character index in the tweet text.

hashtagsarrayitems
3 fields

Hashtags parsed from the tweet text.

textstring

Hashtag text without the leading #.

indicesarrayitems
1 field

Start and end indices in the tweet text.

indexinteger

Character index in the tweet text.

urlsarrayitems
3 fields

URLs parsed from the tweet text.

urlstring

Short or display URL.

expanded_urlstring

Expanded destination URL.

display_urlstring

Display-friendly URL.

quoted_tweetobject
3 fields

Quoted tweet summary when the post quotes another tweet.

tweet_idstring

Numeric tweet id for the quoted post.

textstring

Quoted tweet body text.

screen_namestring

Quoted tweet author handle.

pinnedobject
8 fields

Pinned tweet object when the user has one pinned post.

tweet_idstring

Numeric tweet id for the pinned post.

textstring

Pinned tweet body text.

favoritesinteger

Like count.

retweetsinteger

Repost count.

authorobject
3 fields

Author profile summary for the pinned tweet.

rest_idstring

Numeric X user id.

namestring

Author display name.

screen_namestring

Author handle without the leading @.

userobject
5 fields

Profile summary for the requested user.

statusstring

Account status from the upstream provider.

profilestring

X screen name (handle).

rest_idstring

Numeric X user id.

namestring

Display name shown on the profile.

sub_countinteger

Follower count.

next_cursorstring

Cursor for the next timeline page, when available.

prev_cursorstring

Cursor for the previous timeline page, when available.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, x_user_not_found, x_twitter_not_configured, x_twitter_upstream_error