> ## Documentation Index
> Fetch the complete documentation index at: https://docs.demomatic.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> The Demomatic API lets you programmatically generate, retrieve, and manage demo videos and domains.

## Base URL

All API requests go to the production endpoint:

```
https://api.demomatic.tech
```

Every public API endpoint is prefixed with `/v1/`. For example:

```
https://api.demomatic.tech/v1/videos
```

## Authentication

Authenticate every request by passing your API key as a Bearer token in the `Authorization` header:

```bash theme={null}
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.demomatic.tech/v1/videos
```

See [Authentication](/api-reference/authentication) for full details on API keys and permission levels.

## Response format

All successful responses return JSON with a top-level `data` field:

```json theme={null}
{
  "data": { ... }
}
```

Error responses use an `error` field. See [Errors](/api-reference/errors) for the full list of status codes and error shapes.

## Rate limiting

The API enforces a limit of **100 requests per 2-minute window**, tracked per IP address. When you exceed this limit, the API returns `429 Too Many Requests`.

<Note>
  Build retry logic with exponential backoff to handle 429 responses gracefully.
</Note>

## Plan requirements

API access requires a **Starter** or **Growth** subscription plan. Requests made with an account on a free or unsupported plan receive a `403 Forbidden` response.

## Available endpoints

<CardGroup cols={2}>
  <Card title="Videos" icon="video" href="/api-reference/videos/list">
    List, retrieve, generate, delete videos, and pull per-video stats and leads.
  </Card>

  <Card title="Domains" icon="globe" href="/api-reference/domains/list">
    List domains and retrieve aggregate stats and leads across all their videos.
  </Card>
</CardGroup>