Download
For AI agents: docs index at /docs/llms.txt; any page as Markdown by adding .md to its URL.
Server-side YouTube downloads — submit a job, poll for the CDN URL.
Endpoints
Submit a download
post /download
Queue a YouTube video for download. Returns a jobId that you poll on
GET /download/{jobId} until status is COMPLETED (or FAILED).
Prefer push over polling? Pass a webhookUrl and we POST the final
status to it instead — the body is byte-for-byte the
GET /download/{jobId} response. See the download.finished
webhook below for headers, signature verification and retries.
The actually-delivered format is reported as actualFormat on the
completed status response.
Cost: bandwidth at the actual file size delivered (20 MB minimum), charged when the background job completes — submitting the job is free. There is no per-download fee. Failures are not charged.
Get download status
get /download/{jobId}
Poll the status of a previously-submitted download job. Once status
is COMPLETED, the response carries a downloadUrl you can fetch
the file from. If status is FAILED, an errorCode identifies
why.
Cost: Free — polling is never charged.