X / Twitter

X (Twitter) API for agents: search and read posts, users, timelines, and bookmarks; publish, edit, reply, delete, repost, and bookmark via connected accounts.

GET/v1/x-twitter/connected-accounts

https://api.vee3.io/v1/x-twitter/connected-accounts

0 tokens

List active X accounts connected to the authenticated Vee3 account.

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

Parameters0 fields

Response6 fields

accountsarrayitems

5 fields

Active connected X accounts for the authenticated Vee3 account.

user_idstring

Numeric X user id to pass as user_id on write calls.

user_namestring

X handle without the leading @ to pass as user_name on write calls.

display_namestring

Display name shown on the profile.

avatar_urlstring

Profile avatar image URL.

is_defaultboolean

Whether this account is used when user_id and user_name are omitted on write calls.

HTTP errors: unauthorized, payment_required

Example request

Python

import requests

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

}

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

Example responses2 examples

200No X accounts connected yet.

no_connected_accounts.json

{
  "accounts": []
}

200Two connected X accounts with one marked default.

two_connected_accounts.json

{
  "accounts": [
    {
      "user_id": "12345",
      "user_name": "vee3io",
      "display_name": "Vee3",
      "avatar_url": "https://pbs.twimg.com/profile_images/example_normal.jpg",
      "is_default": true
    },
    {
      "user_id": "67890",
      "user_name": "vee3dev",
      "display_name": "Vee3 Dev",
      "avatar_url": null,
      "is_default": false
    }
  ]
}

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

Example request

Python

import requests

url = "https://api.vee3.io/v1/x-twitter/search"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "query": "cybertruck",
    "search_type": "Top"
}

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..."
}

GET/v1/x-twitter/tweet-info

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

2 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

x-twitter.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 = {
    "id": "1671370010743263233"
}

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/tweet-replies

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

4 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

x-twitter.tweet_replies

Parameters2 fields

idstringRequired

Numeric tweet id.

max length 32

cursorstringOptional

Pagination cursor from a previous response next_cursor field.

max length 4096

Response60 fields

statusstring

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

timelinearrayitems

56 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_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.

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 = {
    "id": "1738106896777699464"
}

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-info

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

2 tokens

Look up an X (Twitter) user profile by handle 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

x-twitter.user_info

Parameters2 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

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_strstring[]

Pinned tweet ids for the profile when present.

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_accountobject

4 fields

Business account metadata when present (object with counts or empty array from the provider when not applicable).

affiliates_countinteger

Number of affiliate accounts when provided.

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 = {
    "user_name": "elonmusk"
}

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/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

Example request

Python

import requests

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

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/bookmarks

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

25 tokens

Fetch bookmarked posts for a connected X account.

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

Parameters4 fields

user_idstringOptional

Numeric X user id from x-twitter.connected_accounts. Pass user_id or user_name to target a specific account, not both. Omit both to use the default account.

user_namestringOptional

X handle from x-twitter.connected_accounts, with or without a leading @. Pass user_id or user_name to target a specific account, not both. Omit both to use the default account.

limitintegerOptional

Maximum number of bookmarks to return (default 20, max 100).

Default: 20 · min 1, max 100

cursorstringOptional

Pagination cursor from a previous response next_cursor field.

max length 4096

Response12 fields

dataarrayitems

4 fields

Bookmarked posts returned by the X API.

idstring

Numeric post id.

author_idstring

Numeric author user id.

textstring

Post text.

created_atstring

Post creation timestamp.

includesobject

4 fields

Expanded users, media, polls, places, and referenced posts.

usersarrayitems

3 fields

Expanded user objects.

idstring

Numeric user id.

usernamestring

X handle.

verifiedboolean

Whether the user is verified.

result_countinteger

Number of bookmarks in this page.

next_cursorstring

Cursor for the next page of bookmarks, when available.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, x_connection_required, x_connection_not_found, x_connection_refresh_failed, x_connection_scopes_insufficient, x_twitter_write_unauthorized, x_twitter_write_rate_limited, x_twitter_write_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/x-twitter/bookmarks"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "limit": 20
}

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

Example responses1 example

