REST API v1

Programmatic access for the Business plan. Authenticate with an API key from your dashboard.

Authentication

Authorization: Bearer vdl_xxxxxxxxxxxxxxxx
# or
X-API-Key: vdl_xxxxxxxxxxxxxxxx

GET /api/v1/info?url={video_url}

Resolve metadata + available formats for a URL.

POST /api/v1/downloads

Bulk resolve + record. Body: {"urls": ["...", "..."]} (max 50).

GET /api/v1/downloads

Paginated download history for the authenticated key.

GET /api/v1/me

Current account + plan.

Rate limiting

Each key is limited per minute (default 60). Exceeding returns 429 Too Many Requests. A machine-readable OpenAPI spec is available at /api/openapi.json.