Social Media API
One REST API to publish, schedule, manage comments, and read insights across X, Instagram, Facebook, Threads, and more.
No credit card required
curl -X POST https://api.onepostly.com/v1/posts \ -H "x-api-key: op_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "text": "Ship once. Post everywhere.", "mediaKind": "image", "mediaUrls": ["https://cdn.example.com/launch.png"], "destinations": [ { "connectionId": "conn_x_123" }, { "connectionId": "conn_ig_456" } ] }'Supported Platforms
Key Features
The surfaces developers need to ship social features in one integration, without wiring each platform SDK yourself.
Unified Multi-Platform API
One JSON payload for all platforms. We normalize media formats, character limits, and content types.
Post Scheduling
Schedule with IANA timezone support. Due posts release automatically when their time arrives.
Images, Videos & Multi-image
Upload images, videos, and multi-image posts. Media rules are validated per destination platform.
Cross-Platform Analytics
Unified engagement metrics across platforms via a single insights endpoint, so you can compare performance without stitching vendor responses.
Simple API Key Auth
Authenticate with x-api-key. Connect accounts once via OAuth, then reference each connection by ID.
Webhooks & Events
Real-time notifications for publish, schedule, and comment events so you do not need to poll.
Multiple Social Accounts
Connect multiple accounts per platform. Each gets a unique connection ID for granular control.
Comments & Engagement
List, reply, and delete comments. Like, repost, bookmark, and quote where the platform supports it.
How it works
Ship your first post in 3 steps
Sign up, connect accounts, and call one endpoint.
Create an API key
Create a workspace, generate an API key from the dashboard, and authenticate every request with x-api-key.
Connect social accounts
Complete OAuth for each destination account. Onepostly stores and refreshes tokens so you only pass connection IDs.
Publish or schedule
Send a single POST /v1/posts payload with destinations. Publish immediately, or schedule with timezone-aware delivery.
Why developers choose Onepostly
Skip months of integration work
One API replaces separate X, Instagram Graph, Facebook Pages, and Threads integrations. Auth, media rules, and rate limits stay behind Onepostly.
Built for production delivery
Publish jobs run through queues with retries and clear per-destination status, so your product can show what published and what failed.
Scales with your workspace
Start on Free, then move to Growth or Scale as you connect more accounts. Your integration stays the same as usage grows.
Great developer experience
REST docs, OpenAPI, and copy-paste examples in cURL and TypeScript. Webhooks replace polling for publish and comment events.
Transparent pricing
Simple plan limits for connected accounts. X actions debit a prepaid wallet at X list prices with no markup.
Platform changes handled for you
When social APIs change, Onepostly updates the adapters. Your code keeps calling the same endpoints.
Cost to ship multi-platform publishing
Building adapters in-house burns engineering time. Calling each native API means separate auth, media rules, and quotas. Onepostly collapses that work into one integration.
| Option | Typical cost | What you get |
|---|---|---|
| Custom integrations | 3–6+ months of eng | You own every OAuth flow, media rule, and rate-limit edge case |
| Native X API | From $100/mo | X only, with platform quotas and write limits |
| Meta Graph API | Free after review | Instagram and Facebook only |
| Onepostly | Free to start | One REST API with unlimited publish, schedule, comments, analytics, and webhooks |
Starter includes 1 connected account and full API access. Growth is $19/mo for up to 15 accounts. X usage bills through a prepaid wallet at X list prices, with no markup.
Code Examples
curl -X POST https://api.onepostly.com/v1/posts \ -H "x-api-key: op_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "text": "Hello from Onepostly", "scheduledFor": "2026-07-16T12:00:00", "timezone": "America/New_York", "destinations": [ { "connectionId": "conn_x_123" }, { "connectionId": "conn_ig_456" } ] }'curl "https://api.onepostly.com/v1/posts/POST_ID/insights" \ -H "x-api-key: op_YOUR_KEY" # Response:# {# "platform": "x",# "metrics": {# "likes": 42,# "shares": 12,# "impressions": 1580# }# }Frequently asked questions
Common questions about the Onepostly social media API, platforms, auth, and what you can ship in one integration.
A social media API lets you publish, schedule, manage engagement, and read insights across platforms through one integration. Onepostly normalizes OAuth, media rules, and delivery behind a single REST surface.
X, Instagram, Facebook, Threads, LinkedIn, TikTok, YouTube, Pinterest, and more coming. Add destinations with connection IDs without rewriting your product integration.
Create an API key in the dashboard and send it as x-api-key. Connect social accounts via OAuth once, then reference each account by connection ID in your posts payload.
Yes. POST /v1/posts publishes immediately, or pass scheduledFor plus an IANA timezone to queue delivery for later.
Yes. List and reply to comments where supported, and pull normalized insights with GET /v1/posts/:id/insights for likes, impressions, and related metrics.
Starter includes connected account access and the full API. Growth and Scale raise account limits as you expand. X usage bills through a prepaid wallet at X list prices.
