Breakreach API
The social posting API for products and AI agents
One authentication model and one request shape to publish and schedule on 12platforms. Scheduled posts publish server-side โ your app or agent doesn't have to stay online.
Quickstart
- Create a Breakreach account and connect your social accounts.
- Generate an API key in the dashboard under Settings โ API & MCP.
- Call the API with the key as a Bearer token:
# List your connected accounts
curl https://api.breakreach.com/v1/accounts \
-H "Authorization: Bearer br_your_api_key"
# Publish to several platforms at once
curl -X POST https://api.breakreach.com/v1/posts \
-H "Authorization: Bearer br_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"content": "We just shipped v2 ๐",
"accountIds": ["<instagram_id>", "<x_id>", "<linkedin_id>"],
"media": ["https://your-site.com/launch.png"],
"useNextSlot": true
}'From JavaScript
const BASE = "https://api.breakreach.com/v1";
const headers = {
Authorization: `Bearer ${process.env.BREAKREACH_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Host the media reliably
const { url } = await fetch(`${BASE}/media`, {
method: "POST", headers,
body: JSON.stringify({ url: "https://your-site.com/launch.png" }),
}).then(r => r.json());
// 2. Schedule the post at the next free slot
const { post } = await fetch(`${BASE}/posts`, {
method: "POST", headers,
body: JSON.stringify({
content: "We just shipped v2 ๐",
accountIds: accounts.map(a => a.id),
media: [url],
useNextSlot: true,
}),
}).then(r => r.json());Endpoints
/v1/accountsList connected social accounts (ids, platform, name)
/v1/postsCreate a post โ schedule it, use the next free slot, or publish now
/v1/postsList posts with status, schedule and metrics
/v1/posts/:idDelete a post and cancel its scheduling
/v1/mediaRe-host any public media URL on permanent storage
/v1/next-slotNext free slot from the workspace posting schedule
/v1/analyticsAggregated metrics and top posts
/v1/accounts/statsFollower counts & account-level stats per connected account
/v1/posts/:id/metricsViews, likes, comments, shares for one post
/v1/posts/:id/commentsLive comments on a post (Instagram, Facebook, Threads, X)
/v1/comments/replyReply to a comment
/v1/pinterest-boardsPinterest boards for pin targeting
/v1/workspacesList your workspaces
Full machine-readable contract: OpenAPI spec
MCP server for AI agents
Every capability is also exposed as MCP tools on our hosted server โ the same one that powers the Breakreach connectors for ChatGPT and Claude. Point any MCP-compatible client at:
https://api.breakreach.com/mcpAuthentication is OAuth 2.1 with dynamic client registration โ your agent gets a consent screen, the user approves, and the tools (list_accounts, create_post, upload_media, get_next_slot, get_analyticsโฆ) become available. API keys also work directly as Bearer tokens for server-side agents.
Good to know
- โขScheduling is server-side with automatic retries on transient platform errors (rate limits, network).
- โขPlatform quirks are handled for you: TikTok photo conversion, Reddit flairs, Instagram professional-account publishing, media re-hosting.
- โขscheduledAt is interpreted in the workspace timezone; useNextSlot picks the next free slot of the posting schedule.
- โขFailed posts carry a human-readable error explaining exactly what to fix.
Developer plan pricing
Usage-based, billed monthly on connected social accounts โ scale from a side project to a platform without changing plans. API keys are also included on every regular Breakreach plan.
Graduated tiers โ e.g. 25 connected accounts = 2 free + 18 ร $5 + 5 ร $3 = $105/mo.
Start building today
First 2 accounts free โ pay only when you scale ยท 12 platforms