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.

InstagramTikTokX (Twitter)RedditLinkedInYouTubeFacebookThreadsBlueskyPinterestTelegramDiscord

Quickstart

  1. Create a Breakreach account and connect your social accounts.
  2. Generate an API key in the dashboard under Settings โ†’ API & MCP.
  3. 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

GET
/v1/accounts

List connected social accounts (ids, platform, name)

POST
/v1/posts

Create a post โ€” schedule it, use the next free slot, or publish now

GET
/v1/posts

List posts with status, schedule and metrics

DELETE
/v1/posts/:id

Delete a post and cancel its scheduling

POST
/v1/media

Re-host any public media URL on permanent storage

GET
/v1/next-slot

Next free slot from the workspace posting schedule

GET
/v1/analytics

Aggregated metrics and top posts

GET
/v1/accounts/stats

Follower counts & account-level stats per connected account

GET
/v1/posts/:id/metrics

Views, likes, comments, shares for one post

GET
/v1/posts/:id/comments

Live comments on a post (Instagram, Facebook, Threads, X)

POST
/v1/comments/reply

Reply to a comment

GET
/v1/pinterest-boards

Pinterest boards for pin targeting

GET
/v1/workspaces

List 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/mcp

Authentication 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.

First 2 accountsFree
Accounts 3 โ€“ 20$5 / account / mo
Accounts 21 โ€“ 100$3 / account / mo
Accounts 101+$2 / account / mo

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