Getting Started

Get up and running with the PostPeer API in minutes. Connect a social account and publish your first post.

What is PostPeer?

PostPeer is a unified social media posting API. One integration to publish, schedule, and manage content across Twitter/X, Instagram, YouTube, Facebook, and more.

No OAuth headaches. No platform SDKs. One API, every platform.

Base URL:

https://api.postpeer.dev/v1

Authentication

All requests require your API key in the x-access-key header:

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

Get your API key from the PostPeer Dashboard. You get 20 free credits on signup — no credit card required.

Before publishing, connect a social account via OAuth. For example, to connect Twitter:

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

Response:

{
  "url": "https://twitter.com/i/oauth2/authorize?..."
}

Redirect the user to the url. After they authorize, the account is connected to your project.

Step 2: Get Your Account ID

List your connected accounts to get the accountId needed for posting:

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

Response:

{
  "success": true,
  "integrations": [
    {
      "id": "abc123",
      "platform": "twitter",
      "platformUserId": "123456789",
      "createdAt": "2026-03-28T10:00:00Z"
    }
  ]
}

Step 3: Publish Your First Post

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
  }'

Response:

{
  "success": true,
  "status": "published",
  "postId": "post_xyz789",
  "platforms": [
    {
      "platform": "twitter",
      "success": true,
      "platformPostUrl": "https://twitter.com/you/status/123456"
    }
  ]
}

That's it — one request, your content is live.

Step 4: Schedule a Post (Optional)

Want to post later? Add scheduledFor and timezone:

curl -X POST "https://api.postpeer.dev/v1/posts" \
  -H "x-access-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "This goes live tomorrow morning!",
    "platforms": [
      { "platform": "twitter", "accountId": "abc123" }
    ],
    "scheduledFor": "2026-03-29T09:00:00",
    "timezone": "America/New_York"
  }'

Supported Platforms

PostPeer supports publishing to all major social platforms:

Platform	Status	Features
Twitter/X	Live	Posts, threads, polls, images, videos, GIFs
Instagram	Live	Image posts with captions
YouTube	Live	Video uploads, Shorts, metadata
Facebook	Coming soon	Posts, images, videos
TikTok	Coming soon	Video uploads
Threads	Coming soon	Text posts
Pinterest	Coming soon	Pins with images

Next Steps

Authentication — API keys, credits, and rate limits
Connect Accounts — OAuth flows for each platform
Publishing — Full request/response reference
Scheduling — Schedule, cancel, and reschedule posts

On this page