Twitter / X

pepe.business is an official X partner. You get the X APIs without creating your own developer app.

Connection

POST /v1/connect/twitter
{ "scopes": ["tweet.read", "tweet.write", "users.read", "dm.read", "dm.write"] }

Publishing

Simple text post

POST /v1/posts
{
  "text": "Hello Twitter!",
  "platforms": ["twitter"]
}

Post with image

POST /v1/posts
{
  "text": "New product",
  "platforms": ["twitter"],
  "mediaUrls": ["https://shop.com/product.jpg"]
}

Limits: 4 images max, 5 MB per image, JPG/PNG/WebP formats.

Thread

POST /v1/posts
{
  "platforms": ["twitter"],
  "thread": [
    { "text": "1/ Thread about our new product" },
    { "text": "2/ Here are the main features" },
    { "text": "3/ Available today" }
  ]
}

Specific characteristics

DMs

POST /v1/messages
{
  "platform": "twitter",
  "to": "user_id_or_handle",
  "text": "Hello!"
}

Engagement

# Bookmark a tweet
POST /v1/twitter/bookmark { "tweetId": "xxx" }

# Retweet
POST /v1/twitter/retweet { "tweetId": "xxx" }

# Vote in a poll
POST /v1/twitter/vote { "pollId": "xxx", "choice": 1 }

Analytics

GET /v1/analytics/post/{postId}?platform=twitter

{
  "impressions": 4521,
  "likes": 142,
  "retweets": 38,
  "replies": 12,
  "bookmarks": 9,
  "profileClicks": 4,
  "urlClicks": 87,
  "engagementRate": 0.043
}

Pricing pass-through

The X API has a variable cost, which we pass through at cost:

Other platforms have no surcharge.

X rate limits

• 300 posts / 3h per account
• 50 DMs / 24h per account
• pepe.business manages a queue if you exceed