Skip to main content

​
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: 
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.demomatic.tech/v1/videos
See Authentication for full details on API keys and permission levels.

​
Response format

All successful responses return JSON with a top-level data field: 
{
  "data": { ... }
}
Error responses use an error field. See 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.
Build retry logic with exponential backoff to handle 429 responses gracefully.

​
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

Videos

List, retrieve, generate, delete videos, and pull per-video stats and leads.

Domains

List domains and retrieve aggregate stats and leads across all their videos.