# Reeling Developer Portal — Social Media Publishing API & MCP Server

> Complete REST API v1 and Model Context Protocol (MCP) documentation for programmatic social video, thread, and article publishing across 15 platforms.

Canonical: https://reeling.app/developers
Last updated: 2026-10-25

## Overview & Base URLs

Reeling exposes a REST API v1 and a 20-tool Model Context Protocol (MCP) server for programmatic social publishing, 3/Day Reddit Stealth Anti-Sell Autopilot, 2-Pass Wikipedia 24-Pattern Humanizer, pre-publish spam checking, community question discovery, and analytics.

- **REST API Base URL**: `https://api.reeling.app/api/v1`
- **OpenAPI 3.0.3 Specification**: [https://reeling.app/.well-known/openapi.json](https://reeling.app/.well-known/openapi.json) (also live at `https://api.reeling.app/api/v1/openapi.json`)
- **Hosted MCP Server (Streamable HTTP)**: `https://mcp.reeling.app/mcp`
- **Local MCP Server (stdio)**: `npx -y github:yomariano/reeling-mcp#v1.0.1`
- **MCP Discovery Manifest**: [https://reeling.app/.well-known/mcp.json](https://reeling.app/.well-known/mcp.json)
- **Runnable Examples Repository**: [https://github.com/yomariano/reeling-examples](https://github.com/yomariano/reeling-examples)

## Authentication & Rate Limits

Authenticate all REST API v1 requests with the `X-API-Key` header (available on Creator $19/mo for 5,000 requests/month and Agency $39/mo for 50,000 requests/month). Keep API keys in secret environment variables—never in client-side code or URL query strings.

```bash
curl -sS https://api.reeling.app/api/v1/projects \
  -H "X-API-Key: $REELING_API_KEY"
```

## Core REST API v1 Endpoints

| Method | Endpoint | Purpose |
| --- | --- | --- |
| GET | /api/v1/projects | List workspaces accessible to the X-API-Key |
| GET | /api/v1/channels?projectId={uuid} | List connected channel IDs and capability flags |
| GET | /api/v1/platforms | Return static 15-platform specification matrix |
| GET | /api/v1/channels/:platform/options | Fetch dynamic creator info (e.g. TikTok privacy_level_options) |
| POST | /api/v1/posts/check-spam | Run deterministic 0–100 Pre-Publish Spam & Shadowban check |
| POST | /api/v1/publish | Publish immediately or schedule across selected channels |
| GET | /api/v1/posts/:id/status | Inspect per-platform delivery status and live permalinks |
| GET | /api/v1/community/cadence | Fetch X (<5 Replies), Reddit (100% Reply-Only, 0 top-level posts), and Quora AEO cadence status |
| POST | /api/v1/community/discover | Discover live X (<5 replies), Reddit (20–90m old threads), and Quora AEO questions |
| POST | /api/v1/community/draft-answer | Draft Stealth Anti-Sell, Smart Mix, or Pure Karma reply + 2-Pass Wikipedia Humanizer |
| POST | /api/v1/community/autopilot | Schedule 3 Reddit replies/day × N days on autopilot (10:15 AM, 2:30 PM, 6:45 PM) |
| POST | /api/v1/community/humanize | 2-Pass Wikipedia 24-Pattern AI Humanizer (Audit AI tells + Rewrite) |
| GET | /api/v1/analytics | Retrieve cross-platform post metrics |
| POST | /api/v1/analytics/sync | Trigger live metrics sync from platform APIs |
| GET | /api/v1/inbox | List unified comments across YouTube, Instagram, FB, LinkedIn, X, Bluesky, Reddit |
| POST | /api/v1/inbox/:commentId/reply | Reply natively to a comment |

## Platform Rules & Availability Matrix (Reviewed 2026-10-15)

Reeling implementation coverage, not a guarantee that an individual account is authorized. Check Connect Channels and returned capabilities before publishing.

| Platform | Publishing Scope | Inbox Support | Metrics Scope | Documented Limits |
| --- | --- | --- | --- | --- |
| [YouTube](https://reeling.app/integrations/youtube) | Video upload; choose privacy and audience settings. Public uploads depend on the connected channel and the app's current capability. | Read comments and reply, with the required Google permissions. | Video views, likes and comment counts; shares are not fetched. | 100 MiB; MP4, MOV or WebM. Title: 100 characters. |
| [TikTok](https://reeling.app/integrations/tiktok) | Inbox delivery requires finishing the post in TikTok. Public Direct Post is awaiting TikTok audit; inspect creator options before using direct mode. | Comment reading and replies are not implemented. | Delivery status only; engagement and view metrics are not fetched. | 100 MiB; MP4, MOV or WebM. Duration and interactions depend on creator options. |
| [Instagram](https://reeling.app/integrations/instagram) | Reels for Business or Creator accounts you own or manage, currently with tester access. | Read comments and reply, subject to permissions. | Likes, comments and available Insights views/reach/shares; missing permissions can leave metrics unavailable. | 100 MiB; MP4 or MOV. Caption: 2,200 characters. |
| [Facebook](https://reeling.app/integrations/facebook) | Video publishing to a Page with admin/publishing permission; not personal-profile publishing. | Not implemented. | Not fetched. | 100 MiB; MP4 or MOV. Description: 5,000 characters. |
| [LinkedIn](https://reeling.app/integrations/linkedin) | Video publishing through an authorized connection. Company pages require Community Management API approval; review is in progress. | Not implemented. | Not fetched. | 100 MiB; MP4, MOV or WebM. |
| [Threads](https://reeling.app/integrations/threads) | Video container publishing through an authorized Threads profile. Development-mode accounts may need tester access. | Comment reading and replies are not implemented. | Available Insights views, likes, replies, reposts and quotes. | 100 MiB; MP4 or MOV. Text: 500 characters. |
| [Pinterest](https://reeling.app/integrations/pinterest) | Video Pin to a selected board. Production publishing needs appropriate Pinterest app access; Trial access can reject Pin creation. | Not implemented. | Not fetched. | 100 MiB; MP4 or MOV. Title: 100; description: 500 characters. |
| [Bluesky](https://reeling.app/integrations/bluesky) | Video post using your handle and app password; video upload requires a verified Bluesky email. | Read replies and reply to a thread. | Likes, replies, reposts and quotes. The current views field is an interaction total, not measured impressions. | 50 MiB; MP4, MOV or WebM. Text: 300 characters. |
| [X (Twitter)](https://reeling.app/integrations/x) | Publish via the Reeling Companion Chrome extension through your authenticated x.com browser session (or via X OAuth API with write permission). | Not implemented. | Not fetched. | 280 weighted characters (or up to 25,000 on X Premium via Companion). |
| [Telegram](https://reeling.app/integrations/telegram) | Video via a bot with posting rights in the chosen chat or channel; a private chat is not a public backlink. | Not implemented. | Not fetched. | 50 MiB; MP4, MOV or WebM. Caption: 1,024 characters. |
| [Discord](https://reeling.app/integrations/discord) | Video/message to the channel belonging to your incoming webhook. Visibility follows that channel's access controls. | Not implemented. | Not fetched. | 25 MiB advertised capability; server/channel limits may be lower. Content: 2,000 characters. |
| [Mastodon](https://reeling.app/integrations/mastodon) | Video status using an instance URL and access token; instance permissions and limits apply. | Not implemented. | Not fetched. | 40 MiB advertised capability; use that conservative cap. Text: 500 characters in this integration. |
| [Reddit](https://reeling.app/integrations/reddit) | Submission via Reeling Companion Chrome extension (or Reddit OAuth). Includes Pre-Publish Spam & AutoModerator Detector with 1-Click Auto-Fix. | Not implemented. | Not fetched. | 100 MiB video or text post. Title: 300 characters. |
| [Medium](https://reeling.app/integrations/medium) | Story and article publishing via the Reeling Companion Chrome extension through your authenticated Medium session. Includes Pre-Publish Spam & AI Cliché Shield. | Not implemented. | Not fetched. | Full-length stories and articles; up to 5 comma-separated topic tags. |
| [Quora](https://reeling.app/integrations/quora) | Answer and share publishing via the Reeling Companion Chrome extension through your authenticated Quora session. Includes Pre-Publish 'Burden of Proof' Spam Detector. | Not implemented. | Not fetched. | Standalone posts and shares; 75+ words recommended when including external links. |

## Developer Guides

- [Reeling MCP server setup](https://reeling.app/developers/mcp) - Connect Claude, Cursor or your MCP client to Reeling. Configure local or hosted transport, verify account reads and review publishing actions.
- [Reeling publishing API reference](https://reeling.app/developers/api) - Use the Reeling REST API to discover projects and channels, draft a video request and inspect delivery status with executable examples.
- [Social publishing API requirements](https://reeling.app/developers/social-publishing-api) - Compare Reeling’s YouTube, TikTok and Instagram publishing workflows, visibility controls, account requirements and delivery checks.
- [Reeling API and MCP examples](https://reeling.app/developers/examples) - Run tested examples for account discovery, video request drafts, status polling and analytics. Start offline, then opt in to authenticated requests.
- [Social publishing workflow lab](https://reeling.app/developers/workflow-lab) - Reproduce Reeling request drafting, delivery checks and timeout recovery with runnable examples and dated public MCP observations.
- [API security, OAuth & rate limits](https://reeling.app/developers/security) - Review Reeling REST API v1 and MCP security: SHA-256 API key hashing, AES-256-GCM OAuth token encryption, least-privilege scopes, and plan rate limits.

## Frequently Asked Questions

### How do I authenticate with the Reeling REST API and MCP server?

Authenticate all REST API requests by providing an X-API-Key: rl_live_... or Authorization: Bearer rl_live_... header. In MCP clients (Claude Desktop, Cursor), pass your key as the REELING_API_KEY environment variable. API keys are generated under Settings > API & Automation. API and MCP server access are included on Creator ($19/mo, 5,000 req/mo) and Agency ($39/mo, 50,000 req/mo) plans.

### How do I connect AI assistants (Claude, Cursor, OpenClaw) via MCP?

Configure your MCP client with the command npx and arguments ["-y", "github:yomariano/reeling-mcp#v1.0.1"] and set REELING_API_KEY in your environment. For cloud or remote agent runtimes, connect to the Streamable HTTP endpoint at https://mcp.reeling.app/mcp. Always start by verifying read access with reeling_list_projects and reeling_list_channels before enabling write tools.

### Does an HTTP 200 from POST /publish mean the post is live on social networks?

No. An HTTP 200 confirms that Reeling successfully ingested the video, uploaded it to Cloudflare R2, and enqueued the publishing task. Delivery executes asynchronously across platforms. Poll GET /api/v1/posts/:id to inspect per-platform status and retrieve public URLs. For TikTok in inbox mode, the video arrives in the creator's TikTok mobile inbox and requires in-app confirmation before publishing.

### How can I test publishing workflows safely without spending allowances or posting live?

Clone the open-source reeling-examples repository (git clone https://github.com/yomariano/reeling-examples.git) and run npm test or node examples/read-account.mjs. The examples run in offline fixture mode by default, making zero network calls. You can also download our dependency-free reeling-readonly-check.mjs script to perform authorized, read-only project and channel discovery before executing any publishing actions.

## Related

- [Reeling MCP server setup](https://reeling.app/developers/mcp)
- [Reeling publishing API reference](https://reeling.app/developers/api)
- [Social publishing API requirements](https://reeling.app/developers/social-publishing-api)
- [Reeling API and MCP examples](https://reeling.app/developers/examples)
- [Social publishing workflow lab](https://reeling.app/developers/workflow-lab)
- [API security, OAuth & rate limits](https://reeling.app/developers/security)
- [AI Plugins & Agent Skills Hub](https://reeling.app/plugins)
- [MCP Config Generator Tool](https://reeling.app/tools/mcp-config-generator)

---
Need the interactive version? Visit https://reeling.app/developers
Full site index for AI agents: https://reeling.app/llms.txt
