REST API · MCP-Ready · n8n Native

The Social Media API for AI Agents and Developers

Publish to 10 social platforms through one REST API. Built for AI agents, n8n workflows, and custom backends — OAuth, rate limits, and media uploads handled for you.

Starts at $9/month · 7-day free trial

curl -X POST https://api.schedpilot.com/v1/posts \
  -H "Authorization: Bearer $SCHEDPILOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Shipping a new feature today.",
    "platforms": ["linkedin", "x", "bluesky"],
    "schedule_at": "2026-05-01T14:00:00Z",
    "idempotency_key": "release-v2.3"
  }'

// 201 Created · scheduled across 3 platforms

One API · 10 Platforms

What developers get

A REST API designed for production use — not a marketing checklist. Built for AI agents, automation workflows, and backends that need to publish reliably.

One endpoint, 10 platforms

POST once to publish to LinkedIn, X, Instagram, TikTok, YouTube, Facebook, Pinterest, Threads, Bluesky, and Reddit.

POST /v1/posts
OAuth handled for you

We manage token refresh, permission changes, and expired credentials. Your agent never sees an OAuth flow.

No dev apps to register
Idempotency keys

Safe retries with the idempotency_key header. Your agent can retry without creating duplicate posts.

idempotency_key: "release-v2.3"
Webhook callbacks

Subscribe to post.published, post.failed, and post.engaged events. No polling required.

POST /v1/webhooks
Rate limit transparency

Every response returns X-RateLimit-Remaining and X-RateLimit-Reset. Predictable throttling.

Headers on every 200
Consistent JSON shape

Every platform returns the same structured response. No per-platform branching in your agent code.

{ id, status, platforms }

Supported platforms and capabilities

Every platform, every format, in one place. Below is exactly what the API supports today.

Platform Text Image Video Carousel / Thread Stories Schedule
X (Twitter)✓ Thread
LinkedIn
Instagram✓ Carousel
Facebook
TikTok
YouTube✓ Shorts
Pinterest
Threads✓ Thread
Bluesky✓ Thread
Reddit

Capability matrix as of April 2026. Platform APIs evolve — we update this table as native capabilities change.

Integrations that match how developers work

Whether you build with low-code tools, AI frameworks, or raw REST calls — SchedPilot fits into the stack you already use.

n8n · native node

SchedPilot is available as an n8n community node. Drop it into any workflow, authenticate with your API key, and your automations publish to 10 platforms — no per-platform OAuth setup.

  • Single-node multi-platform publishing
  • Downloadable workflow templates
  • Works with self-hosted n8n
View n8n tutorial →
AI agent frameworks

Use SchedPilot as a tool in LangChain, CrewAI, AutoGen, Claude Code, or custom agents. JSON shapes LLMs parse reliably, idempotent retries, and clear error contracts.

  • ReAct and tool-use patterns
  • JSON-native responses
  • Deterministic error shapes
Build an AI agent →
MCP-ready

Expose SchedPilot as a tool to Claude Desktop, Cursor, or any MCP-compatible client. Community MCP wrappers available on GitHub — native server shipping soon.

  • publish_post, schedule_post, list_posts
  • Works with Claude, GPT, Gemini
  • Open-source wrappers on GitHub
MCP docs →
Make.com, Zapier, and custom backends

The REST API works with any HTTP client. Use Make.com's HTTP module or Zapier's Webhooks integration to connect SchedPilot to any workflow. For custom backends, call the API directly from Python, Node, Go, Ruby, or any language that speaks HTTP.

POST /v1/posts

What you can build

Concrete workflows developers are shipping with SchedPilot today — not marketing fluff.

Autonomous content pipelines

An AI agent pulls blog posts from your RSS feed, rewrites each for LinkedIn, X, and Bluesky with Claude, schedules them across the next 30 days, and retries failed publishes automatically with idempotency keys.

RSS → Claude → SchedPilot API → LinkedIn + X + Bluesky
Real-time trend response