200First page of bookmarked posts.

bookmarks_page.json

{
  "data": [
    {
      "id": "1346889436626259968",
      "author_id": "2244994945",
      "text": "Example bookmarked post",
      "created_at": "Wed Jan 06 18:40:40 +0000 2021"
    }
  ],
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "username": "XDevelopers",
        "verified": true
      }
    ]
  },
  "result_count": 1,
  "next_cursor": "next-page-token"
}

POST/v1/x-twitter/posts

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

60 tokens

Publish a post to a connected X account. Token pricing: 60 tokens base for text posts. Posts whose text includes a URL are billed 1000 tokens base instead. Attaching only media (an image or video) without a URL in the text does not trigger the URL rate. Each attached image adds 50 tokens. Each attached video adds 150 tokens plus 50 tokens per 5 MB of video size.

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

Parameters14 fields

user_idstringOptional

Numeric X user id from x-twitter.connected_accounts. Pass user_id or user_name to target a specific account, not both. Omit both to use the default account.

user_namestringOptional

X handle from x-twitter.connected_accounts, with or without a leading @. Pass user_id or user_name to target a specific account, not both. Omit both to use the default account.

textstringOptional

Post text content. At least one of text, poll, media, or card_uri is required.

max length 25000

pollobjectOptional

Poll object with `options` (array of 2-4 strings, each up to 25 characters) and `duration_minutes` (integer from 5 to 10080). Optional `reply_settings` uses the same values as the top-level reply_settings field. Mutually exclusive with media and card_uri.

mediaarrayOptional

File names from files.list_uploaded_files to attach (up to 4). Upload with files.upload_file and @vee3/upload first, then list_uploaded_files to get the stored file_name values.

min 1, max 4

reply_settings"following" | "mentionedUsers" | "subscribers" | "verified"Optional

Who can reply to the post.

paid_partnershipbooleanOptional

Whether the post is a paid partnership.

made_with_aibooleanOptional

Whether the post contains AI-generated media.

for_super_followers_onlybooleanOptional

Whether the post is exclusive to super followers.

Default: false

nullcastbooleanOptional

Whether the post is promoted-only and hidden from the public timeline.

Default: false

card_uristringOptional

Card URI for the post. Mutually exclusive with poll and media.

community_idstringOptional

Community id when posting to an X community.

direct_message_deep_linkstringOptional

Deep link that moves the conversation into Direct Messages.

share_with_followersbooleanOptional

Whether to share a community post with followers too.

Default: false

Response4 fields

tweet_idstring

Numeric id of the created or edited post.

textstring

Post text returned by the X API.

user_idstring

Numeric X user id of the connected account that published the post.

user_namestring

X handle of the connected account that published the post.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, uploaded_file_not_found, uploaded_file_not_supported_for_x_media, x_connection_required, x_connection_not_found, x_connection_refresh_failed, x_twitter_write_unauthorized, x_twitter_write_rate_limited, x_twitter_write_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/x-twitter/posts"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "text": "Hello from Vee3"
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

201Successful post creation response.

created_post.json

{
  "tweet_id": "2059299542277697565",
  "text": "Hello from Vee3",
  "user_id": "12345",
  "user_name": "vee3io"
}

POST/v1/x-twitter/posts/reply

https://api.vee3.io/v1/x-twitter/posts/reply

60 tokens

Reply to a post from a connected X account.

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

Parameters17 fields

user_idstringOptional

Numeric X user id from x-twitter.connected_accounts. Pass user_id or user_name to target a specific account, not both. Omit both to use the default account.

user_namestringOptional

X handle from x-twitter.connected_accounts, with or without a leading @. Pass user_id or user_name to target a specific account, not both. Omit both to use the default account.

reply_to_post_idstringRequired

Numeric id of the post to reply to.

auto_populate_reply_metadatabooleanOptional

Whether to automatically populate reply metadata.

Default: true

exclude_reply_user_idsarrayOptional

User ids to exclude from the reply mention list.

textstringOptional

Reply text content. At least one of text, poll, media, or card_uri is required.

max length 25000

pollobjectOptional

