---
title: Download | Vid Kraken API
description: Server-side YouTube downloads — submit a job, poll for the CDN URL.
url: https://vidkraken.com/docs/endpoint/tag/download
updated: '2026-10-24'
---

# Download

For AI agents: docs index at https://vidkraken.com/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](https://vidkraken.com/docs/endpoint/submit-download.md)

`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](https://vidkraken.com/docs/endpoint/get-download-status.md)

`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.

Full API reference: https://vidkraken.com/docs.md