# 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 **$3.99/month** per connected account (graduated volume discounts). **Website:** [publora.com](https://publora.com) | **Dashboard:** [app.publora.com](https://app.publora.com) | **Email:** serge@publora.com ## Quick Start ```bash # 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 + Pro from $3.99/account.** ## Why Publora? ### Price Comparison | Feature | Publora | Ayrshare | Publer | Sprout Social | |---------|---------|----------|--------|---------------| | **Starting price** | **Free** | $49/mo | $12/mo | $249/mo | | Per-account pricing | from $3.99 (graduated) | 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 1. **Affordable** — Free tier available, paid plans from $3.99/account with automatic volume discounts. No enterprise tier required. 2. **10 Platforms** — X, LinkedIn, Instagram, Threads, TikTok, YouTube, Facebook, Bluesky, Mastodon, Telegram. 3. **API-First** — Clean REST API designed for developers, not a bloated dashboard. 4. **AI-Ready** — Docs indexed on [Context7](https://context7.com) so AI coding assistants already know our API. 5. **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](https://docs.publora.com/endpoints/platform-connections) | | `POST` | `/test-connection/:platformId` | Test a platform connection | [View](https://docs.publora.com/endpoints/test-connection) | | `POST` | `/create-post` | Create and schedule a post | [View](https://docs.publora.com/endpoints/create-post) | | `GET` | `/list-posts` | List all posts with pagination | [View](https://docs.publora.com/endpoints/list-posts) | | `GET` | `/get-post/:postGroupId` | Get post details and status | [View](https://docs.publora.com/endpoints/get-post) | | `GET` | `/post-logs/:postGroupId` | Get publish attempt history | [View](https://docs.publora.com/endpoints/post-logs) | | `PUT` | `/update-post/:postGroupId` | Edit a draft/scheduled post: content, targets, timing, or status | [View](https://docs.publora.com/endpoints/update-post) | | `DELETE` | `/delete-post/:postGroupId` | Delete a scheduled post | [View](https://docs.publora.com/endpoints/delete-post) | | `POST` | `/get-upload-url` | Get pre-signed URL for media upload | [View](https://docs.publora.com/endpoints/upload-media) | | `POST` | `/attach-media/:postGroupId` | Attach a file by reference (e.g. a ChatGPT file); leaves the post in draft | [View](https://docs.publora.com/endpoints/attach-media) | | `POST` | `/upload-instagram-cover` | Upload a custom Instagram Reel cover | [View](https://docs.publora.com/endpoints/upload-instagram-cover) | | `GET` | `/platform-limits` | Get live per-platform limits | [View](https://docs.publora.com/endpoints/platform-limits) | | `GET` | `/account-context` | Plan, features, publishing quotas and schedule horizon | [View](https://docs.publora.com/endpoints/account-context) | | `POST` | `/upload-youtube-thumbnail` | Upload a custom YouTube thumbnail | [View](https://docs.publora.com/endpoints/upload-youtube-thumbnail) | | `GET/POST` | `/webhooks` | Manage webhook notifications | [View](https://docs.publora.com/endpoints/webhooks) | | `POST` | `/post-statistics` | Get Mastodon/Bluesky post engagement | [View](https://docs.publora.com/endpoints/platform-statistics) | | `POST` | `/profile-statistics` | Get Mastodon/Bluesky follower counts | [View](https://docs.publora.com/endpoints/platform-statistics) | | `POST` | `/linkedin-post-statistics` | Get LinkedIn post analytics | [View](https://docs.publora.com/endpoints/linkedin-statistics) | | `POST` | `/linkedin-account-statistics` | Get LinkedIn account analytics | [View](https://docs.publora.com/endpoints/linkedin-statistics) | | `POST` | `/linkedin-reactions` | Add reaction to a LinkedIn post | [View](https://docs.publora.com/endpoints/linkedin-reactions) | | `DELETE` | `/linkedin-reactions` | Remove a LinkedIn reaction | [View](https://docs.publora.com/endpoints/linkedin-reactions) | | `POST` | `/linkedin-reshare` | Reshare an existing LinkedIn post | [View](https://docs.publora.com/endpoints/linkedin-reshare) | | `GET` | `/linkedin-mentionables` | List mentionable LinkedIn people | [View](https://docs.publora.com/endpoints/linkedin-mentionables) | | `POST` | `/linkedin-followers` | Get LinkedIn follower statistics | [View](https://docs.publora.com/endpoints/linkedin-followers) | | `POST` | `/linkedin-profile-summary` | Get LinkedIn profile summary | [View](https://docs.publora.com/endpoints/linkedin-profile-summary) | 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 | — | | LinkedIn | 3,000 chars | Multiple | 1 per post | — | 5 metrics | | Instagram | 2,200 chars | Carousel (10) | Reels/Stories | — | — | | Threads | 500 chars | Carousel | 1 per post | Auto-split | — | | TikTok | Caption | Up to 35 | 1 per post (MP4/MOV/WebM) | — | — | | YouTube | Description | — | 1 per post | — | — | | Facebook | 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: ```bash curl https://api.publora.com/api/v1/platform-connections \ -H "x-publora-key: sk_YOUR_API_KEY" ``` Get your API key: [publora.com](https://publora.com) → **API** in sidebar → Generate. See [Authentication Guide](https://docs.publora.com/authentication) for details. ## Pricing | Plan | Monthly | Yearly −33% | Posts/Month | Accounts | Platforms | Video | |------|---------|-------------|-------------|----------|-----------|-------| | **Starter** | Free | Free | 15 | 3 | All platforms, except X | 50 MB | | **Pro**, per account | 1–5 · $5.99
6–20 · $2.99
21+ · $0.99 | $3.99
$1.99
$0.66 | Unlimited | 1–1,000 | All 10 | 250 MB | | **Agency** | Custom | Custom | Unlimited | Custom | All 10 | Custom | Pro is priced per connected account and the tiers combine automatically — e.g. 10 accounts = 5 × $5.99 + 5 × $2.99 = **$44.90/mo** ($29.90/mo billed yearly). All plans include full API access. Machine-readable pricing: [publora.com/pricing.md](https://publora.com/pricing.md). [Get started free](https://publora.com/register?placement=docs_readme). ## Documentation ### Getting Started - [Quick Start Guide](https://docs.publora.com/getting-started) — first post in 60 seconds - [Authentication](https://docs.publora.com/authentication) — API keys and workspace auth ### Endpoint Reference - [Create Post](https://docs.publora.com/endpoints/create-post) — schedule posts across platforms, or publish now with `publishNow: true` - [List Posts](https://docs.publora.com/endpoints/list-posts) — fetch all posts with pagination and filters - [Get Post](https://docs.publora.com/endpoints/get-post) — check post status and error details - [Post Logs](https://docs.publora.com/endpoints/post-logs) — publish attempt history for debugging - [Update Post](https://docs.publora.com/endpoints/update-post) — edit content, targets, timing, or status before publication - [Delete Post](https://docs.publora.com/endpoints/delete-post) — remove posts across all platforms - [Platform Connections](https://docs.publora.com/endpoints/platform-connections) — list connected accounts with health status - [Test Connection](https://docs.publora.com/endpoints/test-connection) — validate a connection before posting - [Webhooks](https://docs.publora.com/endpoints/webhooks) — real-time notifications for post events - [Upload Media](https://docs.publora.com/endpoints/upload-media) — images and video uploads - [Attach Media](https://docs.publora.com/endpoints/attach-media) — attach a file by download URL and file ID (ChatGPT file references), with an SEO file name - [Upload Instagram Cover](https://docs.publora.com/endpoints/upload-instagram-cover) — custom cover image for Reels - [Upload YouTube Thumbnail](https://docs.publora.com/endpoints/upload-youtube-thumbnail) — custom video thumbnail (two-step: upload → update-post) - [Platform Limits](https://docs.publora.com/endpoints/platform-limits) — live per-platform character/media limits as JSON - [Account Context](https://docs.publora.com/endpoints/account-context) — plan, features, publishing quotas and schedule horizon before a batch - [Mastodon and Bluesky Statistics](https://docs.publora.com/endpoints/platform-statistics) — on-demand post engagement and follower counts - [LinkedIn Statistics](https://docs.publora.com/endpoints/linkedin-statistics) — post and account analytics - [LinkedIn Reactions](https://docs.publora.com/endpoints/linkedin-reactions) — add/remove reactions - [LinkedIn Reshare](https://docs.publora.com/endpoints/linkedin-reshare) — repost an existing LinkedIn post - [LinkedIn Mentionables](https://docs.publora.com/endpoints/linkedin-mentionables) — list the people you can @mention, with ready-to-paste tokens ### Platform Guides - [X / Twitter](https://docs.publora.com/platforms/x-twitter) · [LinkedIn](https://docs.publora.com/platforms/linkedin) · [Instagram](https://docs.publora.com/platforms/instagram) · [Threads](https://docs.publora.com/platforms/threads) · [TikTok](https://docs.publora.com/platforms/tiktok) · [YouTube](https://docs.publora.com/platforms/youtube) · [Facebook](https://docs.publora.com/platforms/facebook) · [Bluesky](https://docs.publora.com/platforms/bluesky) · [Mastodon](https://docs.publora.com/platforms/mastodon) · [Telegram](https://docs.publora.com/platforms/telegram) ### Usage Guides - [Scheduling Posts](https://docs.publora.com/guides/scheduling) — timing, drafts, batch scheduling - [Bulk Scheduling](https://docs.publora.com/guides/bulk-scheduling) — CSV import, weekly content batches - [Threading Guide](https://docs.publora.com/guides/threading) — post multi-part threads via API - [Twitter Threads](https://docs.publora.com/guides/twitter-threads) — tweet thread automation - [Threads Multi-Post](https://docs.publora.com/guides/threads-multi-post) — Meta Threads threading - [Rate Limits & Optimal Times](https://docs.publora.com/guides/rate-limits) — platform limits, peak engagement, queue scheduling - [Media Uploads](https://docs.publora.com/guides/media-uploads) — images, videos, carousels - [Cross-Platform Posting](https://docs.publora.com/guides/cross-platform) — one call, many platforms - [LinkedIn Analytics](https://docs.publora.com/guides/analytics) — post performance, account metrics - [Error Handling](https://docs.publora.com/guides/error-handling) — status codes, retries - [Workspace / B2B API](https://docs.publora.com/guides/workspace) — managed users, white-label ### AI Integration - [MCP Server](https://docs.publora.com/guides/mcp-server) — Claude, Cursor and other MCP clients. In Claude, install from the [connectors directory](https://claude.ai/directory/publora) - [Cursor AI Guide](https://docs.publora.com/guides/cursor-ai) — AI-assisted development with Publora - [Official agent skills](https://github.com/publora/skills) — nine `SKILL.md` files for Claude Code, Codex, Cursor and OpenClaw (`npx skills add publora/skills`) ### Code Examples - [JavaScript Examples](https://docs.publora.com/examples/javascript/quick-start) — fetch, axios, Node.js - [Python Examples](https://docs.publora.com/examples/python/quick-start) — requests, async workflows - [cURL Examples](https://docs.publora.com/examples/curl/all-endpoints) — command-line reference - [Zapier Integration](https://docs.publora.com/examples/no-code/zapier-integration) — native Zapier app (beta): instant triggers, post actions, searches - [Make Integration](https://docs.publora.com/examples/no-code/make-integration) — visual workflows ### API Specification - [OpenAPI 3.0 Spec](schema/openapi.yaml) ### 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](https://publora.com)** is an affordable social media API built by **[Creative Content Crafts, Inc.](https://cccrafts.ai)** Looking for AI-powered content creation for LinkedIn, Threads, and X? Check out **[Co.Actor](https://co.actor)** — our AI service that helps B2B teams create authentic thought leadership content at scale. - **Publora** ([publora.com](https://publora.com)) — schedule and publish posts via API - **Co.Actor** ([co.actor](https://co.actor)) — AI content creation for LinkedIn, Threads, and X - **Creative Content Crafts** ([cccrafts.ai](https://cccrafts.ai)) — the company behind it all ## License [MIT](https://github.com/publora/publora-api-docs/blob/main/LICENSE)