X / Twitter

Unofficial X (Twitter) API. Use search, read tweets and its replies. Fetch users, their profiles and posts.

GET/v1/x-twitter/tweet-info

https://api.vee3.io/v1/x-twitter/tweet-info

5 tokens

Look up a single X (Twitter) post by numeric tweet id.

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_tweet_info

Parameters1 field

idstringRequired

Numeric tweet id.

max length 32

Response25 fields

idstring

Numeric tweet id.

textstring

Tweet body text.

created_atstring

Tweet creation timestamp from X.

likesinteger

Like count.

retweetsinteger

Repost count.

repliesinteger

Reply count.

quotesinteger

Quote count.

bookmarksinteger

Bookmark count.

langstring

Detected language code.

conversation_idstring

Conversation thread id for the tweet.

authorobject

5 fields

Author profile summary for the tweet.

rest_idstring

Numeric X user id.

namestring

Author display name.

screen_namestring

Author handle without the leading @.

imagestring

Profile avatar image URL.

blue_verifiedboolean

Whether the author has X blue verification.

mediaobject

8 fields

Attached media grouped by type (for example photo or video arrays). Additional provider-specific media fields may appear.

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.

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

Example request

Python

import requests

url = "https://api.vee3.io/v1/x-twitter/tweet-info"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "url": "https://example.com"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Tweet lookup with attached video media.

video_tweet.json

{
  "id": "1671370010743263233",
  "likes": 18776,
  "created_at": "Wed Jun 21 04:10:37 +0000 2023",
  "text": "Watching Twitter videos on my TV only took me a few seconds to set up🤯\n\nAn awesome feature, if you're watching longer videos on X/Twitter @elonmusk https://t.co/r1LzZ5ovoD",
  "retweets": 2518,
  "bookmarks": 983,
  "quotes": 212,
  "replies": 1649,
  "lang": "en",
  "conversation_id": "1671370010743263233",
  "author": {
    "rest_id": "2337692699",
    "name": "Mathias Føns",
    "screen_name": "FonsDK",
    "image": "https://pbs.twimg.com/profile_images/1485391315819020292/1_3QNpYj_normal.jpg",
    "blue_verified": true
  },
  "media": {
    "video": [
      {
        "media_url_https": "https://pbs.twimg.com/amplify_video_thumb/1671367628504309761/img/WoU2L8IXtzfmhlq9.jpg"
      }
    ]
  }
}

GET/v1/x-twitter/user-info

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

5 tokens

Look up an X (Twitter) user profile by screen name or numeric user id.

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_info

Parameters2 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

Response26 fields

statusstring

Profile lookup status from the upstream provider.

profilestring

X screen name (handle).

rest_idstring

Numeric X user id.

namestring

Display name shown on the profile.

descstring

Profile bio / description.

avatarstring

Profile avatar image URL.

header_imagestring

Profile banner image URL.

blue_verifiedboolean

Whether the account has X blue verification.

protectedboolean

Whether the account is protected (private).

friendsinteger

Number of accounts the user follows.

sub_countinteger

Follower count.

statuses_countinteger

Total post count.

media_countinteger

Total media item count.

created_atstring

Account creation timestamp from X.

locationstring

Profile location string.

verification_typestring

Verification type label from X when present.

idstring

Numeric X user id (may duplicate rest_id).

pinned_tweet_ids_strarrayitems

1 field

Pinned tweet ids for the profile when present.

tweet_idstring

Numeric tweet id.

affiliatesobject

2 fields

Affiliate account metadata when present (object or empty array from the provider). Additional provider-specific fields may appear.

urlstring

Affiliate profile or badge URL when provided.

descriptionstring

Affiliate description text when provided.

business_accountarrayitems

3 fields

Business account metadata when present (object with counts or array entries depending on the provider response).

categoryobject

2 fields

Business category metadata when provided.

namestring

Business category name.

idstring

Business category id.

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

Example request

Python

import requests

url = "https://api.vee3.io/v1/x-twitter/user-info"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "url": "https://example.com"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Profile lookup by screen name.

elonmusk.json

{
  "status": "active",
  "profile": "elonmusk",
  "rest_id": "44196397",
  "blue_verified": true,
  "verification_type": null,
  "avatar": "https://pbs.twimg.com/profile_images/2053244804520427520/m8mdWZCG_normal.jpg",
  "header_image": "https://pbs.twimg.com/profile_banners/44196397/1774145451",
  "desc": "https://t.co/dDtDyVssfm",
  "name": "Elon Musk",
  "protected": false,
  "location": "",
  "friends": 1345,
  "sub_count": 240178418,
  "statuses_count": 103342,
  "media_count": 4514,
  "pinned_tweet_ids_str": [
    "2059299542277697565"
  ],
  "created_at": "Tue Jun 02 20:12:29 +0000 2009",
  "id": "44196397"
}

