llms.txt
Compare with other sites' llms.txt files →# PublishQ
> Social media scheduling platform with API, CLI, and MCP server. Schedule and publish to 8 platforms from one dashboard — or let AI agents do it programmatically.
PublishQ is a social media management platform for creators, agencies, and developers. Write a post once, preview how it looks on each platform, and publish or schedule to all of them at once. Also offers a public API, CLI, and MCP server so AI agents and scripts can post on your behalf. API access is included on every plan, including the free plan — no extra charge, no paid-only gate.
## Supported Platforms
- [YouTube](https://publishq.com/youtube-scheduler): Videos, Shorts
- [TikTok](https://publishq.com/tiktok-scheduler): Videos, Photo carousels
- [X (Twitter)](https://publishq.com/twitter-scheduler): Text, Images, GIFs, Videos, Polls
- [LinkedIn](https://publishq.com/linkedin-scheduler): Text, Images, Videos
- [Instagram](https://publishq.com/instagram-scheduler): Reels, Carousels, Stories, Images
- [Facebook](https://publishq.com/facebook-scheduler): Text, Images, Videos, Reels, Stories
- [Threads](https://publishq.com/threads-scheduler): Text, Images, Videos
- [Bluesky](https://publishq.com/bluesky-scheduler): Text, Images, Videos
## Features
- [API & Developer Tools](https://publishq.com/features/api): Schedule posts, manage accounts, and upload media programmatically. Build your own integrations, automate workflows, or connect PublishQ to your existing tools.
- [Write Once, Post Everywhere](https://publishq.com/features/multi-platform-publishing): Write one post, add photos and watch it take shape for Facebook, Instagram, Threads and every other platform as you type. Then publish everywhere at once.
- [All Your Numbers, One Dashboard](https://publishq.com/features/analytics): See which platforms drive results so you can double down on what works. Track subscribers, views, likes, and engagement across every connected account.
- [All Your Media in One Place](https://publishq.com/features/media-library): Drop in videos up to 4 GB and images up to 50 MB, sort them into folders, find any file by name, type or size, and attach it to any post. Carousels and captioned videos land here too.
- [AI-Generated Shorts in 30 seconds](https://publishq.com/features/ai-video-creation): Turn an idea into a ready-to-post short video. Pick a template, let AI do the rest, and schedule it without leaving PublishQ.
- [A Workspace for Every Brand](https://publishq.com/features/workspaces): Group your social accounts by brand, client or project, then post, filter and read the numbers one workspace at a time, or across all of them.
## Pricing
- Free: $0
- Solo: $14/month
- Starter: $29/month
- Professional: $49/month
- Business: $99/month
All plans include API, CLI, and MCP access. Full pricing details: [pricing.md](https://publishq.com/pricing.md)
## Who It's For
- Solo creators posting to multiple platforms daily
- Agencies managing multiple client workspaces
- Marketing teams scheduling content in advance
- Developers and AI agents automating social media via API, CLI, or MCP
## For AI Agents
An AI agent can publish and schedule to any connected account. It signs the
user in through their browser: run `pq login --no-wait`, give the user the link
and code it prints, and run `pq login` once they approve. MCP clients can add
https://publishq.com/mcp, which signs in by itself. Never ask for an API key in
the chat. Setup instructions for whichever client you
run in, addressed to the agent itself, are at
[/agents](https://publishq.com/agents).
- [MCP](https://publishq.com/social-media-mcp): One MCP server gives any MCP client tools to list your connected social accounts, upload media, and publish or schedule posts.
- [CLI](https://publishq.com/social-media-cli): Install @publishq/cli, sign in through your browser and post from a shell. JSON output by default, one command per action, and PUBLISHQ_API_KEY for CI and cron.
- [SDK](https://publishq.com/social-media-sdk): Install @publishq/sdk for typed calls that publish to Instagram, TikTok, YouTube, X, LinkedIn, Facebook, Threads and Bluesky from Node or your own agent.
- [REST API](https://publishq.com/social-media-api): A REST API that publishes to Instagram, TikTok, YouTube, X, LinkedIn, Facebook, Threads and Bluesky. One POST fans out, and the OpenAPI spec is public.
Setup for a specific agent: [OpenClaw](https://publishq.com/openclaw), [Hermes Agent](https://publishq.com/hermes-agent), [Muse](https://publishq.com/muse), [ChatGPT dots](https://publishq.com/chatgpt-dots), [Claude Cowork](https://publishq.com/claude-cowork), [Manus](https://publishq.com/manus), [Perplexity Computer](https://publishq.com/perplexity-computer), [Grok Bot](https://publishq.com/grok-bot), [Claude Code](https://publishq.com/claude-code), [Codex](https://publishq.com/codex), [Cursor](https://publishq.com/cursor), [Kiro](https://publishq.com/kiro), [Gemini CLI](https://publishq.com/gemini-cli), [Kimi Code](https://publishq.com/kimi-code).
How-to documentation: [CLI](https://publishq.com/docs/cli), [MCP server](https://publishq.com/docs/mcp), [SDK](https://publishq.com/docs/sdk).
## Links
- [Features](https://publishq.com/features)
- [API Documentation](https://publishq.com/docs)
- [AI agent setup](https://publishq.com/agents)
- [Blog](https://publishq.com/blog)
- [Register](https://publishq.com/register)
- [Machine-readable pricing](https://publishq.com/pricing.md)
- [OpenAPI specification](https://publishq.com/openapi.yaml)
## API Documentation
The complete machine-readable API contract is the OpenAPI 3.1 document at
[openapi.yaml](https://publishq.com/openapi.yaml) — every endpoint, request
body, response shape, and error code. Each page below is also available as raw
markdown by appending `.mdx` to its URL.
# Docs
- [Quick Start](/docs): Get up and running with the PublishQ API in under 5 minutes. Create an API key, connect your accounts, and schedule your first post.
- [Media uploads](/docs/media-uploads): Upload images and videos to PublishQ and attach them to your posts. Send the file in one request, or straight to storage for files up to 4 GB.
- [Media folders](/docs/media-folders): Organize your media library into folders through the API, SDK, CLI or MCP server. List folders, upload into one, move files, rename and delete folders.
- **Tools**
- [MCP Server](/docs/mcp): Run the PublishQ MCP server so any MCP client can list your connected accounts, upload media, and schedule posts across your social platforms.
- [CLI](/docs/cli): Install the PublishQ CLI to schedule posts, upload media, and read your connected accounts from a shell, a CI job, or an AI agent with terminal access.
- [SDK](/docs/sdk): Install the PublishQ SDK for typed access to posts, accounts, media, and workspaces from a backend, a cron job, or an agent you built yourself.
- **Posts**
- [List posts](/docs/posts/list-posts): Returns a paginated list of the posts you created through PublishQ. Posts imported from a connected platform are excluded by default; pass includeImported=true to get both, or onlyImported=true for only the imported ones.
- [Get post](/docs/posts/get-post): Get one post by its PublishQ post ID. Returns the post details and the connected account metadata needed to identify where it belongs.
- [Create posts](/docs/posts/create-posts): Creates a post for one or more connected accounts.
- [Update post](/docs/posts/update-post): Update a draft or scheduled post. You can change the content, the scheduled date, or both. Published and publishing posts cannot be updated.
- [Remove account from post](/docs/posts/remove-account-from-post): Removes one account from an existing post so it will no longer be published there. Other accounts in the same post are not changed.
- [Delete post](/docs/posts/delete-post): Deletes a scheduled or draft post by its ID. Returns no body on success.
- **Accounts**
- [List accounts](/docs/accounts/list-accounts): List connected social accounts for the authenticated API key owner. You can filter by workspace and by one or more platforms.
- [Get TikTok creator info](/docs/accounts/get-tiktok-creator-info): Returns the TikTok creator's current privacy options, interaction settings, and maximum video duration. Call this before posting to TikTok — the `privacyLevel` you set must match one of the returned `privacyLevelOptions`.
- **Media**
- [List media](/docs/media/list-media): Return your uploaded and generated media files. You can filter by ID, type, and source before reusing them in posts.
- [Get media](/docs/media/get-media): Return one media file by ID, including its URL, source, and usage count.
- [Upload media](/docs/media/upload-media): Upload a file smaller than 100 MB in a single request. It is the simplest way to upload: one call returns a media ID you can attach to posts. For bigger files, use Create media upload. Add `folderPath` to the query string to put the file in a folder.
- [Create media upload](/docs/media/create-media-upload): Upload a file of up to 4 GB (500 MB on the Free plan) straight to storage:
1. Call this endpoint with `filename`, `contentType` and `fileSize`. You get back an `id` and an `uploadUrl`.
2. `PUT` the file to `uploadUrl` with the same `Content-Type` header. Storage answers `200`, or `403` if the file is not exactly `fileSize` bytes.
3. Optional: call Complete media upload to add the file to your media library now.
4. Put the `id` in `mediaIds` when you create or update a post.
- [Delete media](/docs/media/delete-media): Deletes a media file from your media library and from storage. Returns no body on success. A file attached to a draft or scheduled post, or used as its thumbnail, is refused with 409 until that post is published or deleted. Posts already published on a platform are not affected.
- [List media folders](/docs/media/list-media-folders): Return every folder in your media library with the number of files in it and its subfolders. Use a folder path with `folderPath` to list, upload or move files.
- [Move media](/docs/media/move-media): Move media files to a folder, or to the top level with `folderPath: null`. Moving files into a folder that does not exist yet creates it. Folder names ignore capitals, so a path that differs only in capitals from an existing folder is refused with 409. Posts use media ids, so moving a file never changes a post.
- [Rename media folder](/docs/media/rename-media-folder): Rename a folder. Its files and subfolders keep their place inside it. Answers 404 when no folder has that path, and 409 when a folder with the new name already exists at the same level, so two folders are never merged by accident.
- [Preview media folder deletion](/docs/media/preview-media-folder-deletion): Count what deleting a folder would remove: its files and subfolders at every level, and the files that are kept because a draft or scheduled post still uses them. Show these numbers to the user, then send `fileCount` to Delete media folder. Answers 404 when no folder has that path.
- [Delete media folder](/docs/media/delete-media-folder): Delete a folder with every file in it and in its subfolders, from the media library and from storage. This cannot be undone. Files a draft or scheduled post still uses are kept, so that post can still publish. Call Preview media folder deletion first and send its `fileCount` as `expectedFileCount`: if the folder changed since, nothing is deleted and the response is 409 with the new counts.
- [Complete media upload](/docs/media/complete-media-upload): Optional. Adds a file uploaded through Create media upload to your media library now and returns it. Without this call the file is added the first time you use its id in a post, and an upload nobody completes or uses within 1 day expires. Send `folderPath` to put the file in a folder; calling it again with another `folderPath` moves the file.
- **Workspaces**
- [List workspaces](/docs/workspaces/list-workspaces): Return your workspaces, including their names, colors, and account counts.
- [Get workspace](/docs/workspaces/get-workspace): Return one workspace by ID, including its name, color, description, and account count.
- [Create workspace](/docs/workspaces/create-workspace): Create a workspace to organize your connected social accounts.
- **Platforms**
- [YouTube API](/docs/platforms/youtube-api): Upload videos to YouTube through the PublishQ API with full metadata control: title, description, custom thumbnail, privacy, tags, COPPA, and AI disclosure.
- [TikTok API](/docs/platforms/tiktok-api): Post videos and photo carousels to TikTok through the PublishQ API.
- [Instagram API](/docs/platforms/instagram-api): Post images, videos, reels, stories, and carousels to Instagram through the PublishQ API.
- [Facebook API](/docs/platforms/facebook-api): Post text, photos, reels, stories, and multi-photo albums to Facebook Pages through the PublishQ API.
- [Threads API](/docs/platforms/threads-api): Post text, images, videos, and carousels to Threads through the PublishQ API.
- [X (Twitter) API](/docs/platforms/twitter-api): Post text, images, videos, GIFs, and polls to X (Twitter) through the PublishQ API with reply controls, community posting, and quote tweets.
- [Bluesky API](/docs/platforms/bluesky-api): Post text, images, and videos to Bluesky through the PublishQ API.
- [LinkedIn API](/docs/platforms/linkedin-api): Post text, photos, videos, and GIFs to LinkedIn profiles and company pages through the PublishQ API.