> ## 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.

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

> Reap is an AI video API for automating clipping, captions, reframing, dubbing, transcription, and social publishing. REST + webhooks, 80+ languages, works with any AI agent, MCP server, or backend.

> **For AI agents:** a documentation index is at [/llms.txt](/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](https://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:

```bash theme={"system"}
npx skills add https://docs.reap.video
npx add-mcp https://docs.reap.video/mcp
```

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/api-reference/3_quickstart">
    Upload a video and get clips in under 5 minutes.
  </Card>

  <Card title="Authentication" icon="key" href="/api-reference/2_authentication">
    Create an API key and sign requests.
  </Card>

  <Card title="Agent Skill" icon="robot" href="/api-reference/agent-skills">
    Install Reap into Cursor, Claude Code, Copilot, Codex, and 30+ agents.
  </Card>

  <Card title="MCP Server" icon="plug" href="/api-reference/mcp">
    Connect your AI agent to live Reap docs via Model Context Protocol.
  </Card>
</CardGroup>

## Agent Entry Points

* Full documentation index: [llms.txt](/llms.txt)
* OpenAPI schema: [openapi.json](/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?

<CardGroup cols={3}>
  <Card title="AI Video Clipping" icon="scissors">
    Turn 1–3 hour videos into dozens of 30–180s social clips, ranked by virality. See [Create Clips](/api-reference/create-clips).
  </Card>

  <Card title="Smart Reframing" icon="crop">
    Auto-track speakers and subjects to reframe 16:9 into 9:16, 1:1, or 4:5 without cropping off faces. See [Create Reframe](/api-reference/create-reframe).
  </Card>

  <Card title="AI Dubbing" icon="language">
    Voice-dub videos into 80+ languages with lip-aware timing. See [Create Dubbing](/api-reference/create-dubbing).
  </Card>

  <Card title="Caption Generation" icon="closed-captioning">
    Styled, emoji-highlighted captions with brand presets. See [Create Captions](/api-reference/create-captions).
  </Card>

  <Card title="Transcription" icon="file-lines">
    Word-level timestamped transcripts for video and audio. See [Create Transcription](/api-reference/create-transcription).
  </Card>

  <Card title="Publish & Schedule" icon="calendar">
    Push clips to YouTube, Instagram, TikTok, LinkedIn, and X from one endpoint. See [Publish Clip](/api-reference/publish-clip).
  </Card>
</CardGroup>

## Who is this API for?

* **AI agents and coding copilots** (Cursor, Claude Code, Codex, Copilot, Cline, Windsurf, Gemini CLI): install the [Reap Agent Skill](/api-reference/agent-skills) or [MCP server](/api-reference/mcp) 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

<CardGroup cols={2}>
  <Card title="Full REST API, not a UI wrapper" icon="code">
    Every feature in the Reap product is exposed as a stable, versioned endpoint. No scraping, no headless browser, no "contact sales for API access."
  </Card>

  <Card title="Production-grade webhooks" icon="bell">
    Get notified the moment a project finishes. No polling loops, no wasted rate limit, no cron jobs. See [Webhooks](/api-reference/webhooks).
  </Card>

  <Card title="Agent-native distribution" icon="robot">
    Reap ships as an [agent skill](/api-reference/agent-skills) and an [MCP server](/api-reference/mcp) so Cursor, Claude Code, Copilot, and Codex can write integrations for you.
  </Card>

  <Card title="One API, six capabilities" icon="layer-group">
    Clipping, captions, reframing, dubbing, transcription, and social publishing. Same auth, same project model, same webhooks.
  </Card>

  <Card title="Publish where your audience is" icon="share">
    Push clips to YouTube, Instagram, TikTok, LinkedIn, and X from a single endpoint with per-platform settings.
  </Card>

  <Card title="Built for batch and scale" icon="infinity">
    Upload once, fan out into clipping + reframe + dub jobs, and track everything through webhooks. Creator and Studio plans scale with your volume.
  </Card>
</CardGroup>

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

```bash theme={"system"}
# 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](/api-reference/3_quickstart).

## 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.

<Tabs>
  <Tab title="Agent Skill (skills.sh)">
    ```bash theme={"system"}
    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](/api-reference/agent-skills).
  </Tab>

  <Tab title="MCP Server">
    ```bash theme={"system"}
    npx add-mcp https://docs.reap.video/mcp
    ```

    Remote MCP server at `https://docs.reap.video/mcp`. See [MCP setup](/api-reference/mcp).
  </Tab>

  <Tab title="llms.txt">
    Point any LLM at the documentation index:

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

    Every endpoint page is also available in markdown at `<page>.md`.
  </Tab>
</Tabs>

## Core concepts

<AccordionGroup>
  <Accordion title="Projects" icon="folder">
    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.
  </Accordion>

  <Accordion title="Uploads" icon="upload">
    Before creating a project you upload a source video via a presigned S3 URL from [`/get-upload-url`](/api-reference/get-upload-url). MP4 or MOV, 2 minutes to 3 hours, up to 5 GB. Files are validated at project creation, not upload.
  </Accordion>

  <Accordion title="Clips" icon="scissors">
    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](/api-reference/get-project-clips).
  </Accordion>

  <Accordion title="Presets (Brand Templates)" icon="palette">
    Reusable caption styles with font, color, emoji, and highlight settings. List with [Get All Presets](/api-reference/get-all-presets). Used in `create-clips` and `create-captions` via `captionsPreset`.
  </Accordion>

  <Accordion title="Integrations" icon="link">
    Connected social accounts (YouTube, Instagram, TikTok, LinkedIn, X) created in the dashboard. The API references them by `integrationId` when publishing. See [Get Integrations](/api-reference/get-integrations).
  </Accordion>

  <Accordion title="Posts" icon="share">
    A publish or schedule action against a completed clip. Use [Publish Clip](/api-reference/publish-clip) for immediate and [Schedule Clips](/api-reference/schedule-clips) for future posts.
  </Accordion>

  <Accordion title="Webhooks" icon="bell">
    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-reference/webhooks).
  </Accordion>