Poll object with options (2-4 strings) and duration_minutes (5-10080). Mutually exclusive with media and card_uri.

mediaarrayOptional

File names from files.list_uploaded_files to attach (up to 4).

min 1, max 4

reply_settings"following" | "mentionedUsers" | "subscribers" | "verified"Optional

Who can reply to the post.

paid_partnershipbooleanOptional

Whether the post is a paid partnership.

made_with_aibooleanOptional

Whether the post contains AI-generated media.

for_super_followers_onlybooleanOptional

Whether the post is exclusive to super followers.

Default: false

nullcastbooleanOptional

Whether the post is promoted-only and hidden from the public timeline.

Default: false

card_uristringOptional

Card URI for the post. Mutually exclusive with poll and media.

community_idstringOptional

Community id when posting to an X community.

direct_message_deep_linkstringOptional

Deep link that moves the conversation into Direct Messages.

share_with_followersbooleanOptional

Whether to share a community post with followers too.

Default: false

Response4 fields

post_idstring

Numeric id of the reply post.

textstring

Reply text returned by the X API.

user_idstring

Numeric X user id of the connected account.

user_namestring

X handle of the connected account.

Example request

Python

import requests

url = "https://api.vee3.io/v1/x-twitter/posts/reply"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "reply_to_post_id": "1346889436626259968",
    "text": "Great post!"
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

201Successful reply.

reply_created.json

{
  "post_id": "1346889436626259969",
  "text": "Great post!",
  "user_id": "2244994945",
  "user_name": "XDevelopers"
}

POST/v1/x-twitter/posts/edit

https://api.vee3.io/v1/x-twitter/posts/edit

60 tokens

Edit a recent post from a connected X account.

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

Parameters7 fields

user_idstringOptional

Numeric X user id from x-twitter.connected_accounts. Pass user_id or user_name to target a specific account, not both. Omit both to use the default account.

user_namestringOptional

X handle from x-twitter.connected_accounts, with or without a leading @. Pass user_id or user_name to target a specific account, not both. Omit both to use the default account.

post_idstringRequired

Numeric id of the post to edit.

textstringOptional

Updated post text.

max length 25000

mediaarrayOptional

File names from files.list_uploaded_files to attach (up to 4). Upload with files.upload_file first.

min 1, max 4

paid_partnershipbooleanOptional

Whether the post is a paid partnership.

made_with_aibooleanOptional

Whether the post contains AI-generated media.

Response4 fields

post_idstring

Numeric id of the edited post returned by the X API.

textstring

Post text returned by the X API.

user_idstring

Numeric X user id of the connected account.

user_namestring

X handle of the connected account.

Example request

Python

import requests

url = "https://api.vee3.io/v1/x-twitter/posts/edit"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "post_id": "1346889436626259968",
    "text": "Updated post text"
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

201Successful post edit.

edited_post.json

{
  "post_id": "1346889436626259969",
  "text": "Updated post text",
  "user_id": "2244994945",
  "user_name": "XDevelopers"
}

DELETE/v1/x-twitter/posts/{post_id}

https://api.vee3.io/v1/x-twitter/posts/{post_id}

25 tokens

Delete a post from a connected X account.

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

Parameters3 fields

user_idstringOptional

Numeric X user id from x-twitter.connected_accounts. Pass user_id or user_name to target a specific account, not both. Omit both to use the default account.

user_namestringOptional

X handle from x-twitter.connected_accounts, with or without a leading @. Pass user_id or user_name to target a specific account, not both. Omit both to use the default account.

post_idstringRequired

Numeric id of the post to delete.

Response3 fields

deletedboolean

Whether the post was deleted.

user_idstring

Numeric X user id of the connected account.

user_namestring

X handle of the connected account.

Example request

Python

import requests

