ReelsBuilder API

Quickstart

ReelsBuilder exposes its full video, intelligence, and distribution stack as a single REST API. Authenticate with a Bearer token, send JSON, get back JSON or a webhook. Every mutating endpoint accepts an Idempotency-Key header so retries are safe. Every async job delivers an HMAC-signed webhook on completion.

Base URL

https://api.reelsbuilder.ai/api/v1

Your first request

curl -X POST https://api.reelsbuilder.ai/api/v1/hooks/generate \
  -H "Authorization: Bearer rb_your_api_key_here" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "topic": "AI startup productivity",
    "audience": "founders",
    "count": 5
  }'

Response (within ~500ms):

{
  "success": true,
  "data": {
    "hooks": [
      { "text": "The 3 AI tools my startup runs at 4am...", "score": 0.91 },
      { "text": "Why we deleted Notion last week.", "score": 0.87 },
      ...
    ]
  },
  "meta": { "request_id": "req_...", "credits_used": 1, "credits_remaining": 999 }
}

Get an API key

Generate one from the developer dashboard. Free accounts include fixed starter videos; API generation uses paid tokens or the card-verified trial proof render.

Key concepts

• Authentication — Bearer tokens prefixed with rb_. Hashed at rest with SHA-256.
• Idempotency — Opt-in Idempotency-Key header on POST. Replays within 24h return the original response without re-charging credits or re-running external work.
• Webhooks — Async jobs deliver completion events with an HMAC-SHA256 signature derived from your key. Retry with exponential backoff on non-2xx.
• Rate limits — Per-key, per-minute. Headers tell you exactly where you stand.
• Errors — Stable error code field separate from HTTP status. Machine-handleable.

Products

Every endpoint below has a dedicated reference page with curl, TypeScript, and Python examples. The full machine-readable OpenAPI 3.0 spec lives at api.reelsbuilder.ai/api-docs.json.

Status & changelog

Production status is visible at api.reelsbuilder.ai/health. Breaking changes ship to /api/v2/* with overlap windows. The current stable surface is v1.

Support

API support: admin@reelsbuilder.ai. SLA-backed responses available on Business and Enterprise plans (see pricing).