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

5 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

x-twitter.search
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"

Response57 fields
statusstring

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

timelinearrayitems
53 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_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.

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