Social Media Posting API
for Developers
Publish, schedule, reply, and measure across every major network with one integration.
import { Configuration, PostsApi } from "@onepostly/sdk";
const posts = new PostsApi(
new Configuration({ accessToken: process.env.ONEPOSTLY_API_KEY }),
);
await posts.createPost({
createPostBody: {
text: "Ship once. Post everywhere.",
media: [{ url: "https://cdn.example.com/launch.png" }],
accounts: [{ accountId: "acc_x_123" }, { accountId: "acc_ig_456" }],
},
});import os
from onepostly import ApiClient, Configuration
from onepostly.api.posts_api import PostsApi
posts = PostsApi(ApiClient(
Configuration(access_token=os.environ["ONEPOSTLY_API_KEY"]),
))
await posts.create_post(create_post_body={
"text": "Ship once. Post everywhere.",
"media": [{"url": "https://cdn.example.com/launch.png"}],
"accounts": [{"accountId": "acc_x_123"}, {"accountId": "acc_ig_456"}],
})curl -X POST https://api.onepostly.com/v1/posts \
-H "Authorization: Bearer op_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"text": "Ship once. Post everywhere.",
"media": [{ "url": "https://cdn.example.com/launch.png" }],
"accounts": [
{ "accountId": "acc_x_123" },
{ "accountId": "acc_ig_456" }
]
}'
One Request, Every Platform
Send the same payload to X, Instagram, TikTok, and six more networks.
Publish Everywhere with one payload
Schedule Ahead in any timezone
Measure Every Post in one normalized shape
Reach every network from a single API.
Create a key, connect your accounts, publish everywhere with one request, and see how every post performs.
Create a key with the permissions and profile access you need, then connect the accounts it publishes to.
API Keys (8)
TikTokAll set, your post to X, LinkedIn, and Instagram is scheduled for 9 AM tomorrow.
Connected Onepostly MCPBuilt for Your Agent
Onepostly ships as an MCP server. Your agent publishes to every platform.
Unified Analytics
One request pulls engagement data from every network your accounts publish to.
Webhooks & Events
Publish, fail, comment, or DM. Every event hits your endpoint the moment it happens.
Your account list grows.
Your integration doesn't.
Run 2,000+ connected accounts across your workspaces without losing track of who did what.
Frequently Asked Questions
Platforms, auth, billing, and what you can ship in one integration.
Have more questions? Reach out to us
A social media API lets you publish, schedule, manage engagement, and read analytics across platforms through one integration, with OAuth, media rules, and delivery handled for you.
Analytics refresh about hourly while a post is new, then about weekly once it is a month old. Every response carries fetchedAt, so your integration knows how current a number is.
X, Instagram, Facebook, Threads, LinkedIn, TikTok, YouTube, and Pinterest, all live today. Add accounts by their account IDs without rewriting your product integration.
Create an API key in the dashboard and send it as a Bearer token in the Authorization header. Connect social accounts via OAuth once, then reference each account by its account 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 analytics with GET /v1/posts/{id}/analytics for likes, impressions, and related metrics.
Your first 2 connected accounts are free with every feature included. After that each account is billed by the day, never ahead of use, at a monthly rate that drops as you connect more. X usage bills from a prepaid wallet.
Yes. The OAuth screens your users see carry neutral names like Social Media Connector rather than our brand, so the experience reads as fully yours.
Have more questions? Reach out to us