GET/v1/x-twitter/tweet-replies

https://api.vee3.io/v1/x-twitter/tweet-replies

10 tokens

Fetch the latest replies for an X (Twitter) post 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_tweet_replies

Parameters2 fields

idstringRequired

Numeric tweet id.

max length 32

cursorstringOptional

Pagination cursor from a previous response next_cursor field.

max length 4096

Response57 fields

statusstring

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

timelinearrayitems

53 fields

Reply tweets, newest first. 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.

in_reply_to_screen_namestring

Handle of the user being replied to.

in_reply_to_status_id_strstring

Tweet id of the post being replied to.

in_reply_to_user_id_strstring

User id of the account being replied to.

next_cursorstring

Cursor for the next replies page, when available.

prev_cursorstring

Cursor for the previous replies page, when available.

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

Example request

Python

import requests

url = "https://api.vee3.io/v1/x-twitter/tweet-replies"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "url": "https://example.com"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200First page of latest replies for a tweet.

latest_replies_page.json

{
  "status": "ok",
  "timeline": [
    {
      "type": "tweet",
      "tweet_id": "1929304754812776882",
      "screen_name": "AnilaMathew",
      "text": "@elonmusk Wow",
      "created_at": "Sun Jun 01 22:31:12 +0000 2025",
      "favorites": 0,
      "retweets": 0,
      "replies": 0,
      "views": "9",
      "in_reply_to_screen_name": "elonmusk",
      "in_reply_to_status_id_str": "1738106896777699464",
      "user_info": {
        "screen_name": "AnilaMathew",
        "name": "Anila Mathew",
        "rest_id": "65072209"
      }
    }
  ],
  "next_cursor": "DAADDAABCgABGsZEc94WcbIKAAIYkoasmBtgFAAIAAIAAAACCAADAAAAAAgABAAAAAAKAAUcl9YPI4AnEAoABhyX1g8jf9jwAAA",
  "prev_cursor": "DAADDAABCgABGsZEc94WcbIKAAIYkoasmBtgFAAIAAIAAAABCAADAAAAAAgABAAAAAAKAAUcl9YPI4AnEAoABhyX1g8jf9jwAAA"
}

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

Example request

Python

import requests

url = "https://api.vee3.io/v1/x-twitter/user-timeline"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "url": "https://example.com"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200First page of posts for a user by screen name.

elonmusk_timeline.json

{
  "status": "ok",
  "pinned": {
    "tweet_id": "1858318917141197107",
    "text": "There are so many regulators that it's like a sports game...",
    "favorites": 26948,
    "retweets": 4982,
    "author": {
      "rest_id": "44196397",
      "screen_name": "elonmusk",
      "name": "Elon Musk"
    }
  },
  "timeline": [
    {
      "tweet_id": "1858398528214630863",
      "text": "RT @DefiyantlyFree: Pete Hegseth on the corruption...",
      "created_at": "Mon Nov 18 06:35:11 +0000 2024",
      "favorites": 0,
      "retweets": 1666,
      "author": {
        "rest_id": "44196397",
        "screen_name": "elonmusk",
        "name": "Elon Musk"
      }
    }
  ],
  "next_cursor": "DAABCgABGcqaFgd__-gKAAIZyhbkCxZRqQgAAwAAAAIAAA",
  "prev_cursor": "DAABCgABGcqaFgeAJxEKAAIZyludfVeBzwgAAwAAAAEAAA",
  "user": {
    "status": "active",
    "profile": "elonmusk",
    "rest_id": "44196397",
    "name": "Elon Musk",
    "sub_count": 205113140
  }
}

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

Example request

Python

import requests

url = "https://api.vee3.io/v1/x-twitter/search"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "url": "https://example.com"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Top-ranked search for cybertruck.

cybertruck_top.json

{
  "status": "ok",
  "timeline": [
    {
      "type": "tweet",
      "tweet_id": "2034279679738192280",
      "screen_name": "SawyerMerritt",
      "text": "UPDATE: Elon Musk says the driver of this Cybertruck...",
      "created_at": "Wed Mar 18 14:44:05 +0000 2026",
      "favorites": 4887,
      "retweets": 471,
      "replies": 315,
      "views": "491222"
    }
  ],
  "next_cursor": "DAACCgACHJbJZG6AJxAKAAMclslkbn_Y8AgABAAAAAILAAUAAAFc...",
  "prev_cursor": "DAACCgACHJbJZG6AJxAKAAMclslkbn_Y8AgABAAAAAELAAUAAAFc..."
}