Publora API Documentation
Affordable REST API for scheduling and publishing social media posts across 10 platforms.
Schedule posts to X/Twitter, LinkedIn, Instagram, Threads, TikTok, YouTube, Facebook, Bluesky, Mastodon, and Telegram — all from a single API call. Free tier available, paid plans from $2.99/month per connected account.
Website: publora.com | Dashboard: app.publora.com | Email: serge@publora.com
Quick Start
# 1. List your connected social accounts
curl https://api.publora.com/api/v1/platform-connections \
-H "x-publora-key: YOUR_API_KEY"
# 2. Schedule a post
curl -X POST https://api.publora.com/api/v1/create-post \
-H "x-publora-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Hello from Publora API!",
"platforms": ["twitter-123456789", "linkedin-ABC123"],
"scheduledTime": "2026-03-01T14:00:00.000Z"
}'3 API calls. 10 platforms. Free tier + $2.99/account.
Why Publora?
Price Comparison
| Feature | Publora | Ayrshare | Publer | Sprout Social |
|---|---|---|---|---|
| Starting price | Free | $49/mo | $12/mo | $249/mo |
| Per-account pricing | $2.99-5.99 | N/A | N/A | N/A |
| Platforms | 10 | 13 | 9 | 6 |
| API access | All plans | Paid only | Paid only | Enterprise |
| Bluesky support | Yes | Yes | No | No |
| Threads support | Yes | Yes | Yes | No |
| Mastodon support | Yes | No | Yes | No |
Publora offers a free tier and flexible per-account pricing — pay only for what you use.
Why Developers Choose Publora
- Affordable — Free tier available, paid plans from $2.99/account. No enterprise tier required.
- 10 Platforms — X, LinkedIn, Instagram, Threads, TikTok, YouTube, Facebook, Bluesky, Mastodon, Telegram.
- API-First — Clean REST API designed for developers, not a bloated dashboard.
- AI-Ready — Docs indexed on Context7 so AI coding assistants already know our API.
- Modern Platforms — First-class support for Bluesky, Threads, and Mastodon that competitors lack.
API Endpoints
| Method | Endpoint | Description | Docs |
|---|---|---|---|
GET |
/platform-connections |
List connected social accounts | View |
POST |
/test-connection/:platformId |
Test a platform connection | View |
POST |
/create-post |
Create and schedule a post | View |
GET |
/list-posts |
List all posts with pagination | View |
GET |
/get-post/:postGroupId |
Get post details and status | View |
GET |
/post-logs/:postGroupId |
Get publish attempt history | View |
PUT |
/update-post/:postGroupId |
Update post timing or status | View |
DELETE |
/delete-post/:postGroupId |
Delete a scheduled post | View |
POST |
/get-upload-url |
Get pre-signed URL for media upload | View |
POST |
/upload-instagram-cover |
Upload a custom Instagram Reel cover | View |
GET |
/platform-limits |
Get live per-platform limits | View |
POST |
/upload-youtube-thumbnail |
Upload a custom YouTube thumbnail | View |
GET/POST |
/webhooks |
Manage webhook notifications | View |
POST |
/linkedin-post-statistics |
Get LinkedIn post analytics | View |
POST |
/linkedin-account-statistics |
Get LinkedIn account analytics | View |
POST |
/linkedin-reactions |
Add reaction to a LinkedIn post | View |
DELETE |
/linkedin-reactions |
Remove a LinkedIn reaction | View |
POST |
/linkedin-reshare |
Reshare an existing LinkedIn post | View |
POST |
/linkedin-followers |
Get LinkedIn follower statistics | View |
POST |
/linkedin-profile-summary |
Get LinkedIn profile summary | View |
Base URL: https://api.publora.com/api/v1
Supported Platforms
| Platform | Text | Images | Videos | Threading | Analytics |
|---|---|---|---|---|---|
| X / Twitter | 280 chars | Up to 4 | 1 per post | Auto-split | — |
| 3,000 chars | Multiple | 1 per post | — | 5 metrics | |
| 2,200 chars | Carousel (10) | Reels/Stories | — | — | |
| Threads | 500 chars | Carousel | 1 per post | Disabled | — |
| TikTok | Caption | Up to 35 | 1 per post (MP4/MOV/WebM) | — | — |
| YouTube | Description | — | 1 per post | — | — |
| 63,206 chars | Multiple | 1 per post | — | — | |
| Bluesky | 300 chars | Up to 4 | 1 per post | — | — |
| Mastodon | 500 chars | Up to 4 | 1 per post | — | — |
| Telegram | 4,096 chars | Multiple | 1 per post | — | — |
Authentication
All requests require the x-publora-key header:
curl https://api.publora.com/api/v1/platform-connections \
-H "x-publora-key: sk_YOUR_API_KEY"Get your API key: publora.com → API in sidebar → Generate.
See Authentication Guide for details.
Pricing
| Plan | Price | Posts/Month | Accounts | Platforms | Video |
|---|---|---|---|---|---|
| Starter | Free | 15 | 3 | All 10 | 50 MB |
| Pro | $2.99/account | 100/account | Unlimited | All 10 | 100 MB |
| Premium | $5.99/account | 500/account | Unlimited | All 10 | 250 MB |
All plans include full API access. Pro/Premium use per-account pricing — add as many accounts as you need. Get started free.
Documentation
Getting Started
- Quick Start Guide — first post in 60 seconds
- Authentication — API keys and workspace auth
Endpoint Reference
- Create Post — schedule posts across platforms
- List Posts — fetch all posts with pagination and filters
- Get Post — check post status and error details
- Post Logs — publish attempt history for debugging
- Update Post — reschedule or change status
- Delete Post — remove posts across all platforms
- Platform Connections — list connected accounts with health status
- Test Connection — validate a connection before posting
- Webhooks — real-time notifications for post events
- Upload Media — images and video uploads
- Upload Instagram Cover — custom cover image for Reels
- Upload YouTube Thumbnail — custom video thumbnail (two-step: upload → update-post)
- Platform Limits — live per-platform character/media limits as JSON
- LinkedIn Statistics — post and account analytics
- LinkedIn Reactions — add/remove reactions
- LinkedIn Reshare — repost an existing LinkedIn post
Platform Guides
- X / Twitter · LinkedIn · Instagram · Threads · TikTok · YouTube · Facebook · Bluesky · Mastodon · Telegram
Usage Guides
- Scheduling Posts — timing, drafts, batch scheduling
- Bulk Scheduling — CSV import, weekly content batches
- Threading Guide — post multi-part threads via API
- Twitter Threads — tweet thread automation
- Threads Multi-Post — Meta Threads threading
- Rate Limits & Optimal Times — platform limits, peak engagement, queue scheduling
- Media Uploads — images, videos, carousels
- Cross-Platform Posting — one call, many platforms
- LinkedIn Analytics — post performance, account metrics
- Error Handling — status codes, retries
- Workspace / B2B API — managed users, white-label
AI Integration
- MCP Server — Claude Code, Claude Desktop, Cursor integration
- Cursor AI Guide — AI-assisted development with Publora
Code Examples
- JavaScript Examples — fetch, axios, Node.js
- Python Examples — requests, async workflows
- cURL Examples — command-line reference
- Zapier Integration — no-code automation
- Make Integration — visual workflows
API Specification
Public Repository Hygiene
Keep this public, Context7-indexed repository limited to user-facing documentation, SKILL.md, and published schemas. Internal audit reports, comparison scripts, private-host instructions, and temporary migration notes belong in the private Publora product repository, not here.
About
Publora is an affordable social media API built by Creative Content Crafts, Inc.
Looking for AI-powered content creation for LinkedIn, Threads, and X? Check out Co.Actor — our AI service that helps B2B teams create authentic thought leadership content at scale.
- Publora (publora.com) — schedule and publish posts via API
- Co.Actor (co.actor) — AI content creation for LinkedIn, Threads, and X
- Creative Content Crafts (cccrafts.ai) — the company behind it all