PostHero REST API

Publish to social media.
Programmatically.

One API call to create, schedule, and publish posts across 8 platforms. Built for developers, AI agents, and automation pipelines.

Trusted by 1,100+ founders, marketers, and businesses

publish-post.sh
curl -X POST https://server.posthero.ai/api/v1/posts \
  -H "Authorization: Bearer pk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Just shipped v2.0! 🚀",
    "platforms": [{"platform": "linkedin", "accountId": "acc_123"}],
    "publishNow": true
  }'
RESTJSONBearer authcurlNode.jsPython8 platformsWebhooks

How it works

From zero to published
in three API calls

No SDK required. Plain HTTP. Works from any language or tool.

1

Get your API key

Sign up for PostHero, connect your social accounts, and grab your key from Settings → API.

list-accounts.sh
curl https://server.posthero.ai/api/v1/accounts \
  -H "Authorization: Bearer pk_..."
2

Fetch your account IDs

Call GET /accounts to get the IDs of your connected social media accounts.

response.json
// Response
{
  "success": true,
  "data": [
    { "id": "acc_abc", "platform": "linkedin", "name": "John Doe" },
    { "id": "acc_def", "platform": "twitter",  "name": "@johndoe" }
  ]
}
3

Create and publish

POST to /posts with your text, platforms, and schedule. Publish now or schedule for later.

create-post.sh
curl -X POST https://server.posthero.ai/api/v1/posts \
  -H "Authorization: Bearer pk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Just shipped v2.0! 🚀",
    "platforms": [
      { "platform": "linkedin", "accountId": "acc_abc" },
      { "platform": "twitter",  "accountId": "acc_def" }
    ],
    "publishNow": true
  }'

API capabilities

Everything you need
to automate social media

Full CRUD for posts, media uploads, analytics, and multi-platform publishing in one simple API.

POST

Publish immediately

Set publishNow: true and your post goes live across all selected platforms instantly.

POST /posts
POST

Schedule for later

Pass an ISO 8601 timestamp and PostHero handles the scheduled publish automatically.

POST /posts
POST

Upload media

Upload images and videos via multipart form. Get back an S3 URL to attach to any post.

POST /media/upload
GET

Pull analytics

Fetch post performance, follower growth, and top-performing content for any account.

GET /analytics
GET

List and manage posts

Filter by status, platform, or date. Update drafts, reschedule, or delete any post.

GET /posts
PATCH

Update or republish

Edit a draft or scheduled post, or instantly republish an existing post to new platforms.

PATCH /posts/:id

Connect and publish to all your favorite platforms

LinkedInLinkedIn
XX
InstagramInstagram
ThreadsThreads
FacebookFacebook
YouTubeYouTube
TikTokTikTok
BlueskyBluesky
PinterestPinterestSoon

Pricing

Simple pricing

Start with the API plan. Upgrade when you need the dashboard.

API

$9/mo

For developers and AI agents. No dashboard needed.

  • 100 published posts / mo
  • REST API access
  • MCP server access
  • CLI tool access
  • 60 req / min
  • Media uploads
  • Analytics API
Most popular

Starter

$19/mo

Full dashboard + API. Unlimited posts, all platforms.

  • Unlimited published posts
  • REST API access
  • MCP server access
  • CLI tool access
  • Full dashboard
  • 10 social accounts
  • Scheduling
  • LinkedIn Carousels
  • Media uploads
  • Analytics

Loved by creators & agencies

Saved me at least 10 hours per week on content creation. Now I can focus on actually growing my business.
Sarah Green

Sarah Green

Entrepreneur

You made it so easy. My LinkedIn content is now more engaging than ever before. I just input my ideas, and your tool handles the rest.

Victor Metelsky

Victor Metelsky

Founder at Sitekick

Finally, a tool that gets multi-platform publishing right. No more copy-pasting and reformatting for each network.

Emma Williams

Emma Williams

Social Media Manager

The quality of the first post was better than anything we got from the writer we hired before. Right from the start.

Natalie Luneva

Natalie Luneva

CMO at DepositFix

PostHero has completely transformed how we handle social media. We went from posting once a week to daily content across all platforms.

James Mitchell

James Mitchell

Marketing Director