</AccordionGroup>

## 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](mailto:hello@reap.video) |

<Note>
  The documentation is public. Dashboard links require a Reap account and are only needed for account setup, API key management, integrations, or webhook configuration.
</Note>

## FAQ

<AccordionGroup>
  <Accordion title="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](https://app.reap.video/) under Settings → API Keys.
  </Accordion>

  <Accordion title="Is there an AI clipping API I can call from code?">
    Yes. [`POST /create-clips`](/api-reference/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.
  </Accordion>

  <Accordion title="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](/api-reference/mcp).
  </Accordion>

  <Accordion title="Can I install Reap as an agent skill?">
    Yes. Reap is published to [skills.sh](https://skills.sh/site/docs.reap.video/reap). Install with `npx skills add https://docs.reap.video`. Works with Cursor, Claude Code, Copilot, Codex, Cline, Amp, Gemini CLI, and 30+ agents.
  </Accordion>

  <Accordion title="What languages does Reap dubbing support?">
    80+ languages with lip-aware timing. Get the live list from [`GET /get-dubbing-languages`](/api-reference/get-dubbing-languages).
  </Accordion>

  <Accordion title="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).
  </Accordion>

  <Accordion title="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](/api-reference/webhooks).
  </Accordion>

  <Accordion title="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`](/api-reference/create-clips)), captions ([`/create-captions`](/api-reference/create-captions)), reframing ([`/create-reframe`](/api-reference/create-reframe)), dubbing ([`/create-dubbing`](/api-reference/create-dubbing)), transcription ([`/create-transcription`](/api-reference/create-transcription)), and social publishing ([`/publish-clip`](/api-reference/publish-clip)). No UI scraping, no waitlist, no headless browser.
  </Accordion>

  <Accordion title="Can I publish directly to social platforms from the API?">
    Yes. [`POST /publish-clip`](/api-reference/publish-clip) and [`POST /schedule-clips`](/api-reference/schedule-clips) post to YouTube, Instagram, TikTok, LinkedIn, and X using integrations connected in the dashboard.
  </Accordion>

  <Accordion title="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](/api-reference/3_quickstart) covers curl, Python (`requests`), and Node (`fetch`). Official SDK packages are on the roadmap.
  </Accordion>
</AccordionGroup>

## Resources

<CardGroup cols={2}>
  <Card title="Full API Reference" icon="book" href="/api-reference/get-all-presets">
    Every endpoint with schemas and examples.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/api-reference/3_quickstart">
    Your first project in under 5 minutes.
  </Card>

  <Card title="Agent Skill" icon="robot" href="/api-reference/agent-skills">
    Install Reap into any AI coding agent.
  </Card>

  <Card title="MCP Server" icon="plug" href="/api-reference/mcp">
    Live docs over Model Context Protocol.
  </Card>

  <Card title="Help Center" icon="life-ring" href="/help-center/getting-started">
    Tutorials and troubleshooting.
  </Card>

  <Card title="Support" icon="envelope" href="mailto:hello@reap.video">
    Questions, enterprise, roadmap.
  </Card>
</CardGroup>

<script
  type="application/ld+json"
  data-markdown-ignore
  dangerouslySetInnerHTML={{__html: JSON.stringify({
"@context": "https://schema.org",
"@graph": [
  {
    "@type": "SoftwareApplication",
    "name": "Reap Automation API",
    "applicationCategory": "DeveloperApplication",
    "operatingSystem": "Any (REST API)",
    "description": "AI video automation API for clipping, captions, reframing, dubbing, transcription, and social publishing.",
    "url": "https://docs.reap.video/api-reference/1_introduction",
    "offers": {"@type": "Offer", "price": "0", "priceCurrency": "USD", "description": "Free tier available; paid plans on reap.video/pricing"},
    "provider": {"@type": "Organization", "name": "Reap", "url": "https://reap.video"}
  },
  {
    "@type": "FAQPage",
    "mainEntity": [
      {"@type":"Question","name":"Does Reap have a public API?","acceptedAnswer":{"@type":"Answer","text":"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."}},
      {"@type":"Question","name":"Is there an AI clipping API I can call from code?","acceptedAnswer":{"@type":"Answer","text":"Yes. POST /create-clips accepts an uploaded video and returns ranked short clips with captions, reframing, and metadata."}},
      {"@type":"Question","name":"Is there a Reap MCP server?","acceptedAnswer":{"@type":"Answer","text":"Yes. Install with npx add-mcp https://docs.reap.video/mcp. Works with Cursor, Claude Code, Copilot, Codex, and 30+ agents."}},
      {"@type":"Question","name":"Can I install Reap as an agent skill?","acceptedAnswer":{"@type":"Answer","text":"Yes. Reap is on skills.sh. Install with npx skills add https://docs.reap.video."}},
      {"@type":"Question","name":"What languages does Reap dubbing support?","acceptedAnswer":{"@type":"Answer","text":"80+ languages. The live list is at GET /get-dubbing-languages."}},
      {"@type":"Question","name":"Does Reap support webhooks?","acceptedAnswer":{"@type":"Answer","text":"Yes. Reap POSTs JSON to your HTTPS endpoint when a project reaches a terminal state."}},
      {"@type":"Question","name":"Is there an AI video editing API I can call from my backend?","acceptedAnswer":{"@type":"Answer","text":"Yes. The Reap API covers clipping, captions, reframing, dubbing, transcription, and social publishing over REST with webhooks."}},
      {"@type":"Question","name":"Can I publish directly to social platforms from the API?","acceptedAnswer":{"@type":"Answer","text":"Yes. /publish-clip and /schedule-clips post to YouTube, Instagram, TikTok, LinkedIn, and X."}}
    ]
  }
]
})}}
/>