Your agent polls X trending topics every 15 minutes, generates a branded take with GPT-4o, runs brand safety checks, and publishes to LinkedIn + X within 90 seconds of detecting a trend.

X Trends API → GPT-4o → SchedPilot → Multi-platform
Multi-client agency automation

An n8n workflow watches a Google Sheet of approved posts across 20 client brands. SchedPilot publishes each to the correct client's connected accounts — with separate authentication per workspace and idempotency guarantees.

Google Sheet → n8n → SchedPilot (20 workspaces)
Content calendar from a database

Your Airtable or Notion database is the source of truth. A nightly cron job calls SchedPilot's API to sync next week's scheduled posts across all platforms — keeping your calendar and your social accounts in lockstep.

Airtable/Notion → Cron → SchedPilot
Human-in-the-loop approvals

Your AI agent generates content and pushes it to SchedPilot with status draft. A human reviews and approves via the SchedPilot dashboard or a Slack webhook. Once approved, the post is automatically scheduled.

Agent → draft status → Slack approval → Auto-publish

Code examples

Working examples you can copy into your project today. Every snippet uses real SchedPilot endpoints.

1. Publish a post to 3 platforms
import requests, os

API_KEY = os.environ["SCHEDPILOT_API_KEY"]

response = requests.post(
    "https://api.schedpilot.com/v1/posts",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "content": "Shipping a new feature today.",
        "platforms": ["linkedin", "x", "bluesky"],
        "schedule_at": "2026-05-01T14:00:00Z",
        "idempotency_key": "release-v2.3"
    }
)

post = response.json()
print(f"Scheduled as {post['id']} · status: {post['status']}")
2. Build an AI agent that posts with Claude

A minimal Python agent that uses Claude to generate a post, then publishes it via SchedPilot. Uses the ReAct pattern with SchedPilot as the posting tool.

import os, requests
from anthropic import Anthropic

anthropic = Anthropic()
SCHEDPILOT_KEY = os.environ["SCHEDPILOT_API_KEY"]

def publish_post(content: str, platforms: list[str]) -> dict:
    """Tool the agent can call to actually publish."""
    r = requests.post(
        "https://api.schedpilot.com/v1/posts",
        headers={"Authorization": f"Bearer {SCHEDPILOT_KEY}"},
        json={"content": content, "platforms": platforms}
    )
    return r.json()

# Claude drafts the post
draft = anthropic.messages.create(
    model="claude-opus-4-7",
    max_tokens=300,
    messages=[{
        "role": "user",
        "content": "Write a 280-char LinkedIn post about idempotent API design."
    }]
).content[0].text

# SchedPilot publishes it
result = publish_post(draft, ["linkedin", "x"])
print(f"Published: {result['id']}")
3. Subscribe to webhook events
curl -X POST https://api.schedpilot.com/v1/webhooks \
  -H "Authorization: Bearer $SCHEDPILOT_API_KEY" \
  -d '{
    "url": "https://yourapp.com/hooks/schedpilot",
    "events": ["post.published", "post.failed"],
    "secret": "whsec_..."
  }'

How SchedPilot compares

Honest breakdown versus the other serious APIs in this category. Every number verified against vendor pages in April 2026.

Capability SchedPilot Ayrshare Postiz Buffer API Hootsuite
Unified REST API Limited Enterprise only
Platforms supported 10 13+ 6 9 9
OAuth handled for you
Idempotency keys
Webhooks Enterprise
Open source
Native n8n node Limited
UI dashboard included
Starting price $9/mo $49/mo Free (self-host) $6/channel $99/mo
Free trial 7 days 14 days Self-host Free tier 30 days

Honest positioning: Ayrshare has more platforms (13+) but costs 10× more. Postiz is open-source and free to self-host, but requires engineering effort to deploy and maintain. Buffer's API is per-channel and limited. Hootsuite's API is enterprise-only. SchedPilot sits between — managed API with UI fallback, 10 platforms, native n8n integration, and flat $9/mo pricing.

Secure by default

Encrypted OAuth tokens stored server-side. Your agents only ever see your SchedPilot API key — they never touch platform credentials. Revoke access instantly from the dashboard. HTTPS enforced, signed webhook payloads, and optional IP allowlisting on paid plans.

