Create Post Quote

POST/tw-v2/interaction/create-post-quote

Description

Quote tweet another tweet with your own commentary. Supports text content up to 280 characters for non-premium users, or 25,000 characters for premium users.

Request Body

Parameter	Type	Required	Description
authToken	string	required	Account authentication token (auth_token cookie value)
text	string	required	The text content of the quote tweet (max 280 characters for non-premium, 25,000 for premium)
attachmentUrl	string	required	The URL of the tweet to quote (e.g. https://x.com/sample_user_00001/status/2001844185)
proxy	string	required	Proxy in format 'hostname:port@username:password' (required for better success rates)
disableLinkPreview	boolean	optional	When true, disables link preview cards for tweets containing URLs (defaults to false)
replyOption	object	optional	Optional reply controls. Use mode: everyone, accounts_you_follow, accounts_you_follow_and_followed, mentioned_accounts, verified_accounts, or regions.

Reply Options

Use replyOption to control who can reply to the quote post.

everyone: everyone can reply, same as omitting replyOption
accounts_you_follow: only accounts you follow can reply
accounts_you_follow_and_followed: accounts you follow and accounts they follow can reply
mentioned_accounts: only accounts mentioned in the post can reply
verified_accounts: only verified accounts can reply
regions: only accounts from selected region buckets can reply

For regions, include a regions array with one or more of: NAM, EAS, AFR, SEA, SAM, EUR, AUS, SAS, WES, CAS.

Code Examples

const body = {
  authToken: 'YOUR_AUTH_TOKEN',
  text: 'Hello, world!',
  attachmentUrl: 'https://x.com/sample_user_00001/status/2001844185',
  replyOption: {
    mode: 'regions',
    regions: ['NAM', 'EUR']
  }
};

const response = await fetch('https://api.tweetapi.com/tw-v2/interaction/create-post-quote', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(body)
});

const data = await response.json();
console.log(data);

Response

Success Response (200 OK)

200

{
  "data": {
    "id": "9001288055053903767",
    "action": "quote",
    "timestamp": "2025-10-02T09:20:50.518Z",
    "success": true,
    "metadata": {
      "tweet_id": "2001474930414781173",
      "author_username": "username",
      "text": "Sample post text 45195 for documentation.",
      "created_at": "Thu Oct 02 09:20:50 +0000 2025",
      "url": "https://example.com/link-94089/profile-41921/username/status/2001142853007295265",
      "quoted_tweet_id": "2009346755595729340",
      "quoted_tweet_url": "https://x.com/sample_user_19356/status/2001278467352366598"
    }
  }
}