Vee3

Search X

Search X (Twitter) posts by keyword with optional pagination and result type.

← All X / Twitter endpoints · Capability overview

GET/v1/x-twitter/search

https://api.vee3.io/v1/x-twitter/search

10 tokens

Search X (Twitter) posts by keyword with optional pagination and result type.

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

search_x
Parameters3 fields
querystringRequired

Search keywords or phrase.

max length 512

cursorstringOptional

Pagination cursor from a previous response next_cursor field.

max length 4096

search_type"Top" | "Latest" | "Media" | "People" | "Lists"Optional

Result ranking mode.

Default: "Top"

Response54 fields
statusstring

Search status from the upstream provider (ok on success).

timelinearrayitems
50 fields

Matching posts from the search. 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.

next_cursorstring

Cursor for the next results page, when available.

prev_cursorstring

Cursor for the previous results page, when available.

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