API Overview

The Bold API gives you programmatic access to your videos, collections, playlists, viewers, and AI features. It's the same engine behind the hosted portal. Everything the portal can do, your app can do.

Base URL

https://app.boldvideo.io/api/v1

All requests and responses are JSON (Content-Type: application/json), except AI endpoints which can stream Server-Sent Events.

Authentication

Pass your API key as a Bearer token:

curl "https://app.boldvideo.io/api/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY"

Create keys under Settings → Developer in the admin panel. Details and key handling in Authentication.

Response envelope

Successful responses wrap the payload in data:

{
  "data": [
    {
      "id": "c03a19be-654c-46d9-985d-3094d7485425",
      "title": "Building Claude Code with Boris Cherny",
      "duration": 5879,
      "playback_id": "UEsc00OGc...",
      "chapters": [...],
      "transcript": {...}
    }
  ]
}

List endpoints may include a meta object with pagination info. Errors use a consistent shape. See Errors.

Endpoint map

Choose your integration style