Reap API: AI Video Clipping, Captions, Reframing & Dubbing API

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:

npx skills add https://docs.reap.video
npx add-mcp https://docs.reap.video/mcp

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 live Reap docs 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 1–3 hour videos into dozens of 30–180s social clips, ranked by virality. 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 or MCP server and your agent can write integrations end-to-end.
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 and an MCP server so Cursor, Claude Code, Copilot, and Codex can write integrations 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]]
  }'
# -> { "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 ships as both an agent skill (offline, versioned with your repo) and an MCP server (live, always up-to-date). Both give your agent full knowledge of every endpoint, schema, and workflow.

Agent Skill (skills.sh)
MCP Server
llms.txt

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.

npx add-mcp https://docs.reap.video/mcp

Remote MCP server at https://docs.reap.video/mcp. See MCP setup.

Point any LLM at the documentation index:

https://docs.reap.video/llms.txt

Every endpoint page is also available in markdown at <page>.md.

Core concepts

Projects

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.

Uploads

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

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.

Presets (Brand Templates)

Reusable caption styles with font, color, emoji, and highlight settings. List with Get All Presets. Used in create-clips and create-captions via captionsPreset.

Integrations

Connected social accounts (YouTube, Instagram, TikTok, LinkedIn, X) created in the dashboard. The API references them by integrationId when publishing. See Get Integrations.

Posts

A publish or schedule action against a completed clip. Use Publish Clip for immediate and Schedule Clips for future posts.

Webhooks

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:

Plan	Concurrent Projects
Creator	3
Studio	10
Enterprise	Custom, 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

Does Reap have a public API?

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.

Is there an AI clipping API I can call from code?

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.

Is there a Reap MCP server for Cursor / Claude Code / Copilot?

Yes. Install with npx add-mcp https://docs.reap.video/mcp or point your agent’s MCP config at https://docs.reap.video/mcp. Full setup in MCP.

Can I install Reap as an agent skill?

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.

What languages does Reap dubbing support?

80+ languages with lip-aware timing. Get the live list from GET /get-dubbing-languages.

What video formats and sizes does Reap accept?

MP4 or MOV, between 2 minutes and 3 hours, up to 5 GB. Best results on dialogue-rich content (podcasts, interviews, keynotes, streams).

Does Reap support webhooks?

Yes. Configure an HTTPS endpoint in the dashboard. Reap POSTs a JSON payload when a project reaches a terminal state. See Webhooks.

Is there an AI video editing API I can call from my backend?

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.

Can I publish directly to social platforms from the API?

Is there a Python SDK or a Node SDK?

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

Live docs over Model Context Protocol.

Help Center

Tutorials and troubleshooting.

Support

Questions, enterprise, roadmap.

Getting Started

Presets & Languages

Upload Files

Create Projects

Track & Retrieve

Manage Projects

Publishing

Documentation Index

​What is the Reap API?

​API Basics

Quickstart

Authentication

Agent Skill

MCP Server

​Agent Entry Points

​What can you build with the Reap API?

AI Video Clipping

Smart Reframing

AI Dubbing

Caption Generation

Transcription

Publish & Schedule

​Who is this API for?

​Why teams build on the Reap API

Full REST API, not a UI wrapper

Production-grade webhooks

Agent-native distribution

One API, six capabilities

Publish where your audience is

Built for batch and scale

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

​Install Reap into your AI coding agent

​Core concepts

​API limits

​FAQ

​Resources

Full API Reference

Quickstart

Agent Skill

MCP Server

Help Center

Support

What is the Reap API?

API Basics

Agent Entry Points

What can you build with the Reap API?

Who is this API for?

Why teams build on the Reap API

60-second example: upload, clip, and poll

Install Reap into your AI coding agent

Core concepts

API limits

FAQ

Resources