# Upload-Post API Documentation

> Upload-Post is a unified social media posting API: publish videos, photos, text and documents to TikTok, Instagram, YouTube, LinkedIn, Facebook, X (Twitter), Threads, Pinterest, Reddit, Bluesky, Discord, Telegram and Google Business Profile with a single REST call (POST https://api.upload-post.com/api/upload). Includes scheduling, analytics, comments/DMs, webhooks, an FFmpeg API and white-label integration.

Key entry points: [Quickstart](https://docs.upload-post.com/quickstart), [API Reference](https://docs.upload-post.com/api/reference), [OpenAPI spec](https://docs.upload-post.com/openapi.json), [MCP server](https://docs.upload-post.com/guides/mcp-server-integration). The full documentation as one markdown file: [llms-full.txt](https://docs.upload-post.com/llms-full.txt).

## Getting Started

- [Upload-Post Social Media API](https://docs.upload-post.com/introduction): Upload-Post is a unified social media posting API: publish videos, photos and text to TikTok, Instagram, YouTube, LinkedIn, X and more with one REST call.
- [Quickstart Guide](https://docs.upload-post.com/quickstart): Post your first video to TikTok or Instagram in minutes: create an API key, connect accounts and call POST /api/upload with a single curl command.
- [SDK Examples](https://docs.upload-post.com/sdk-examples): Official Upload-Post SDKs with examples: Python (pip install upload-post) and JavaScript/Node (npm install upload-post), plus raw curl requests.

## API Reference

- [AutoDM Monitors](https://docs.upload-post.com/api/autodms): Instagram AutoDM API: 24/7 monitors that auto-send a private DM to every new commenter on a post. Start, pause, resume, stop and audit monitors via REST.
- [Comments (all platforms)](https://docs.upload-post.com/api/comments): Unified Comments API: list, create and delete comments on your posts across Instagram, Facebook, YouTube and more social platforms with one REST call.
- [Connect API (Build Your Own Connect Page)](https://docs.upload-post.com/api/connect-api): Connect API: build your own social account connection page. Server-side OAuth start endpoints return the authorize URL for each platform; a single-use state authenticates the callback — no hosted page required.
- [Current User API](https://docs.upload-post.com/api/current-user): GET /api/uploadposts/me: validate your Upload-Post API key and fetch account email, plan and API usage. Quick health check for integrations.
- [FFmpeg Editor API](https://docs.upload-post.com/api/ffmpeg-editor): FFmpeg API: run your own FFmpeg command safely on Upload-Post servers. Submit a job, poll its status, then download the processed video or image.
- [Analytics API](https://docs.upload-post.com/api/get-analytics): Social media analytics API: followers, impressions, reach and per-post metrics for Instagram, TikTok, YouTube, LinkedIn, X, Facebook and more via REST.
- [Get Facebook Pages](https://docs.upload-post.com/api/get-facebook-pages): GET /api/uploadposts/facebook/pages: list every Facebook Page connected to a profile and get the page_id required to post videos and photos.
- [Get Google Business Locations](https://docs.upload-post.com/api/get-google-business-locations): GET /api/uploadposts/google-business/locations: list Google Business Profile locations of a connected account and get gbp_location_id for posting.
- [Get LinkedIn Pages](https://docs.upload-post.com/api/get-linkedin-pages): GET /api/uploadposts/linkedin/pages: list LinkedIn company pages of a connected account and get the page ID to post as an organization.
- [Get Pinterest Boards](https://docs.upload-post.com/api/get-pinterest-boards): GET /api/uploadposts/pinterest/boards: list public and secret Pinterest boards and get the board ID required to publish Pins via API.
- [Reddit Detailed Posts](https://docs.upload-post.com/api/get-reddit-detailed-posts): GET /api/uploadposts/reddit/detailed-posts fetches a connected Reddit account's posts with complete media info: images, galleries and videos.
- [Google Business Reviews](https://docs.upload-post.com/api/google-business-reviews): Google Business reviews API: list reviews and post or delete replies on a connected Google Business Profile location in real time via REST.
- [Comments](https://docs.upload-post.com/api/instagram-comments): Instagram comments API: fetch all comments on a post, send private DM replies to commenters, or post public replies, by media ID or post URL.
- [Direct Messages](https://docs.upload-post.com/api/instagram-dms): Instagram DM API: send direct messages by user ID and list DM conversations on connected accounts, within Instagram's 24-hour messaging window.
- [Media List](https://docs.upload-post.com/api/instagram-media): Media list API: GET /api/uploadposts/media returns recent posts, reels, videos, pins and tweets from Instagram, TikTok, YouTube, X and 6 more platforms.
- [Upload-Post API Overview](https://docs.upload-post.com/api/overview): Overview of the Upload-Post API: one REST API to post videos, photos and text to TikTok, Instagram, YouTube, LinkedIn, Facebook, X and 7+ more platforms.
- [Photo Format Requirements](https://docs.upload-post.com/api/photo-requirements): Photo format requirements per platform: formats, max file size, aspect ratios and carousel item limits for Instagram, TikTok, Facebook, Threads and more.
- [Retry & Unpublish](https://docs.upload-post.com/api/post-actions): Retry a failed upload without re-sending the media, or unpublish (delete) an already-published post: post-publish actions in the Upload-Post API.
- [Queue System](https://docs.upload-post.com/api/queue-system): Queue system API: add_to_queue=true auto-schedules posts to your next free time slot. Configure slots, timezone, active days and posts per slot via REST.
- [API Reference](https://docs.upload-post.com/api/reference): Complete Upload-Post API reference: upload video, photos and text, schedule posts, analytics, comments, DMs and platform endpoints for 22 social networks.
- [Manage Scheduled Posts](https://docs.upload-post.com/api/schedule-posts): Manage scheduled social posts via API: list them with GET /api/uploadposts/schedule, edit or cancel jobs created with the scheduled_date parameter.
- [Upload Document](https://docs.upload-post.com/api/upload-document): Upload PDF, PPT/PPTX and DOC/DOCX files to LinkedIn as native document posts (carousel viewer) with POST /api/upload_document.
- [Upload History](https://docs.upload-post.com/api/upload-history): GET /api/uploadposts/history: paginated history of all your social media uploads with per-platform results, job IDs and metadata.
- [Upload Photos](https://docs.upload-post.com/api/upload-photo): Photo upload API: POST /api/upload_photos publishes photos and carousels to Instagram, TikTok, Facebook, LinkedIn, X, Pinterest, Reddit and more platforms.
- [Upload Status](https://docs.upload-post.com/api/upload-status): GET /api/uploadposts/status: poll asynchronous uploads by request_id or scheduled posts by job_id and get per-platform upload results.
- [Upload Text](https://docs.upload-post.com/api/upload-text): Text post API: POST /api/upload_text publishes text posts and threads to X (Twitter), LinkedIn, Facebook, Threads, Reddit, Bluesky, Telegram and more.
- [Upload Video](https://docs.upload-post.com/api/upload-video): Video upload API: POST /api/upload publishes a video to TikTok, Instagram, YouTube, LinkedIn, Facebook, X and 9 more platforms in one multipart request.
- [User Profiles API](https://docs.upload-post.com/api/user-profiles): User Profiles API: create a profile per end user, generate JWT connect links and manage social account connections for white-label integrations.
- [Video Format Requirements](https://docs.upload-post.com/api/video-requirements): Video format requirements per platform: codecs, max size and duration for TikTok, Instagram Reels, YouTube, LinkedIn, Facebook and X, plus auto-transcode.
- [Webhooks & Notifications](https://docs.upload-post.com/api/webhooks): Webhooks API: receive real-time POST notifications for upload results and social account connection changes instead of polling the status endpoint.

## Guides

- [AI Shorts Uploader](https://docs.upload-post.com/guides/ai-shorts-uploader): AI Shorts Uploader: built-in AI that watches your short video and writes platform-specific titles, descriptions and hashtags for YouTube, Instagram, TikTok.
- [Airtable Integration](https://docs.upload-post.com/guides/airtable-integration): Post videos to TikTok, Instagram, YouTube and more straight from Airtable using an automation script and the Upload-Post API.
- [Avoid Timeouts with Asynchronous Uploads](https://docs.upload-post.com/guides/async-uploads): Avoid HTTP timeouts on large uploads: set async_upload=true, get a request_id instantly, and poll the status endpoint for per-platform results.
- [Authentication](https://docs.upload-post.com/guides/authentication): How to authenticate with the Upload-Post API: generate an API key in the dashboard and send it as 'Authorization: Apikey <key>' on every request.
- [Connecting Accounts](https://docs.upload-post.com/guides/connecting-accounts): Connect social accounts to Upload-Post: OAuth for most platforms, plus manual credentials for Discord webhooks, Telegram bots, Mastodon and WordPress.
- [API Error Handling: Upload Endpoints](https://docs.upload-post.com/guides/error-handling): How Upload-Post upload endpoints report errors: HTTP 200 with per-platform success flags, 4xx/5xx codes, and how to handle each case in your code.
- [Limit of uploads](https://docs.upload-post.com/guides/limit-of-uploads): Daily posting hard caps per connected account: TikTok 15, Instagram 50, YouTube 10, LinkedIn 150 and more, plus rolling 24h windows and 429 handling.
- [Make Integration](https://docs.upload-post.com/guides/make-integration): Post to TikTok, Instagram, YouTube and more from Make (formerly Integromat) scenarios using the Upload-Post API, connected in 3 steps.
- [MCP Server (ChatGPT / Claude / Cursor)](https://docs.upload-post.com/guides/mcp-server-integration): Connect Upload-Post's MCP server (mcp.upload-post.com/mcp) to ChatGPT, Claude or Cursor: 50 tools to publish, schedule and analyze social media by chat.
- [n8n Integration](https://docs.upload-post.com/guides/n8n-integration): Automate social posting from n8n: configure the HTTP Request node with your Upload-Post API key to upload videos to TikTok, Instagram and YouTube.
- [How to Post to Instagram with an API](https://docs.upload-post.com/guides/post-to-instagram-api): How to post Reels, photos, carousels and Stories to Instagram via API without building your own Meta app: Upload-Post's managed auth + POST /api/upload.
- [How to Post to LinkedIn with an API](https://docs.upload-post.com/guides/post-to-linkedin-api): How to post to LinkedIn via API: publish video, images, text and documents to personal profiles or company pages with one Upload-Post REST call.
- [How to Post to TikTok with an API](https://docs.upload-post.com/guides/post-to-tiktok-api): How to post a video to TikTok with an API: one curl call to Upload-Post's POST /api/upload. No TikTok developer app, review or audit required.
- [How to Post to X (Twitter) with an API](https://docs.upload-post.com/guides/post-to-x-twitter-api): How to post to X (Twitter) via API: publish tweets, auto-split threads, videos and images through Upload-Post without buying X API access yourself.
- [How to Upload Videos to YouTube with an API](https://docs.upload-post.com/guides/post-to-youtube-api): How to upload videos to YouTube via API: POST /api/upload with title, description, tags, privacyStatus and thumbnails. No Google Cloud quota setup.
- [Rate Limits & Polling Best Practices](https://docs.upload-post.com/guides/rate-limits): Upload-Post rate limits: X-RateLimit headers, recommended status-polling intervals, daily platform caps and 429 back-off best practices.
- [Error: Reached Active User Cap](https://docs.upload-post.com/guides/reached-active-user-cap-error): Fix TikTok's reached_active_user_cap error: what the daily active-user limit means and the post_mode=MEDIA_UPLOAD workaround that posts to your inbox.
- [White-label Integration](https://docs.upload-post.com/guides/user-profile-integration): White-label guide: embed Upload-Post in your SaaS. Create a profile per user, generate a JWT connect URL, and post on their behalf via the API.
- [X Links Add-on](https://docs.upload-post.com/guides/x-links-addon): X Links add-on: Upload-Post strips URLs from X (Twitter) posts by default to avoid X's 13x per-post URL fee; this add-on lets you keep clickable links.
- [Understanding YouTube API Quota Limits](https://docs.upload-post.com/guides/youtube-quota-explained): YouTube API quota explained (deprecated): Upload-Post now ships its own dedicated YouTube quota, so no Google Cloud project setup is needed anymore.

## Resources

- [Social Media Character Limits](https://docs.upload-post.com/resources/character-limits): Text limits per social network: max caption, title and description lengths for X, Instagram, TikTok, LinkedIn, YouTube, Threads, Pinterest and more.
- [Common Errors](https://docs.upload-post.com/resources/common-errors): Common Upload-Post errors and fixes: expired sessions, Instagram error 400, missing page IDs, 429 daily caps, timeouts and platform-specific failures.
- [Frequently Asked Questions](https://docs.upload-post.com/resources/faq): Answers to the most common Upload-Post questions: API keys, connecting accounts, daily limits, video sizes, carousels, scheduling, billing and white-label.
- [Pricing & Limits](https://docs.upload-post.com/resources/pricing-and-limits): Upload-Post plans and limits: Free $0 (10 uploads/mo), Basic $24/mo, Professional $50/mo, Advanced $147/mo, Business $438/mo, plus daily platform caps.
- [Support](https://docs.upload-post.com/resources/support): Get help with Upload-Post: email info@upload-post.com, X @vcaverog and GitHub, and what to include in a support request for a fast resolution.