Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.reap.video/llms.txt

Use this file to discover all available pages before exploring further.

For AI agents: a documentation index is at /llms.txt. Every page is also available as markdown, just append .md to the URL.

​
What is the Reap API?

The Reap API is an AI video automation API that turns long-form videos into short social clips, adds styled captions, reframes footage for any aspect ratio, dubs audio into 80+ languages, generates transcriptions, and publishes directly to YouTube, Instagram, TikTok, LinkedIn, and X. It runs over a REST interface with Bearer-token auth and webhook callbacks. It is the same engine that powers reap.video, exposed so developers, AI agents, and content platforms can embed clipping, captions, reframing, and dubbing into their own pipelines without building video infrastructure.

​
API Basics

  • Base URL: https://public.reap.video/api/v1/automation/
  • Auth: Authorization: Bearer YOUR_API_KEY
  • Rate limit: 10 requests / minute / key
Install Reap docs into your AI coding agent, or connect the Reap MCP so your agent can run your workspace for you: 
npx skills add https://docs.reap.video
Connect the MCP server at https://mcp.reap.video/mcp to let your agent clip, caption, reframe, dub, and publish for you directly. See MCP Server.

Quickstart

Upload a video and get clips in under 5 minutes.

Authentication

Create an API key and sign requests.

Agent Skill

Install Reap into Cursor, Claude Code, Copilot, Codex, and 30+ agents.

MCP Server

Connect your AI agent to your Reap workspace to create clips and publish via Model Context Protocol.

​
Agent Entry Points

  • Full documentation index: llms.txt
  • OpenAPI schema: openapi.json
  • Markdown pages: append .md to any docs URL, for example https://docs.reap.video/api-reference/3_quickstart.md

​
What can you build with the Reap API?

AI Video Clipping

Turn long videos into ranked short clips, steered by a natural-language prompt. See Create Clips.

Smart Reframing

Auto-track speakers and subjects to reframe 16:9 into 9:16, 1:1, or 4:5 without cropping off faces. See Create Reframe.

AI Dubbing

Voice-dub videos into 80+ languages with lip-aware timing. See Create Dubbing.

Caption Generation

Styled, emoji-highlighted captions with brand presets. See Create Captions.

Transcription

Word-level timestamped transcripts for video and audio. See Create Transcription.

Publish & Schedule

Push clips to YouTube, Instagram, TikTok, LinkedIn, and X from one endpoint. See Publish Clip.

​
Who is this API for?

  • AI agents and coding copilots (Cursor, Claude Code, Codex, Copilot, Cline, Windsurf, Gemini CLI): install the Reap Agent Skill to write integrations, or connect the MCP server so your agent can create clips and publish for you.
  • Creator platforms and SaaS tools embedding clipping, captions, or dubbing as a feature.
  • Media and publisher workflows automating short-form output from podcasts, webinars, keynotes, and long-form YouTube.
  • Enterprise content teams replacing manual editing with batch pipelines driven by webhooks.
  • Developers looking for a video clipping API, caption generation API, or AI dubbing API with real webhooks and agent support.

​
Why teams build on the Reap API

Full REST API, not a UI wrapper

Every feature in the Reap product is exposed as a stable, versioned endpoint. No scraping, no headless browser, no “contact sales for API access.”

Production-grade webhooks

Get notified the moment a project finishes. No polling loops, no wasted rate limit, no cron jobs. See Webhooks.

Agent-native distribution

Reap ships as an agent skill so Cursor, Claude Code, Copilot, and Codex can write integrations for you, and as an MCP server so your agent can create clips and publish for you.

One API, six capabilities

Clipping, captions, reframing, dubbing, transcription, and social publishing. Same auth, same project model, same webhooks.

Publish where your audience is

Push clips to YouTube, Instagram, TikTok, LinkedIn, and X from a single endpoint with per-platform settings.

Built for batch and scale

Upload once, fan out into clipping + reframe + dub jobs, and track everything through webhooks. Creator and Studio plans scale with your volume.

​
60-second example: upload, clip, and poll

# 1. Get a presigned upload URL
curl -X POST https://public.reap.video/api/v1/automation/get-upload-url \
  -H "Authorization: Bearer $REAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename":"keynote.mp4"}'
# -> { "uploadUrl": "https://...", "id": "upload_abc" }

# 2. Upload the file
curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: video/mp4" \
  --data-binary @keynote.mp4

# 3. Create a clipping project
curl -X POST https://public.reap.video/api/v1/automation/create-clips \
  -H "Authorization: Bearer $REAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "uploadId": "upload_abc",
    "genre": "talking",
    "exportResolution": 1080,
    "exportOrientation": "portrait",
    "reframeClips": true,
    "clipDurations": [[30,60],[60,90]],
    "prompt": "Highlight reel of the most quotable moments — keep clips under 60 seconds."
  }'