Frequently asked questions

Which social media platforms does the SchedPilot API support? +
The SchedPilot API supports 10 platforms through a single unified endpoint: X (Twitter), LinkedIn, Instagram, Facebook, TikTok, YouTube, Pinterest, Threads, Bluesky, and Reddit. Each platform accepts text posts, and most support images, video, and scheduled publishing. See the capability matrix above for the exact feature coverage per platform.
Do I need to register developer apps with Meta, LinkedIn, X, and the other platforms? +
No. SchedPilot handles OAuth, app registration, and token management for all 10 supported platforms. You connect accounts once via the SchedPilot UI, then your agents and automations use a single SchedPilot API key for everything. This is the single biggest time-saver compared to building platform integrations directly.
Can I use SchedPilot with n8n, Make.com, or Zapier? +
Yes. SchedPilot has a native n8n community node — drop it into any workflow with your API key. Make.com and Zapier work via generic HTTP modules since the REST API is straightforward. We publish reference n8n workflow templates you can import directly — see the n8n social media automation guide.
Is the SchedPilot API compatible with AI agents and LLMs like Claude, GPT, or Gemini? +
Yes. The API returns consistent JSON shapes that LLMs parse reliably, supports idempotency keys for safe retries, and has clear error contracts. You can use SchedPilot as a tool in LangChain, CrewAI, AutoGen, or custom agent frameworks. MCP (Model Context Protocol) compatibility is available via community wrappers, with a native server shipping soon for Claude Desktop, Cursor, and Codex integrations.
What happens if a post fails on one platform in a multi-platform call? +
Each platform is handled independently. If you post to LinkedIn, X, and Bluesky in one call and Bluesky fails, LinkedIn and X still publish successfully. The response includes per-platform status so your agent knows exactly which ones succeeded and which didn't. Failed platforms can be retried with the same idempotency_key without creating duplicates.
Does the SchedPilot API support image and video uploads? +
Yes. Upload media via the /v1/media endpoint (multipart or URL-based), then reference the media_id in your post. We handle platform-specific size limits, aspect ratios, and format conversions automatically. Video is supported on X, LinkedIn, Instagram, Facebook, TikTok, YouTube, Pinterest, and Threads.
What are the API rate limits? +
Rate limits scale with your plan. Every API response includes X-RateLimit-Remaining and X-RateLimit-Reset headers so your code can throttle predictably. Starter plans include 1,000 requests/hour; higher tiers include 10,000+. Platform-level limits (imposed by Meta, X, etc.) are separately managed and communicated via response metadata.
Do you have official Python or Node.js SDKs? +
The REST API works with any HTTP client — we provide reference code examples in Python (requests), Node.js (fetch), curl, and JavaScript. Official SDKs are on the roadmap. For most use cases, wrapping the REST calls in 20 lines of code is simpler than maintaining an SDK dependency.
How much does SchedPilot API access cost? +
API access is included on all SchedPilot paid plans starting at $9/month (Starter), with no per-call fees, no developer-tier pricing, and no annual contracts. This is notably cheaper than Ayrshare ($49/month developer access) or Hootsuite (enterprise-only API access). See full pricing →
How does SchedPilot compare to Ayrshare, Postiz, or Buffer? +
Ayrshare has more platforms (13+) but costs 10× more starting. Postiz is open-source and free to self-host but requires engineering effort to deploy and maintain. Buffer's API is per-channel and limited for programmatic use. SchedPilot sits between — a managed API with UI fallback, 10 platforms, native n8n integration, and flat $9/month pricing. See the comparison table above for the full breakdown.

Ship social media features without the OAuth tax

Developers using SchedPilot save weeks of integration work. Start in under 5 minutes — no sales call.

Get API Key

Grow your social presence with the best tool for creating content

Schedule posts, find your best time to publish, and keep your calendar full, without the chaos. SchedPilot makes consistency simple across every channel.

Start for free

Free trial available. Cancel anytime.