Postproxy × X (Twitter)

Publish tweets to X (Twitter) with automatic format detection. Handle images, videos, and text posts seamlessly.

One API call handles tweets with automatic content format detection.

Tweets

Publish tweets with automatic format detection

Media Support

Add up to 4 images or 1 video per tweet

Thread Support

Create threaded conversations with multiple tweets

Automatic Formatting

Content format determined automatically based on media

POST /v1/posts
Terminal window
curl -X POST "https://api.postproxy.dev/api/posts" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "post": {
         "body": "Just shipped a new feature! Check it out 🎉"
       },
       "profiles": ["twitter"],
       "media": ["https://example.com/image.jpg"],
       "platforms": {
         "twitter": {}
       }
     }'

X (Twitter) Parameters

Formats

Format Description
post Tweet (default)

Media Constraints

Media Type Max Size Formats Max Count Duration
Image 5 MB jpg, png, webp, gif 4 -
Video 512 MB mp4, mov 1 1s - 140s

Notes

  • Text content: Optional
  • Media required: No
  • Mix video and image: No
  • Minimum image dimensions: 4x4 pixels
  • Minimum video dimensions: 32x32 pixels
  • Maximum text length: 280 characters (standard accounts)

View full documentation for all platform-specific features for X (Twitter)

View documentation

Why Postproxy for X (Twitter)?

Skip Twitter API complexity

No need to handle Twitter API v2, OAuth flows, or rate limits. Postproxy handles it all.

Handle rate limits automatically

Twitter rate limits are managed automatically with intelligent retry logic.

Support all formats

Publish tweets with text, images, or videos through one unified API.

Supported formats:
Tweets

Reliable delivery

Automatic retries and clear status reporting ensure your tweets reach X.

Frequently Asked Questions

Common questions about X (Twitter) integration

Are there any platform-specific parameters for Twitter?

No, X (Twitter) does not have custom parameters. Content format is determined automatically based on the media you provide. Postproxy handles all the formatting automatically.

What are the media constraints for Twitter?

Twitter supports images (jpg, png, webp, gif) up to 5 MB with a maximum of 4 images per tweet, and videos (mp4, mov) up to 512 MB with a duration between 1 second and 140 seconds.

What is the maximum text length for tweets?

Standard accounts have a 280 character limit for tweet text. Postproxy will automatically validate this limit before publishing.

Can I post text-only tweets?

Yes! Twitter fully supports text-only posts. Simply omit the media array from your post request.

Can I mix videos and images in a single tweet?

No, Twitter does not allow mixing videos and images in a single tweet. You can post up to 4 images or 1 video per tweet.

Ready to get started?

Start with our free plan and scale as your needs grow. No credit card required.

Get startedView documentation