Reply Community Post With Media

POST/tw-v2/interaction/reply-community-post-with-media

Description

Reply to an existing tweet within a Twitter/X community with media attachments. Creates a reply in the conversation thread with community context and up to 4 images or 1 video. 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	Twitter authentication token (auth_token cookie value)
text	string	required	The text content of the reply (max 280 characters for non-premium, 25,000 for premium)
tweetId	string	required	The ID of the tweet to reply to (numeric only)
communityId	string	required	The ID of the community to post to (numeric only)
media	array	required	Array of media URLs to attach to the reply
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)

Code Examples

const body = {
  authToken: 'YOUR_AUTH_TOKEN',
  text: 'Check out this screenshot!',
  tweetId: '1234567890',
  communityId: '9876543210',
  media: [{"url":"https://example.com/image.jpg"}],
  proxy: 'proxy.example.com:8080@user:pass'
};

const response = await fetch('https://api.tweetapi.com/tw-v2/interaction/reply-community-post-with-media', {
  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 (201 Created)

201

{
  "data": {
    "id": "1879453298220294144",
    "action": "reply_community_post",
    "timestamp": "2025-10-05T14:37:05.823Z",
    "success": true,
    "metadata": {
      "tweet_id": "1879453298220294144",
      "author_username": "username",
      "text": "Check out this screenshot!",
      "created_at": "Sun Oct 05 14:37:05 +0000 2025",
      "url": "https://twitter.com/username/status/1879453298220294144",
      "in_reply_to_tweet_id": "1879340125983047680",
      "in_reply_to_username": "original_author"
    }
  }
}

Error Responses

Status Code	Description
400	Bad Request - Invalid parameters, community ID, or media (1-4 items required)
401	Unauthorized - Invalid or missing API key
403	Forbidden - Account not authorized to post in this community
404	Not Found - Tweet or community doesn't exist
429	Too Many Requests - Rate limit exceeded
500	Internal Server Error - Server error

Notes

Community ID must be numeric only
Supports up to 4 images or 1 video per reply
Media can be provided as a URL or base64-encoded data with MIME type
All timestamps are in ISO 8601 format
IDs are Twitter snowflake IDs (strings)
Tweets longer than 280 characters automatically use premium note tweet format