Twitter / X API

Twitter / X Posting API

Publish tweets, threads, polls, and media to Twitter/X programmatically. PostPeer handles OAuth, token refreshes, and rate limits so you can focus on building.

  • Tweets, threads, and polls via one endpoint
  • Image, video, and GIF uploads
  • OAuth handled — no Twitter developer app needed
  • Real-time webhooks for post status
No credit card required.
POST https://api.postpeer.dev/v1/posts
{ "platforms": ["twitter", "linkedin"], "content": "Hello world!" }
Published
5 platforms
TwitterLinkedInFacebook+2
All posts delivered
Scheduled
queue
12
Queued
847
Sent
Next: in 15 min
Platforms
connected
XIGFBLITT
One API, every platform

How It Works

Add social media to your product in three steps.

01

Get Your API Key

Sign up and get your API key instantly — no sales calls, no complex onboarding.

02

Integrate in Minutes

A single endpoint to post, schedule, and manage content. Drop it into your product and go.

03

Your Users Post Everywhere

Your product now supports every major social platform — without you maintaining a single integration.

API Response Format

Clean, structured JSON that's easy to parse and integrate

Request

POST
curl -X POST https://api.postpeer.dev/v1/posts \
  -H "x-access-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Launching our new feature today! Check it out.",
    "platforms": [
      {
        "platform": "twitter",
        "accountId": "acc_tw_123"
      }
    ]
  }'

Response

JSON
{
  "postId": "post_abc123",
  "status": "published",
  "platforms": [
    {
      "platform": "twitter",
      "status": "published",
      "platformPostId": "1234567890",
      "platformPostUrl": "https://x.com/youruser/status/1234567890"
    }
  ]
}

Everything You Need for Twitter Posting

Skip the Twitter API complexity. PostPeer gives you a simple, unified endpoint for all Twitter publishing needs.

Single Tweets & Threads

Post a single tweet or create multi-tweet threads with a single API request. Each thread item supports text and media.

Rich Media Support

Upload images (up to 4), videos, and GIFs. PostPeer validates media against Twitter's specs before publishing.

Polls

Create Twitter polls with 2-4 options and configurable duration. Just pass poll data in platformSpecificData.

Reply Settings

Control who can reply to your tweets: everyone, followers, mentioned users, or verified accounts.

Scheduled Posting

Schedule tweets for any time with timezone support. PostPeer queues and delivers at the exact moment.

Cross-Post With Other Platforms

Post the same content to Twitter + Instagram + YouTube + more in a single request. Platform-specific formatting handled.

Frequently Asked Questions

Ready to Add Social Media to Your Product?

One API. Every platform. Start building with free credits.

Start Posting for FreeNo credit card required.
POST https://api.postpeer.dev/v1/posts
{ "platforms": ["twitter", "linkedin"], "content": "Hello world!" }
Published
5 platforms
TwitterLinkedInFacebook+2
All posts delivered
Scheduled
queue
12
Queued
847
Sent
Next: in 15 min
Platforms
connected
XIGFBLITT
One API, every platform