# -> { "id": "proj_xyz", "status": "queued" }

# 4. Poll (or use webhooks, recommended in production)
curl "https://public.reap.video/api/v1/automation/get-project-status?projectId=proj_xyz" \
  -H "Authorization: Bearer $REAP_API_KEY"
See the full walkthrough in the Quickstart Guide.

​
Install Reap into your AI coding agent

Reap meets your agent two ways. The agent skill gives it full knowledge of the API to write integrations (offline, versioned with your repo). The MCP server connects it to your workspace so it can create clips and publish directly (live, over OAuth). 
npx skills add https://docs.reap.video
Works with Cursor, Claude Code, GitHub Copilot, Codex, Cline, Amp, Gemini CLI, and 30+ agents. See Agent Skills.

​
Core concepts

Projects are containers for a video processing job: clipping, captions, reframe, dubbing, or transcription. Each project has a status (queued, processing, completed, failed, invalid, expired) and produces one or more clips, transcripts, or rendered outputs.
Before creating a project you upload a source video via a presigned S3 URL from /get-upload-url. MP4 or MOV, 2 minutes to 3 hours, up to 5 GB. Files are validated at project creation, not upload.
Clips are the output segments from a clipping project. Each has a clipUrl (presigned), title, caption, virality score, and framing metadata. See Get Project Clips.
Pass a natural-language prompt to /create-clips to steer clip count, duration, focus, exclusions, editorial mode, and tone. The prompt overrides generic virality scoring when the two conflict; omit it to fall back to virality-driven selection. Preview feature — schema is stable, AI interpretation may evolve.
Reusable caption styles with font, color, emoji, and highlight settings. List with Get All Presets. Used in create-clips and create-captions via captionsPreset.
Connected social accounts (YouTube, Instagram, TikTok, LinkedIn, X) created in the dashboard. The API references them by integrationId when publishing. See Get Integrations.
A publish or schedule action against a completed clip. Use Publish Clip for immediate and Schedule Clips for future posts.
Real-time notifications when a project hits a terminal state. Recommended over polling in production. Requires HTTPS, 200 response within 5 seconds. 5 failed deliveries auto-disables the webhook. See Webhooks.

​
API limits

  • Rate limit: 10 requests per minute per API key (headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset).
  • Concurrent projects:
PlanConcurrent Projects
Creator3
Studio10
EnterpriseCustom, contact sales
The documentation is public. Dashboard links require a Reap account and are only needed for account setup, API key management, integrations, or webhook configuration.

​
FAQ

Yes. The Reap Automation API is a public REST API at https://public.reap.video/api/v1/automation/. Create a key from your Reap dashboard under Settings → API Keys.
Yes. POST /create-clips accepts an uploaded video and returns ranked short clips with captions, reframing, and metadata. Works for podcasts, webinars, interviews, keynotes, and long-form YouTube.
Yes. Pass a natural-language prompt to /create-clips to control clip count, duration, focus, exclusions, editorial mode (highlight reel, trailer, compilation, etc.), and tone. Prompts override generic virality scoring on conflict. Preview feature — schema is stable, AI interpretation may evolve.
Yes. Connect your agent to https://mcp.reap.video/mcp and a one-time OAuth sign-in scopes it to a workspace you choose. Your agent can then create clips, caption, reframe, dub, and publish for you. Full setup in MCP.
Yes. Reap is published to skills.sh. Install with npx skills add https://docs.reap.video. Works with Cursor, Claude Code, Copilot, Codex, Cline, Amp, Gemini CLI, and 30+ agents.
80+ languages with lip-aware timing. Get the live list from GET /get-dubbing-languages.
MP4 or MOV, between 2 minutes and 3 hours, up to 5 GB. Best results on dialogue-rich content (podcasts, interviews, keynotes, streams).
Yes. Configure an HTTPS endpoint in the dashboard. Reap POSTs a JSON payload when a project reaches a terminal state. See Webhooks.
Yes. The Reap API covers the full short-form video pipeline over REST: clipping (/create-clips), captions (/create-captions), reframing (/create-reframe), dubbing (/create-dubbing), transcription (/create-transcription), and social publishing (/publish-clip). No UI scraping, no waitlist, no headless browser.
Yes. POST /publish-clip and POST /schedule-clips post to YouTube, Instagram, TikTok, LinkedIn, and X using integrations connected in the dashboard.
The API is plain REST + JSON, so any HTTP client works. Example code in the Quickstart covers curl, Python (requests), and Node (fetch). Official SDK packages are on the roadmap.

​
Resources

Full API Reference

Every endpoint with schemas and examples.

Quickstart

Your first project in under 5 minutes.

Agent Skill

Install Reap into any AI coding agent.

MCP Server

Let your agent create clips and publish for you over Model Context Protocol.

Help Center

Tutorials and troubleshooting.

Support

Questions, enterprise, roadmap.