# Reelspan > One API to publish videos, photos and text to 22 social networks (TikTok, YouTube, Instagram, Facebook, X, Threads, LinkedIn, Pinterest, Bluesky, Reddit, Google Business, Telegram, Discord, Slack, Mastodon, Nostr, Lemmy, Dev.to, Hashnode, WordPress, Whop, Listmonk), schedule it, and read how each post did. API base: https://api.reelspan.com/v1 · Auth: Authorization: Bearer · OpenAPI: https://api.reelspan.com/openapi.json · MCP: https://api.reelspan.com/mcp · All docs in one file: https://docs.reelspan.com/llms-full.txt ## Get started - [Introduction](https://docs.reelspan.com/introduction.md): Reelspan is one API that publishes your videos, photos and text to 22 social networks, schedules them, and tells you how each post did. - [Quickstart](https://docs.reelspan.com/quickstart.md): Go from no API key to a live post in a few minutes. Create a key and a profile, connect an account, publish, and read each network's result. - [API overview](https://docs.reelspan.com/api/overview.md): How the Reelspan API works - base URL, API keys, multipart and JSON bodies, response and error shapes, status codes, idempotency, rate limits, paging and ids. - [SDKs](https://docs.reelspan.com/sdks.md): The official Reelspan clients for Node.js, TypeScript and Python - install, configure, call every endpoint, and get retries, idempotent posts and webhook checks built in. - [Migrate from Upload-Post](https://docs.reelspan.com/migrate-from-upload-post.md): Move an Upload-Post integration to Reelspan - the endpoint map, the auth header change, the field names that differ, and what you gain on the way. ## Publish - [Post a video](https://docs.reelspan.com/api/post-video.md): Upload one video and publish it to any of 22 networks at once, now, at a set time, in the queue, or on repeat, with each network's own settings. - [Post photos](https://docs.reelspan.com/api/post-photos.md): Publish one photo or a carousel of up to 35 to Instagram, TikTok, Pinterest, X, LinkedIn and more at once, with alt text and per-network crops. - [Post text](https://docs.reelspan.com/api/post-text.md): Publish a text-only post to X, Threads, Bluesky, LinkedIn, Facebook, Reddit, Mastodon and more in one call, with JSON or form fields. Long posts become threads. - [Post a document](https://docs.reelspan.com/api/post-document.md): Publish a PDF, PowerPoint or Word file to LinkedIn as a swipeable document post, from a file, a link or an earlier upload, now or scheduled. - [Upload media](https://docs.reelspan.com/api/upload-media.md): Upload a video, photo or document once and get a media_id to post it many times, and send files over 100 MB straight to storage in parts. ## After you post - [Post status](https://docs.reelspan.com/api/post-status.md): Check where a post stands on each network - live with its URL, failed with a reason, or still working - by request_id or by a scheduled post's job_id. - [History](https://docs.reelspan.com/api/history.md): List every post Reelspan has published or tried, one row per network, filtered by network, outcome, profile, id or date, newest first. - [Retry](https://docs.reelspan.com/api/retry.md): Send a post again to only the networks that failed, now or at a set time, with the media it already has, after fixing a caption or setting if needed. - [Unpublish a post](https://docs.reelspan.com/api/unpublish.md): Delete a live post from the network itself, on Facebook, LinkedIn, X, Pinterest, Bluesky, Google Business, Discord, Telegram, Mastodon or WordPress. - [Edit a post](https://docs.reelspan.com/api/edit-post.md): Change the text of a post that is already live, and some settings such as a Pin's link or a WordPress status, on the networks that allow edits. - [Repost](https://docs.reelspan.com/api/repost.md): Share a post again from a profile's account, as a LinkedIn reshare with commentary, an X or Threads repost, a Bluesky repost or a Mastodon boost. - [YouTube thumbnail](https://docs.reelspan.com/api/youtube-thumbnail.md): Set a new custom thumbnail on a YouTube video that is already published, from a file, a public link or an earlier upload, by video id or request_id. - [Publishing limits](https://docs.reelspan.com/api/publishing-limits.md): See how many more posts a profile's Instagram and Threads accounts may publish in the next 24 hours, read live from each network's own quota. - [Scheduled posts](https://docs.reelspan.com/api/scheduled-posts.md): List the posts waiting to go out, preview their media, move one to a new time, change its caption, settings or cover, or cancel it and get credits back. - [Queue](https://docs.reelspan.com/api/queue.md): Give each profile a posting schedule of days and times, then add posts with add_to_queue and they take the next free slot. Preview slots and block busy ones. - [Approval links](https://docs.reelspan.com/api/approval-links.md): Send scheduled posts to a client as one link they open without an account. Each post waits for their approval, and they can ask for changes instead. - [Webhooks](https://docs.reelspan.com/webhooks.md): Get a signed POST on your server as each network's post goes live or fails, and when accounts connect or need reconnecting. Events, payloads, signatures, retries. ## Accounts - [Authentication](https://docs.reelspan.com/authentication.md): Create a Reelspan API key, send it as a Bearer token, limit it to scopes and profiles, set it to expire, and use test keys that never publish. - [Current account](https://docs.reelspan.com/api/me.md): Check that an API key works and read the workspace's plan, plus how many uploads it has used this month against the plan's limit. - [Preferences](https://docs.reelspan.com/api/preferences.md): Read and change the workspace preferences - the day weeks start on, and the default time zone a post's scheduled_date is read in. - [Profiles](https://docs.reelspan.com/api/profiles.md): Create, list, rename and delete profiles. A profile is the brand or client you post as, with one connected account per network. - [Connecting accounts](https://docs.reelspan.com/connecting-accounts.md): Connect social accounts to a profile from the dashboard, through a white-label link for your clients, or through the API, and reconnect or disconnect them. - [Connect with credentials](https://docs.reelspan.com/api/connect-credentials.md): Connect Bluesky, Telegram, Discord, Slack, Mastodon, WordPress, Dev.to, Hashnode, Lemmy, Listmonk, Whop or Nostr to a profile with a token, key or webhook. - [White-label connect](https://docs.reelspan.com/white-label.md): Let your clients connect their own social accounts to a profile through a branded hosted page, or through your own connect page built on the Connect API. ## Media and analytics - [Media library](https://docs.reelspan.com/api/library.md): Keep uploaded videos, photos and PDFs in your media library, import them from Google Drive or Dropbox, and post them again by media_id. - [Analytics](https://docs.reelspan.com/api/analytics.md): Read follower counts and account totals per network, how they changed, their daily history, total impressions, and the likes and views of each post. - [Best times to post](https://docs.reelspan.com/api/best-times.md): Find the hours and weekdays when a profile's posts do best on each network, worked out from your own published posts, in any time zone. - [Reports](https://docs.reelspan.com/api/reports.md): Get a profile's report for a period, with posts published and failed, interactions and views per network, follower growth, and the top five posts. - [AI captions](https://docs.reelspan.com/api/ai-captions.md): Have AI write a title or caption for each network from a video, photos or your own text, within each network's limits. Each call uses one AI credit. ## Networks - [Post to TikTok](https://docs.reelspan.com/networks/tiktok.md): Post videos and photo carousels to TikTok through the API, directly or to the TikTok inbox, with privacy, interaction and disclosure settings. - [Post to Instagram](https://docs.reelspan.com/networks/instagram.md): Publish Instagram Reels, Stories, photo posts and carousels through the API, with collaborators, cover images, trial Reels and alt text. - [Post to YouTube](https://docs.reelspan.com/networks/youtube.md): Upload YouTube Shorts and long-form videos through the API, with title, tags, privacy, scheduled release, playlists and a custom thumbnail. - [Post to Facebook](https://docs.reelspan.com/networks/facebook.md): Publish Reels, Page videos, photo posts, Stories and text posts to your Facebook Pages through the API, choose the Page, and edit or delete posts. - [Post to X](https://docs.reelspan.com/networks/x.md): Post to X (Twitter) through the API: videos, up to 4 photos, text, threads and polls, with quotes, replies, link handling, and edits after posting. - [Post to Threads](https://docs.reelspan.com/networks/threads.md): Publish to Threads through the API: text posts, polls, videos, photos and carousels of up to 20 items, with replies, quotes, topic tags and reposts. - [Post to LinkedIn](https://docs.reelspan.com/networks/linkedin.md): Publish LinkedIn posts through the API, as text, video, up to 20 images or a document carousel (PDF, PowerPoint, Word), with visibility and reshare settings. - [Post to Pinterest](https://docs.reelspan.com/networks/pinterest.md): Create Pinterest video, image and carousel Pins through the API on the board and section you choose, save Pins to boards, and edit or delete them. - [Post to Bluesky](https://docs.reelspan.com/networks/bluesky.md): Post to Bluesky through the API with videos, up to 4 images or text, as threads, replies or quotes, with labels, reply and quote controls, and reposts. - [Post to Reddit](https://docs.reelspan.com/networks/reddit.md): Submit video, image and text posts to a subreddit through the API, with a title, flair, NSFW and spoiler tags, and list the account's posts with their scores. - [Post to Google Business](https://docs.reelspan.com/networks/google-business.md): Publish updates, events and offers to your Google Business Profile through the API, with a photo, a button, and the location you choose. - [Post to Telegram](https://docs.reelspan.com/networks/telegram.md): Publish videos, photo albums and text to a Telegram channel or group through your own bot, connected with a bot token and the chat. - [Post to Discord](https://docs.reelspan.com/networks/discord.md): Publish messages with videos, photos or text to a Discord channel through a channel webhook, connected by pasting its URL. - [Post to Slack](https://docs.reelspan.com/networks/slack.md): Publish messages, photos, videos and files to a Slack channel, through an Incoming Webhook or a bot token that uploads files into the channel. - [Post to Mastodon](https://docs.reelspan.com/networks/mastodon.md): Publish posts with a video, up to 4 images, or text to any Mastodon server, with visibility, content warnings and alt text. - [Post to Nostr](https://docs.reelspan.com/networks/nostr.md): Publish signed Nostr notes with video, photos or text to your relays, with media hosted on nostr.build and shown inline by most clients. - [Post to Lemmy](https://docs.reelspan.com/networks/lemmy.md): Publish posts with an image, a video or text to a Lemmy community on any server, with a title, a body and an NSFW flag. - [Post to Dev.to](https://docs.reelspan.com/networks/devto.md): Publish Markdown articles to Dev.to with tags and a canonical URL, published at once or saved as a draft, connected with an API key. - [Post to Hashnode](https://docs.reelspan.com/networks/hashnode.md): Publish Markdown articles to your Hashnode blog with tags and a canonical URL, connected with a personal access token. - [Post to WordPress](https://docs.reelspan.com/networks/wordpress.md): Publish blog posts to a self-hosted WordPress site with the video or photos embedded, published at once or saved as a draft. - [Post to Whop](https://docs.reelspan.com/networks/whop.md): Publish forum posts with videos, photos or text to your Whop company's forums, with an optional title and pinning, through a company API key. - [Post to Listmonk](https://docs.reelspan.com/networks/listmonk.md): Send each post as a Listmonk newsletter campaign to a list, with photos in the email, sent at once or saved as a draft campaign. ## Guides - [Async posts](https://docs.reelspan.com/guides/async-uploads.md): Send a post with async_upload=true to get a request_id at once, then follow each network's result by polling status or receiving a webhook. - [Large files](https://docs.reelspan.com/guides/large-files.md): Send videos over 100 MB with a direct multipart upload to storage, know your plan's file size limit, and post from public URLs, Google Drive or Dropbox links. - [Retrying safely](https://docs.reelspan.com/guides/idempotency.md): Use an Idempotency-Key header or your own request_id so a post retried after a timeout or network error is never published twice. - [Test mode](https://docs.reelspan.com/guides/test-mode.md): Use an rs_test_ key to run posts through every check without publishing or using uploads, and the sandbox network to rehearse results and failures. - [Scheduling and repeats](https://docs.reelspan.com/guides/scheduling.md): Schedule a post for a set time in any timezone, add it to a profile's queue, repeat it daily, weekly or monthly, and edit, cancel or hold it for approval. - [AI content labels](https://docs.reelspan.com/guides/ai-content-labeling.md): Mark a post as AI-generated with is_ai_generated and Reelspan sets the label on TikTok, YouTube and Threads, plus TikTok's brand content disclosure. - [Errors](https://docs.reelspan.com/errors.md): Every error the Reelspan API returns: the error body, HTTP statuses, request error codes and per-network result codes for TikTok, YouTube, Instagram and more. - [Rate limits](https://docs.reelspan.com/rate-limits.md): Reelspan API rate limits per plan, the X-RateLimit headers on every response, what a 429 looks like, and how often to poll for post status. ## Integrations - [MCP server](https://docs.reelspan.com/integrations/mcp.md): Connect Claude, ChatGPT, Cursor, VS Code or any MCP client to Reelspan so your AI agent can publish, schedule and check posts on 22 networks. - [n8n](https://docs.reelspan.com/integrations/n8n.md): Post videos and text to 22 networks from an n8n workflow with the HTTP Request node, then check each network's result by polling or with a webhook. - [Make](https://docs.reelspan.com/integrations/make.md): Publish videos and text to 22 networks from a Make scenario with the HTTP "Make a request" module, then read each network's result by polling or webhook. - [Zapier](https://docs.reelspan.com/integrations/zapier.md): Publish videos and text to 22 networks from a Zap with a Code by Zapier step, and catch each network's result with Webhooks by Zapier. - [Airtable](https://docs.reelspan.com/integrations/airtable.md): Publish a video from an Airtable record to 22 networks with a scripting extension script, and write the request ID and each network's result back to the record. - [Postman](https://docs.reelspan.com/integrations/postman.md): Import Reelspan's Postman collection, set your API key once, and try every endpoint, with environments to switch between a test key and a live one. - [LangChain](https://docs.reelspan.com/integrations/langchain.md): Give a LangChain agent Reelspan's publishing tools through the hosted MCP server, with your API key, and let it post, schedule and check results. - [Vercel AI SDK](https://docs.reelspan.com/integrations/vercel-ai-sdk.md): Connect the Vercel AI SDK's MCP client to Reelspan's hosted MCP server and let generateText or streamText publish, schedule and check social posts. - [OpenAI Agents SDK](https://docs.reelspan.com/integrations/openai-agents-sdk.md): Connect an OpenAI Agents SDK agent to Reelspan's hosted MCP server over Streamable HTTP so it can publish, schedule and check social posts. - [CrewAI](https://docs.reelspan.com/integrations/crewai.md): Give CrewAI agents Reelspan's publishing tools through the hosted MCP server so a crew can post, schedule and check social media results. - [Mastra](https://docs.reelspan.com/integrations/mastra.md): Connect a Mastra agent to Reelspan's hosted MCP server with MCPClient so it can publish, schedule and check posts on 22 social networks. - [Google ADK](https://docs.reelspan.com/integrations/google-adk.md): Give a Google Agent Development Kit agent Reelspan's publishing tools with McpToolset and the hosted MCP server, to post and check social media results. - [Pydantic AI](https://docs.reelspan.com/integrations/pydantic-ai.md): Connect a Pydantic AI agent to Reelspan's hosted MCP server with MCPToolset so it can publish, schedule and check posts on 22 social networks. - [LlamaIndex](https://docs.reelspan.com/integrations/llamaindex.md): Turn Reelspan's hosted MCP server into LlamaIndex tools with McpToolSpec, and let a FunctionAgent publish, schedule and check social posts. - [smolagents](https://docs.reelspan.com/integrations/smolagents.md): Load Reelspan's publishing tools into a Hugging Face smolagents agent with MCPClient and the hosted MCP server, to post and check social media results. ## Limits - [Video requirements](https://docs.reelspan.com/limits/video.md): Video formats, file sizes and per-network limits for posting video through Reelspan: what Reelspan checks, what it adjusts, and what each network decides. - [Photo requirements](https://docs.reelspan.com/limits/photos.md): Photo formats, sizes and per-network carousel limits for Reelspan photo posts, and how Reelspan converts or trims photos so each network accepts them. - [Character limits](https://docs.reelspan.com/limits/characters.md): Caption, title and text limits for every network Reelspan posts to, which field carries each, and what Reelspan does with text that is too long. - [Network posting limits](https://docs.reelspan.com/limits/network-limits.md): The daily posting caps and quotas TikTok, YouTube, Instagram, Threads, Bluesky and X set on API posts, and the error code Reelspan returns for each. - [Plans and limits](https://docs.reelspan.com/limits/plans.md): What each Reelspan plan includes: monthly uploads, profiles, seats, file sizes, library storage, AI caption credits, API rate limits and white-label. ## Resources - [Troubleshooting](https://docs.reelspan.com/troubleshooting.md): Fix common Reelspan problems by symptom: reconnecting accounts, TikTok privacy, Instagram processing, YouTube quota, large files and rate limits. - [FAQ](https://docs.reelspan.com/faq.md): Answers to common Reelspan questions on connecting accounts, limits, uploads, scheduling, errors, test mode, white-label and moving from Upload-Post. - [Versioning](https://docs.reelspan.com/versioning.md): How the Reelspan API changes: what can change in v1 at any time, what counts as breaking, the notice and 12-month overlap you get, and SDK versions. - [Support](https://docs.reelspan.com/support.md): How to get help with Reelspan: email support, check the live status page, report a security problem, and what to include so we can fix it fast.