The voice notes feature is a game changer. I record my thoughts during commute and have polished posts ready by the time I reach office.

Sarah Chen

Sarah Chen

Content Creator

My LinkedIn posts are now getting way more attention than ever. I just pick a topic, and boom - your AI gives me awesome content ideas.

Mary Cooper

Mary Cooper

Marketer

We've seen 3x engagement since switching to PostHero. The AI really understands what works on each platform.

Michael Torres

Michael Torres

Agency Owner

The viral posts library alone is worth the subscription. I never run out of inspiration for my content calendar.

David Park

David Park

Startup Founder

Saved me at least 10 hours per week on content creation. Now I can focus on actually growing my business.

Sarah Green

Sarah Green

Entrepreneur

The scheduling feature with platform-specific optimization is brilliant. My posts go live at peak engagement times automatically.

Alex Johnson

Alex Johnson

Digital Marketer

As a solopreneur, PostHero feels like having a full marketing team. It handles everything from ideation to publishing.

Lisa Martinez

Lisa Martinez

Solopreneur

The AI captures my voice perfectly. People can't tell the difference between AI-assisted and my manually written posts.

Tom Anderson

Tom Anderson

Consultant

Trusted by 1100+ users

FAQ

Frequently asked
questions

PostHero is an all-in-one social media management tool that helps you create, schedule, and publish content across multiple platforms including LinkedIn, X (Twitter), Instagram, Facebook, and more. Think of it as your AI-powered social media manager.

ChatGPT is a general-purpose AI assistant, while PostHero is specifically designed for social media success. We've trained our AI on 10,000+ viral posts to understand what makes content perform well on each platform. PostHero helps you create, schedule, and publish - all in one place.

PostHero supports LinkedIn, X (Twitter), Instagram, Threads, Facebook, YouTube, TikTok, and Bluesky. We're constantly adding new platforms based on user feedback, with Pinterest coming soon.

For best results, aim to post once every day on your primary platforms. If that's too much, posting at least 3 times a week is still effective for maintaining a strong presence. PostHero makes this easy with scheduling and content planning features.

PostHero generates content ideas, creates engaging posts optimized for each platform, designs carousels, converts voice notes to posts, and helps you plan your content strategy with AI-powered monthly content plans. You can also schedule and publish directly to all your connected accounts.

Yes! PostHero can schedule and publish content directly to LinkedIn, X, Instagram, Facebook, and other connected platforms. Set your posting times and let PostHero handle the rest.

Unlike generic scheduling tools, PostHero combines AI content creation with multi-platform publishing. Our AI is trained on viral content patterns specific to each platform, helping you create posts that actually perform well - not just generic content.

Absolutely! While AI is a powerful feature, PostHero also offers templates and manual options. You can write posts yourself, create carousels manually, and use the scheduling features without relying on AI if you prefer.

Yes! PostHero offers a REST API that lets you create, schedule, and publish posts programmatically. You can integrate it into your own apps, internal tools, or custom automation pipelines. Check the API docs for authentication details and available endpoints.

Absolutely. PostHero supports agentic workflows — you can connect any AI agent (including OpenClaw, custom GPT agents, or your own LLM setup) to our API to fully automate content creation and scheduling. Agents can generate posts, pick optimal times, and publish without any manual input.

OpenClaw is an AI agent framework. PostHero integrates with OpenClaw so you can drop a ready-made social media agent into your workflow — it will research topics, draft platform-optimized posts, and schedule them on your behalf. No coding required to get started.

Yes. PostHero exposes an MCP server, so any MCP-compatible AI host (like Claude Desktop, Cursor, or your own setup) can call PostHero actions directly. This means your AI assistant can schedule and publish posts as a native tool call.

Yes — PostHero works with Zapier, n8n, Make, and similar automation platforms via our REST API and webhooks. Trigger posts from a spreadsheet update, a form submission, a new RSS item, or any other event in your stack.

Yes, we offer a 30-day money-back guarantee. If PostHero doesn't meet your expectations within 30 days of purchase, you can request a full refund - no questions asked.

Yes! We offer a 7-day free trial so you can explore all of PostHero's features before committing.

Post smarter. Grow faster.

Start your 7-day free trial today. Turn posts into growth.

Get started for free