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

4 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

x-twitter.user_timeline
Parameters3 fields
user_namestringOptional

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, user_name is ignored.

max length 32

cursorstringOptional

Pagination cursor from a previous response next_cursor field.

max length 4096

Response72 fields
statusstring

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

timelinearrayitems
53 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_rangeinteger[]

Start and end character indices for the display text range.

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 @.

mediaobject
8 fields

Attached media grouped by type (for example video and photo arrays) when present.

videoarrayitems
5 fields

Video media items when present.

media_url_httpsstring

HTTPS URL for the video thumbnail or asset.

variantsarrayitems
3 fields

Available video quality variants when present.

bitrateinteger

Video bitrate when provided.

content_typestring

MIME type for the media variant.

urlstring

HTTPS URL for the media variant.

photoarrayitems
1 field

Photo media items when present.

media_url_httpsstring

HTTPS URL for the photo asset.

entitiesobject
12 fields

Parsed entities from the tweet text.

user_mentionsarrayitems
4 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 @.

indicesinteger[]

Start and end character indices in the tweet text.

hashtagsarrayitems
2 fields

Hashtags parsed from the tweet text.

textstring

Hashtag text without the leading #.

indicesinteger[]

Start and end character indices 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