Social Media API

Social Media Scheduling API

Schedule content across every major platform with a single API call. Set a time, pick a timezone, and PostPeer delivers your posts at the exact moment.

  • Schedule posts to 8+ platforms with one request
  • Full timezone support — schedule in your users' local time
  • Queue posts for optimal engagement times
  • Modify or cancel scheduled posts before delivery
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": "Exciting announcement coming tomorrow!",
    "mediaItems": [
      { "type": "image", "url": "https://example.com/teaser.png" }
    ],
    "platforms": [
      { "platform": "twitter", "accountId": "acc_tw_123" },
      { "platform": "instagram", "accountId": "acc_ig_456" }
    ],
    "scheduledAt": "2026-04-15T09:00:00",
    "timezone": "America/New_York"
  }'

Response

JSON
{
  "postId": "post_sch_456",
  "status": "scheduled",
  "scheduledFor": "2026-04-15T13:00:00Z",
  "platforms": [
    {
      "platform": "twitter",
      "success": true,
      "status": "scheduled"
    },
    {
      "platform": "instagram",
      "success": true,
      "status": "scheduled"
    }
  ]
}

Schedule Content Across Every Platform

Build scheduling into your product without managing queues, cron jobs, or platform-specific timing logic.

Cross-Platform Scheduling

Schedule the same content to Twitter, Instagram, YouTube, TikTok, Facebook, Pinterest, and Threads in a single API request. Each platform gets the right formatting.

Timezone-Aware Delivery

Pass an IANA timezone (e.g., America/New_York) and PostPeer delivers at exactly the right moment. No UTC conversion headaches.

Rich Media Scheduling

Schedule posts with images, videos, carousels, Reels, Shorts, and Stories. Media is uploaded and validated at schedule time, not delivery time.

Reliable Delivery

PostPeer queues scheduled posts with built-in retry logic. If a platform is temporarily unavailable, the post is retried automatically.

Manage Scheduled Posts

View, modify, or cancel scheduled posts before they're published. Update content, change the time, or remove posts from the queue via API.

Platform-Specific Scheduling

Access native scheduling features — YouTube premiere settings, TikTok privacy controls, Pinterest board targeting — all through the platformSpecificData field.

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