Twitter/X API Integration - Posting & Media Limits

The platform formerly known as Twitter. The API changes have been… eventful. Let’s focus on what works.

Billing

Twitter/X is moving to a usage-based billing model. X charges for API access to post, and we pass that cost through to you 1:1 - at cost, with no markup. You pay exactly what X charges us per tweet, nothing more.

We don’t add any margin on top of X’s API pricing. Every tweet published through bundle.social is billed to your account at the same price X bills us. This is separate from your bundle.social plan.

Supported Content Types

Tweets: Text with optional media. 0-4 files.
Images and videos can be mixed in the same tweet.

Quirks & Gotchas

Media Limits

Max 4 images per tweet.
Max 4 videos per tweet (though realistically, 1 is most common).
Video max size: 512 MB.

Text & Subscription-Based Limits

Twitter/X limits vary based on the account’s subscription tier:

Tier	Text Limit	Video Duration
Free	280 chars	140s (2:20)
Basic	280 chars	140s (2:20)
Premium	25,000 chars	600s (10 min)
Premium+	25,000 chars	600s (10 min)

See Platform Limits for the full breakdown.

Post Options

Send X-specific options inside data.TWITTER.

Field	Type	Description
`text`	`string`	Tweet text. Character limit depends on the account subscription tier.
`uploadIds`	`string[]`	Up to 4 uploaded media files. Images and videos can be mixed.
`replySettings`	`enum`	Controls who can reply. See the values below.

{
  "teamId": "team_123",
  "title": "X announcement",
  "status": "SCHEDULED",
  "postDate": "2026-06-01T15:00:00.000Z",
  "socialAccountTypes": ["TWITTER"],
  "data": {
    "TWITTER": {
      "text": "Launching today",
      "uploadIds": ["upload_image_123"],
      "replySettings": "MENTIONED_USERS"
    }
  }
}

Reply Settings

You can control who’s allowed to reply to your tweets. Set replySettings in the data.TWITTER object when creating a post.

Value	Who can reply
`EVERYONE`	Anyone (default)
`FOLLOWING`	Only people you follow
`MENTIONED_USERS`	Only users mentioned in the tweet
`SUBSCRIBERS`	Subscribers only
`VERIFIED`	Verified accounts only

If you don’t set replySettings or set it to EVERYONE, we don’t send the parameter to Twitter at all - which is Twitter’s default behavior.

{
  "data": {
    "TWITTER": {
      "text": "Hot take incoming",
      "replySettings": "MENTIONED_USERS"
    }
  }
}

Reply settings depend on your Twitter/X account tier. Some options (like SUBSCRIBERS) only make sense if your account actually has subscribers. Twitter won’t error out if you use them anyway - it just won’t do much.

Analytics

We’ll be honest here.

Profile Analytics

Status: Not available. Won’t be.

Post Analytics

Status: Not available. Won’t be.

Why? The X API changes have made analytics access extremely expensive and restrictive. The cost-to-value ratio doesn’t make sense for anyone involved. We know, it sucks. If this changes in the future, we’ll add support. But don’t hold your breath.

API Documentation

Platforms

Guides

Endpoints

Twitter / X

Billing

Supported Content Types

Quirks & Gotchas

Media Limits

Text & Subscription-Based Limits

Post Options

Reply Settings

Analytics

Profile Analytics

Post Analytics

​Billing

​Supported Content Types

​Quirks & Gotchas

​Media Limits

​Text & Subscription-Based Limits

​Post Options

​Reply Settings

​Analytics

​Profile Analytics

​Post Analytics

Billing

Supported Content Types

Quirks & Gotchas

Media Limits

Text & Subscription-Based Limits

Post Options

Reply Settings

Analytics

Profile Analytics

Post Analytics