url = "https://api.vee3.io/v1/x-twitter/posts/{post_id}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
payload = {
    "post_id": "1346889436626259968"
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Successful post deletion.

post_deleted.json

{
  "deleted": true,
  "user_id": "2244994945",
  "user_name": "XDevelopers"
}

POST/v1/x-twitter/reposts

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

75 tokens

Repost a post for a connected X account.

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

Parameters3 fields

user_idstringOptional

Numeric X user id from x-twitter.connected_accounts. Pass user_id or user_name to target a specific account, not both. Omit both to use the default account.

user_namestringOptional

X handle from x-twitter.connected_accounts, with or without a leading @. Pass user_id or user_name to target a specific account, not both. Omit both to use the default account.

post_idstringRequired

Numeric id of the post to repost.

Response4 fields

post_idstring

Numeric id of the reposted post.

retweetedboolean

Whether the post was reposted.

user_idstring

Numeric X user id of the connected account.

user_namestring

X handle of the connected account.

Example request

Python

import requests

url = "https://api.vee3.io/v1/x-twitter/reposts"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "post_id": "1346889436626259968"
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Successful repost.

reposted.json

{
  "post_id": "1346889436626259968",
  "retweeted": true,
  "user_id": "2244994945",
  "user_name": "XDevelopers"
}

DELETE/v1/x-twitter/reposts/{post_id}

https://api.vee3.io/v1/x-twitter/reposts/{post_id}

50 tokens

Remove a repost for a connected X account.

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

Parameters3 fields

user_idstringOptional

Numeric X user id from x-twitter.connected_accounts. Pass user_id or user_name to target a specific account, not both. Omit both to use the default account.

user_namestringOptional

X handle from x-twitter.connected_accounts, with or without a leading @. Pass user_id or user_name to target a specific account, not both. Omit both to use the default account.

post_idstringRequired

Numeric id of the original post to unrepost.

Response3 fields

retweetedboolean

Whether the post is still reposted after this request.

user_idstring

Numeric X user id of the connected account.

user_namestring

X handle of the connected account.

Example request

Python

import requests

url = "https://api.vee3.io/v1/x-twitter/reposts/{post_id}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
payload = {
    "post_id": "1346889436626259968"
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Successful unrepost.

unreposted.json

{
  "retweeted": false,
  "user_id": "2244994945",
  "user_name": "XDevelopers"
}

POST/v1/x-twitter/bookmarks

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

30 tokens

Bookmark a post for a connected X account.

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

Parameters3 fields

user_idstringOptional

Numeric X user id from x-twitter.connected_accounts. Pass user_id or user_name to target a specific account, not both. Omit both to use the default account.

user_namestringOptional

X handle from x-twitter.connected_accounts, with or without a leading @. Pass user_id or user_name to target a specific account, not both. Omit both to use the default account.

post_idstringRequired

Numeric id of the post to bookmark.

Response3 fields

bookmarkedboolean

Whether the post is bookmarked after this request.

user_idstring

Numeric X user id of the connected account.

user_namestring

X handle of the connected account.

Example request

Python

import requests

url = "https://api.vee3.io/v1/x-twitter/bookmarks"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "post_id": "1346889436626259968"
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Successful bookmark creation.

bookmarked.json

{
  "bookmarked": true,
  "user_id": "2244994945",
  "user_name": "XDevelopers"
}

DELETE/v1/x-twitter/bookmarks/{post_id}

https://api.vee3.io/v1/x-twitter/bookmarks/{post_id}

30 tokens

Remove a bookmark for a connected X account.

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

Parameters3 fields

user_idstringOptional

Numeric X user id from x-twitter.connected_accounts. Pass user_id or user_name to target a specific account, not both. Omit both to use the default account.

user_namestringOptional

X handle from x-twitter.connected_accounts, with or without a leading @. Pass user_id or user_name to target a specific account, not both. Omit both to use the default account.

post_idstringRequired

Numeric id of the bookmarked post to remove.

Response3 fields

bookmarkedboolean

Whether the post is bookmarked after this request.

user_idstring

Numeric X user id of the connected account.

user_namestring

X handle of the connected account.

Example request

Python

import requests

url = "https://api.vee3.io/v1/x-twitter/bookmarks/{post_id}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
payload = {
    "post_id": "1346889436626259968"
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Successful bookmark removal.

bookmark_removed.json

{
  "bookmarked": false,
  "user_id": "2244994945",
  "user_name": "XDevelopers"
}