Platforms Overview

Supported Platforms

PostPeer lets you publish to all major social platforms through a single API. Connect an account via OAuth, then use the same /v1/posts endpoint regardless of platform.

Platform	Status	Content Types
Twitter/X	Live	Text, images, videos, GIFs, threads, polls
Instagram	Live	Images, videos, reels, carousels
YouTube	Live	Videos, Shorts
TikTok	Coming soon	Videos
Facebook	Coming soon	Text, images, videos, links
Threads	Coming soon	Text, images, videos
Pinterest	Coming soon	Pins with images

How It Works

Every platform follows the same pattern:

1. Connect an Account

curl https://api.postpeer.dev/v1/connect/{platform} \
  -H "x-access-key: YOUR_API_KEY"

This returns an OAuth URL. Redirect the user to authorize, and the account is connected to your project.

2. Get the Account ID

curl https://api.postpeer.dev/v1/connect/integrations \
  -H "x-access-key: YOUR_API_KEY"

Use the id from the response as the accountId when posting.

3. Publish

curl -X POST "https://api.postpeer.dev/v1/posts" \
  -H "x-access-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from PostPeer!",
    "platforms": [
      { "platform": "twitter", "accountId": "abc123" }
    ],
    "publishNow": true
  }'

Platform-Specific Options

Each platform supports a platformSpecificData object for platform-specific settings like YouTube titles, Twitter polls, or Pinterest board targeting. See the individual platform pages for details.

Cross-Posting

Post to multiple platforms in a single request by adding entries to the platforms array:

curl -X POST "https://api.postpeer.dev/v1/posts" \
  -H "x-access-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Shipping something new today!",
    "platforms": [
      { "platform": "twitter", "accountId": "tw_123" },
      { "platform": "instagram", "accountId": "ig_456" },
      { "platform": "youtube", "accountId": "yt_789", "platformSpecificData": { "title": "New Launch", "visibility": "public" } }
    ],
    "mediaItems": [
      { "type": "video", "url": "https://cdn.example.com/video.mp4" }
    ],
    "publishNow": true
  }'

Each platform is published independently. If one fails, the others still succeed (you'll get a 207 partial success response).