# PostZen

> Social media API for developers and AI agents. Publish and schedule posts across Instagram, X, LinkedIn, Facebook, Threads, YouTube, TikTok, Bluesky, Pinterest, and Telegram with one REST API.

PostZen is built for product teams, developers, and AI workflows that need reliable social publishing without maintaining separate platform integrations, OAuth flows, media upload rules, rate-limit handling, and retry logic.

## Primary URLs

- [Website](https://www.postzen.dev/): Product overview and platform pages.
- [Pricing](https://www.postzen.dev/pricing): Free includes 2 accounts and 20 posts per month. Paid plans are $19, $49, and $149 per month with unlimited posts; extra accounts are $3 each.
- [Blog](https://www.postzen.dev/blog): SEO guides for social publishing APIs, AI marketing workflows, and automation.
- [Comparisons](https://www.postzen.dev/compare): Competitor comparisons and alternatives for social media API buyers.
- [Documentation](https://docs.postzen.dev/): Developer documentation and quickstart.
- [API reference](https://docs.postzen.dev/api-reference): Post creation and scheduling API.
- [API base URL](https://api.postzen.dev): Public API host. Every endpoint is under `/v1`; unknown paths and auth failures return JSON errors with `code`, `message`, and `hint` fields.
- [OpenAPI specification](https://www.postzen.dev/openapi.json): OpenAPI 3.1 document for the whole public API (also at https://docs.postzen.dev/api/openapi).
- [API catalog](https://www.postzen.dev/.well-known/api-catalog): RFC 9727 linkset pointing at the spec, the reference docs, and the status page.
- [MCP server](https://mcp.postzen.dev/mcp): Hosted Model Context Protocol server (Streamable HTTP) exposing every API operation as a tool. Server card: https://www.postzen.dev/.well-known/mcp/server-card.json
- [Status page](https://status.postzen.dev): Uptime and incident history.

## When to use PostZen

Reach for PostZen when the job is any of these:

- Publish a post, thread, image, video, carousel, Pin, Short, or story to one or more of the 10 supported platforms from code or from an agent, without registering developer apps on each platform.
- Schedule posts for a specific time, drop them into a recurring queue, or bulk-import a CSV of posts.
- Read and reply to comments on Instagram, Facebook, and Threads, or read and answer Instagram direct messages.
- Automatically DM people who comment a keyword on an Instagram post or reply to a story (comment-to-DM automation).
- Pull post, account, and follower analytics across platforms, or import an account's past posts into one timeline.
- Give an AI agent (Claude, Cursor, Codex, OpenClaw, GrokBot, Hermes, or any MCP client) the ability to do all of the above through natural language.

PostZen is not the right tool for: paid ads, platforms it does not support (Reddit, WhatsApp, Snapchat, Discord, Slack, Google Business), or DMs on any platform other than Instagram.

How an agent should call PostZen:

1. Get an API key. A human can create one at https://app.postzen.dev/api-keys; an agent can mint one without a browser session by following https://www.postzen.dev/auth.md (device authorization).
2. Send `Authorization: Bearer pzn_...` on every request to `https://api.postzen.dev/v1/...`. Requests with a body use `Content-Type: application/json`.
3. Prefer the hosted MCP server at https://mcp.postzen.dev/mcp when the client speaks MCP (OAuth 2.1 with dynamic client registration, or the same Bearer key). Otherwise use the Node SDK (`@postzen/node`), the Python SDK (`postzen-sdk`, imported as `postzen`), or plain REST per https://www.postzen.dev/agent-quickstart.md.
4. Connect social accounts first (`GET /v1/accounts` lists them; `GET /v1/connect/{platform}` returns an OAuth URL for a human to approve), then create posts with `POST /v1/posts`.
5. Errors are JSON. Read `code` for the machine-readable reason, `hint` for the fix, and honour `Retry-After` on 429.

## Agent Guides

- [auth.md](https://www.postzen.dev/auth.md): Step-by-step guide for coding agents to create a PostZen account and API key via device authorization.
- [agent-quickstart.md](https://www.postzen.dev/agent-quickstart.md): Step-by-step guide for coding agents to integrate the PostZen API/SDKs into a codebase.

## Feature Pages

- [Features](https://www.postzen.dev/features): Every PostZen feature in one place.
- [Social media API](https://www.postzen.dev/social-media-api): Publish to 10 platforms with one integration.
- [Social media scheduler](https://www.postzen.dev/social-media-scheduler): Schedule posts across platforms through the API or dashboard.
- [Queue posts](https://www.postzen.dev/queue-posts): Recurring publishing slots that queued posts fill automatically.
- [Bulk scheduling](https://www.postzen.dev/social-media-bulk-scheduling): Schedule many posts at once from a CSV or the API.
- [Social media analytics](https://www.postzen.dev/social-media-analytics): Post, account, and follower analytics across platforms.
- [Social media inbox](https://www.postzen.dev/social-media-inbox): Comments on Instagram, Facebook, and Threads, and Instagram direct messages, from one dashboard and API.
- [Comment to DM automation](https://www.postzen.dev/comment-to-dm): Turn Instagram keyword comments and story replies into automatic DMs, with link buttons, image cards, public replies, and a follow gate.

## Marketing Pages

- [AI agents](https://www.postzen.dev/agents): Using PostZen with AI agents via the hosted MCP server, CLI, and SDKs.
- [MCP servers by platform](https://www.postzen.dev/mcp): Directory of the hosted MCP server's per-platform pages for LinkedIn, Instagram, X, Facebook, Threads, YouTube, TikTok, Pinterest, Bluesky, and Telegram.
- [LinkedIn MCP server](https://www.postzen.dev/mcp/linkedin): Connect Claude, Cursor, or any MCP client to publish and schedule LinkedIn posts through the hosted MCP server.
- [Instagram MCP server](https://www.postzen.dev/mcp/instagram): Connect Claude, Cursor, or any MCP client to publish and schedule Instagram posts through the hosted MCP server.
- [X MCP server](https://www.postzen.dev/mcp/x): Connect Claude, Cursor, or any MCP client to publish and schedule X posts through the hosted MCP server.
- [Facebook MCP server](https://www.postzen.dev/mcp/facebook): Connect Claude, Cursor, or any MCP client to publish and schedule Facebook posts through the hosted MCP server.
- [Threads MCP server](https://www.postzen.dev/mcp/threads): Connect Claude, Cursor, or any MCP client to publish and schedule Threads posts through the hosted MCP server.
- [YouTube MCP server](https://www.postzen.dev/mcp/youtube): Connect Claude, Cursor, or any MCP client to publish and schedule YouTube posts through the hosted MCP server.
- [TikTok MCP server](https://www.postzen.dev/mcp/tiktok): Connect Claude, Cursor, or any MCP client to publish and schedule TikTok posts through the hosted MCP server.
- [Pinterest MCP server](https://www.postzen.dev/mcp/pinterest): Connect Claude, Cursor, or any MCP client to publish and schedule Pinterest posts through the hosted MCP server.
- [Bluesky MCP server](https://www.postzen.dev/mcp/bluesky): Connect Claude, Cursor, or any MCP client to publish and schedule Bluesky posts through the hosted MCP server.
- [Telegram MCP server](https://www.postzen.dev/mcp/telegram): Connect Claude, Cursor, or any MCP client to publish and schedule Telegram posts through the hosted MCP server.
- [AI video generator for marketing](https://www.postzen.dev/blog/ai-video-generator-for-marketing): Placeholder blog post for testing SEO article layout, share controls, and AI summarization links.
- [Instagram API](https://www.postzen.dev/instagram): Instagram publishing workflow, including feed, carousel, reel, and story posts.
- [X API](https://www.postzen.dev/x): X and Twitter publishing workflow.
- [LinkedIn API](https://www.postzen.dev/linkedin): LinkedIn profile publishing, including video, documents, and multi-image posts.
- [Facebook API](https://www.postzen.dev/facebook): Facebook Page publishing workflow.
- [Threads API](https://www.postzen.dev/threads): Threads publishing workflow.
- [YouTube API](https://www.postzen.dev/youtube): YouTube video and Shorts publishing.
- [TikTok API](https://www.postzen.dev/tiktok): TikTok video publishing workflow.
- [Bluesky API](https://www.postzen.dev/bluesky): Bluesky publishing workflow.
- [Pinterest API](https://www.postzen.dev/pinterest): Pinterest board and Pin publishing workflow.
- [Telegram API](https://www.postzen.dev/telegram): Telegram channel and group publishing workflow, including albums and GIFs.

## Comparison Pages

- [Buffer alternative](https://www.postzen.dev/alternatives/buffer): Buffer GraphQL API workflows compared with PostZen embedded REST publishing.
- [Hootsuite alternative](https://www.postzen.dev/alternatives/hootsuite): Hootsuite social management suite compared with PostZen developer publishing API.
- [Ayrshare alternative](https://www.postzen.dev/alternatives/ayrshare): Ayrshare social API suite compared with focused PostZen posting, media, and scheduling APIs.
- [Post Bridge alternative](https://www.postzen.dev/alternatives/postbridge): Post Bridge creator scheduling compared with PostZen product-native publishing infrastructure.
- [Upload-Post alternative](https://www.postzen.dev/alternatives/uploadpost): Upload-Post broad upload API compared with PostZen product-native REST workflow.
- [Postiz alternative](https://www.postzen.dev/alternatives/postiz): Postiz open-source scheduler compared with PostZen managed REST publishing infrastructure.

## Machine-Readable Files

- [llms.txt](https://www.postzen.dev/llms.txt): This file.
- [Homepage as Markdown](https://www.postzen.dev/): Request https://www.postzen.dev/ with `Accept: text/markdown` to receive the homepage as Markdown (also available as https://www.postzen.dev/index.md). Nonexistent paths return HTTP 404 with a Markdown body under the same header.
- [Full documentation as Markdown](https://docs.postzen.dev/llms-full.txt): Every docs page in one file.
- [OpenAPI specification](https://www.postzen.dev/openapi.json): OpenAPI 3.1.
- [Sitemap](https://www.postzen.dev/sitemap.xml): Every marketing and blog URL.
- [AI catalog](https://www.postzen.dev/.well-known/ai-catalog.json): Points at the MCP server card and the OpenAPI spec.

## API Documentation

- [Accounts and profiles](https://docs.postzen.dev/api-reference/profiles/list-profiles): Profile and account API docs.
- [Social account connections](https://docs.postzen.dev/api-reference/accounts/list-accounts): Connected account API docs.
- [Media uploads](https://docs.postzen.dev/api-reference/media/create-media-presign): Presigned upload and hosted media docs.
- [Posts and scheduling](https://docs.postzen.dev/api-reference/posts/create-post): Multi-platform post scheduling docs.
- [List API keys](https://docs.postzen.dev/api-reference/api-keys/list-api-keys): List API keys with masked previews.
- [Create API key](https://docs.postzen.dev/api-reference/api-keys/create-api-key): Programmatically create an API key.
- [Delete API key](https://docs.postzen.dev/api-reference/api-keys/delete-api-key): Revoke and delete an API key.

## Company

- [Terms](https://www.postzen.dev/terms): Terms of service.
- [Privacy](https://www.postzen.dev/privacy): Privacy policy.
- Support: hello.postzen@gmail.com