Create Job

curl --request POST \
  --url https://api.tornadoapi.io/jobs \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "url": "<string>",
  "format": "<string>",
  "video_codec": "<string>",
  "audio_codec": "<string>",
  "audio_bitrate": "<string>",
  "video_quality": 123,
  "filename": "<string>",
  "folder": "<string>",
  "webhook_url": "<string>",
  "audio_only": true,
  "download_subtitles": true,
  "download_thumbnail": true,
  "quality_preset": "<string>",
  "max_resolution": "<string>",
  "clip_start": "<string>",
  "clip_end": "<string>",
  "clips": [
    {}
  ],
  "live_recording": true,
  "live_from_start": true,
  "max_duration": 123,
  "wait_for_video": true,
  "enable_progress_webhook": true,
  "storage": {},
  "storage_provider": "<string>",
  "paused": true,
  "cookies": "<string>"
}
'

import requests

url = "https://api.tornadoapi.io/jobs"

payload = {
    "url": "<string>",
    "format": "<string>",
    "video_codec": "<string>",
    "audio_codec": "<string>",
    "audio_bitrate": "<string>",
    "video_quality": 123,
    "filename": "<string>",
    "folder": "<string>",
    "webhook_url": "<string>",
    "audio_only": True,
    "download_subtitles": True,
    "download_thumbnail": True,
    "quality_preset": "<string>",
    "max_resolution": "<string>",
    "clip_start": "<string>",
    "clip_end": "<string>",
    "clips": [{}],
    "live_recording": True,
    "live_from_start": True,
    "max_duration": 123,
    "wait_for_video": True,
    "enable_progress_webhook": True,
    "storage": {},
    "storage_provider": "<string>",
    "paused": True,
    "cookies": "<string>"
}
headers = {
    "x-api-key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    url: '<string>',
    format: '<string>',
    video_codec: '<string>',
    audio_codec: '<string>',
    audio_bitrate: '<string>',
    video_quality: 123,
    filename: '<string>',
    folder: '<string>',
    webhook_url: '<string>',
    audio_only: true,
    download_subtitles: true,
    download_thumbnail: true,
    quality_preset: '<string>',
    max_resolution: '<string>',
    clip_start: '<string>',
    clip_end: '<string>',
    clips: [{}],
    live_recording: true,
    live_from_start: true,
    max_duration: 123,
    wait_for_video: true,
    enable_progress_webhook: true,
    storage: {},
    storage_provider: '<string>',
    paused: true,
    cookies: '<string>'
  })
};

fetch('https://api.tornadoapi.io/jobs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tornadoapi.io/jobs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'url' => '<string>',
    'format' => '<string>',
    'video_codec' => '<string>',
    'audio_codec' => '<string>',
    'audio_bitrate' => '<string>',
    'video_quality' => 123,
    'filename' => '<string>',
    'folder' => '<string>',
    'webhook_url' => '<string>',
    'audio_only' => true,
    'download_subtitles' => true,
    'download_thumbnail' => true,
    'quality_preset' => '<string>',
    'max_resolution' => '<string>',
    'clip_start' => '<string>',
    'clip_end' => '<string>',
    'clips' => [
        [
                
        ]
    ],
    'live_recording' => true,
    'live_from_start' => true,
    'max_duration' => 123,
    'wait_for_video' => true,
    'enable_progress_webhook' => true,
    'storage' => [
        
    ],
    'storage_provider' => '<string>',
    'paused' => true,
    'cookies' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tornadoapi.io/jobs"

	payload := strings.NewReader("{\n  \"url\": \"<string>\",\n  \"format\": \"<string>\",\n  \"video_codec\": \"<string>\",\n  \"audio_codec\": \"<string>\",\n  \"audio_bitrate\": \"<string>\",\n  \"video_quality\": 123,\n  \"filename\": \"<string>\",\n  \"folder\": \"<string>\",\n  \"webhook_url\": \"<string>\",\n  \"audio_only\": true,\n  \"download_subtitles\": true,\n  \"download_thumbnail\": true,\n  \"quality_preset\": \"<string>\",\n  \"max_resolution\": \"<string>\",\n  \"clip_start\": \"<string>\",\n  \"clip_end\": \"<string>\",\n  \"clips\": [\n    {}\n  ],\n  \"live_recording\": true,\n  \"live_from_start\": true,\n  \"max_duration\": 123,\n  \"wait_for_video\": true,\n  \"enable_progress_webhook\": true,\n  \"storage\": {},\n  \"storage_provider\": \"<string>\",\n  \"paused\": true,\n  \"cookies\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<x-api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.tornadoapi.io/jobs")
  .header("x-api-key", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"url\": \"<string>\",\n  \"format\": \"<string>\",\n  \"video_codec\": \"<string>\",\n  \"audio_codec\": \"<string>\",\n  \"audio_bitrate\": \"<string>\",\n  \"video_quality\": 123,\n  \"filename\": \"<string>\",\n  \"folder\": \"<string>\",\n  \"webhook_url\": \"<string>\",\n  \"audio_only\": true,\n  \"download_subtitles\": true,\n  \"download_thumbnail\": true,\n  \"quality_preset\": \"<string>\",\n  \"max_resolution\": \"<string>\",\n  \"clip_start\": \"<string>\",\n  \"clip_end\": \"<string>\",\n  \"clips\": [\n    {}\n  ],\n  \"live_recording\": true,\n  \"live_from_start\": true,\n  \"max_duration\": 123,\n  \"wait_for_video\": true,\n  \"enable_progress_webhook\": true,\n  \"storage\": {},\n  \"storage_provider\": \"<string>\",\n  \"paused\": true,\n  \"cookies\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tornadoapi.io/jobs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"url\": \"<string>\",\n  \"format\": \"<string>\",\n  \"video_codec\": \"<string>\",\n  \"audio_codec\": \"<string>\",\n  \"audio_bitrate\": \"<string>\",\n  \"video_quality\": 123,\n  \"filename\": \"<string>\",\n  \"folder\": \"<string>\",\n  \"webhook_url\": \"<string>\",\n  \"audio_only\": true,\n  \"download_subtitles\": true,\n  \"download_thumbnail\": true,\n  \"quality_preset\": \"<string>\",\n  \"max_resolution\": \"<string>\",\n  \"clip_start\": \"<string>\",\n  \"clip_end\": \"<string>\",\n  \"clips\": [\n    {}\n  ],\n  \"live_recording\": true,\n  \"live_from_start\": true,\n  \"max_duration\": 123,\n  \"wait_for_video\": true,\n  \"enable_progress_webhook\": true,\n  \"storage\": {},\n  \"storage_provider\": \"<string>\",\n  \"paused\": true,\n  \"cookies\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "batch_id": "550e8400-e29b-41d4-a716-446655440001",
  "total_episodes": 142,
  "paused": false,
  "episodes": [
    {
      "job_id": "job-uuid-1",
      "url": "https://open.spotify.com/episode/abc",
      "title": "Episode 1 - Introduction"
    }
  ],
  "episode_jobs": ["job-uuid-1", "job-uuid-2", "job-uuid-3"]
}

{
  "batch_id": "550e8400-e29b-41d4-a716-446655440002",
  "total_videos": 25,
  "video_jobs": ["job-uuid-1", "job-uuid-2", "job-uuid-3"]
}

POST

jobs

Create Job

curl --request POST \
  --url https://api.tornadoapi.io/jobs \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "url": "<string>",
  "format": "<string>",
  "video_codec": "<string>",
  "audio_codec": "<string>",
  "audio_bitrate": "<string>",
  "video_quality": 123,
  "filename": "<string>",
  "folder": "<string>",
  "webhook_url": "<string>",
  "audio_only": true,
  "download_subtitles": true,
  "download_thumbnail": true,
  "quality_preset": "<string>",
  "max_resolution": "<string>",
  "clip_start": "<string>",
  "clip_end": "<string>",
  "clips": [
    {}
  ],
  "live_recording": true,
  "live_from_start": true,
  "max_duration": 123,
  "wait_for_video": true,
  "enable_progress_webhook": true,
  "storage": {},
  "storage_provider": "<string>",
  "paused": true,
  "cookies": "<string>"
}
'

import requests

url = "https://api.tornadoapi.io/jobs"

payload = {
    "url": "<string>",
    "format": "<string>",
    "video_codec": "<string>",
    "audio_codec": "<string>",
    "audio_bitrate": "<string>",
    "video_quality": 123,
    "filename": "<string>",
    "folder": "<string>",
    "webhook_url": "<string>",
    "audio_only": True,
    "download_subtitles": True,
    "download_thumbnail": True,
    "quality_preset": "<string>",
    "max_resolution": "<string>",
    "clip_start": "<string>",
    "clip_end": "<string>",
    "clips": [{}],
    "live_recording": True,
    "live_from_start": True,
    "max_duration": 123,
    "wait_for_video": True,
    "enable_progress_webhook": True,
    "storage": {},
    "storage_provider": "<string>",
    "paused": True,
    "cookies": "<string>"
}
headers = {
    "x-api-key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    url: '<string>',
    format: '<string>',
    video_codec: '<string>',
    audio_codec: '<string>',
    audio_bitrate: '<string>',
    video_quality: 123,
    filename: '<string>',
    folder: '<string>',
    webhook_url: '<string>',
    audio_only: true,
    download_subtitles: true,
    download_thumbnail: true,
    quality_preset: '<string>',
    max_resolution: '<string>',
    clip_start: '<string>',
    clip_end: '<string>',
    clips: [{}],
    live_recording: true,
    live_from_start: true,
    max_duration: 123,
    wait_for_video: true,
    enable_progress_webhook: true,
    storage: {},
    storage_provider: '<string>',
    paused: true,
    cookies: '<string>'
  })
};

fetch('https://api.tornadoapi.io/jobs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tornadoapi.io/jobs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'url' => '<string>',
    'format' => '<string>',
    'video_codec' => '<string>',
    'audio_codec' => '<string>',
    'audio_bitrate' => '<string>',
    'video_quality' => 123,
    'filename' => '<string>',
    'folder' => '<string>',
    'webhook_url' => '<string>',
    'audio_only' => true,
    'download_subtitles' => true,
    'download_thumbnail' => true,
    'quality_preset' => '<string>',
    'max_resolution' => '<string>',
    'clip_start' => '<string>',
    'clip_end' => '<string>',
    'clips' => [
        [
                
        ]
    ],
    'live_recording' => true,
    'live_from_start' => true,
    'max_duration' => 123,
    'wait_for_video' => true,
    'enable_progress_webhook' => true,
    'storage' => [
        
    ],
    'storage_provider' => '<string>',
    'paused' => true,
    'cookies' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tornadoapi.io/jobs"

	payload := strings.NewReader("{\n  \"url\": \"<string>\",\n  \"format\": \"<string>\",\n  \"video_codec\": \"<string>\",\n  \"audio_codec\": \"<string>\",\n  \"audio_bitrate\": \"<string>\",\n  \"video_quality\": 123,\n  \"filename\": \"<string>\",\n  \"folder\": \"<string>\",\n  \"webhook_url\": \"<string>\",\n  \"audio_only\": true,\n  \"download_subtitles\": true,\n  \"download_thumbnail\": true,\n  \"quality_preset\": \"<string>\",\n  \"max_resolution\": \"<string>\",\n  \"clip_start\": \"<string>\",\n  \"clip_end\": \"<string>\",\n  \"clips\": [\n    {}\n  ],\n  \"live_recording\": true,\n  \"live_from_start\": true,\n  \"max_duration\": 123,\n  \"wait_for_video\": true,\n  \"enable_progress_webhook\": true,\n  \"storage\": {},\n  \"storage_provider\": \"<string>\",\n  \"paused\": true,\n  \"cookies\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<x-api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.tornadoapi.io/jobs")
  .header("x-api-key", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"url\": \"<string>\",\n  \"format\": \"<string>\",\n  \"video_codec\": \"<string>\",\n  \"audio_codec\": \"<string>\",\n  \"audio_bitrate\": \"<string>\",\n  \"video_quality\": 123,\n  \"filename\": \"<string>\",\n  \"folder\": \"<string>\",\n  \"webhook_url\": \"<string>\",\n  \"audio_only\": true,\n  \"download_subtitles\": true,\n  \"download_thumbnail\": true,\n  \"quality_preset\": \"<string>\",\n  \"max_resolution\": \"<string>\",\n  \"clip_start\": \"<string>\",\n  \"clip_end\": \"<string>\",\n  \"clips\": [\n    {}\n  ],\n  \"live_recording\": true,\n  \"live_from_start\": true,\n  \"max_duration\": 123,\n  \"wait_for_video\": true,\n  \"enable_progress_webhook\": true,\n  \"storage\": {},\n  \"storage_provider\": \"<string>\",\n  \"paused\": true,\n  \"cookies\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tornadoapi.io/jobs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"url\": \"<string>\",\n  \"format\": \"<string>\",\n  \"video_codec\": \"<string>\",\n  \"audio_codec\": \"<string>\",\n  \"audio_bitrate\": \"<string>\",\n  \"video_quality\": 123,\n  \"filename\": \"<string>\",\n  \"folder\": \"<string>\",\n  \"webhook_url\": \"<string>\",\n  \"audio_only\": true,\n  \"download_subtitles\": true,\n  \"download_thumbnail\": true,\n  \"quality_preset\": \"<string>\",\n  \"max_resolution\": \"<string>\",\n  \"clip_start\": \"<string>\",\n  \"clip_end\": \"<string>\",\n  \"clips\": [\n    {}\n  ],\n  \"live_recording\": true,\n  \"live_from_start\": true,\n  \"max_duration\": 123,\n  \"wait_for_video\": true,\n  \"enable_progress_webhook\": true,\n  \"storage\": {},\n  \"storage_provider\": \"<string>\",\n  \"paused\": true,\n  \"cookies\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "batch_id": "550e8400-e29b-41d4-a716-446655440001",
  "total_episodes": 142,
  "paused": false,
  "episodes": [
    {
      "job_id": "job-uuid-1",
      "url": "https://open.spotify.com/episode/abc",
      "title": "Episode 1 - Introduction"
    }
  ],
  "episode_jobs": ["job-uuid-1", "job-uuid-2", "job-uuid-3"]
}

{
  "batch_id": "550e8400-e29b-41d4-a716-446655440002",
  "total_videos": 25,
  "video_jobs": ["job-uuid-1", "job-uuid-2", "job-uuid-3"]
}

Overview

Creates a new download job. For single videos, returns a job_id. For Spotify shows, YouTube playlists and YouTube channels, automatically creates a batch and returns a batch_id with all episode/video job IDs.

If url contains a YouTube playlist ID, this endpoint downloads the ENTIRE playlist, not just one video. This applies even if you only meant to download a single video — see Playlist Auto-Detection below before you’re surprised by a batch of thousands of jobs from what looked like a single-video request.

Billing

Each completed job is metered separately. When your account’s 720p floor is enabled, clips and audio extraction can count the full source’s 720p reference even if the delivered file is smaller. A single job using clips counts the sum of its outputs with one reference calculation; playlist and show batches contain separately metered jobs. See Billing & Metering for all rules and examples.

Header Parameters

string

required

Your API key for authentication

Request

string

required

The video or show URL to download. If this URL contains a genuine YouTube playlist ID (list=PL..., UU..., or OL...) is a YouTube channel URL (youtube.com/@handle, /channel/UC..., /c/..., /user/...) or is a Spotify show, the request downloads the WHOLE playlist/channel/show as a batch — see Playlist Auto-Detection.

string

Output container format. Video: mp4, mkv, webm, mov. Audio: m4a, mp3, ogg, opus. Default: mp4 (or m4a when audio_only is true)

string

Video codec: copy (no re-encode), h264, h265/hevc, vp9, vp8. Default: copy

string

Audio codec: copy (no re-encode), aac, opus, mp3, vorbis. Default: copy with automatic fallback to aac if incompatible

string

Audio bitrate when transcoding: 64k, 128k, 192k, 256k, 320k. Default: 192k

integer

Video quality CRF (0-51, lower = better quality). Only used when video_codec is not copy. Default: 23

string

Custom filename (without extension). Max 255 characters. Cannot contain .., /, \, or null bytes.

string

S3 folder prefix for organizing files. Max 200 characters. Cannot contain .., start with / or \, or be empty/whitespace-only.

string

URL to receive completion notification via POST request.

boolean

default:"false"

Extract audio track only. Outputs m4a (native AAC, no re-encoding) by default. Set format to mp3, ogg, or opus for other audio formats. Supports audio_codec and audio_bitrate for transcoding control.

boolean

default:"false"

Download subtitles if available. Returns subtitle URL in job response.

boolean

default:"false"

Download video thumbnail. Returns thumbnail URL in job response.

Thumbnail upload currently uses the Spotify thumbnail returned by extraction. A YouTube request can accept this option without producing a thumbnail URL; do not rely on it for YouTube thumbnails.

string

Quality preset that overrides video_quality. Options: highest, high, medium, low, lowest.

string

Video resolution preference. Options: best (default), lowest, 2160 (4K), 1440, 1080, 720, 480, 360, 240, 144. Resolution uses the shorter dimension for both horizontal and vertical videos.lowest selects the smallest available video format. A numeric value selects the highest available resolution at or below that value. If every available format exceeds it, the smallest available format is used; the video is not resized. For example, 240 selects 144p when the source offers 144p and 360p, or 360p when the source starts at 360p.For 144 and lowest, separate audio defaults to the lowest available AAC track. Explicit audio codec preferences are respected. A higher bitrate may remain when no lower AAC track is available or when audio is embedded in the selected HLS stream. Check actual_quality in the completed job status for the delivered resolution.

string

Start timestamp for video clipping. Format: HH:MM:SS, MM:SS, or seconds (e.g., 00:01:30 or 90).

string

End timestamp for video clipping. Format: HH:MM:SS, MM:SS, or seconds (e.g., 00:05:00 or 300). Must be greater than clip_start.

array

1–100 ranges for separate files from a single source download. Each item requires string clip_start and clip_end (seconds, MM:SS or HH:MM:SS). Mutually exclusive with top-level clip_start/clip_end. One job delivers all outputs through clip_files; see multi-clip example.

boolean

default:"false"

Enable live stream recording mode. Auto-detected for live URLs.

boolean

default:"false"

For live streams: record from the beginning (VOD mode) instead of the live point.

integer

Maximum recording duration in seconds. Recommended for live streams as a safety cap. Example: 7200 for 2 hours.

boolean

default:"false"

Wait for scheduled/upcoming streams to start before downloading.

boolean

default:"false"

Enable progress webhooks during processing. Sends updates at each stage: downloading, muxing, uploading.

object

Inline storage credentials, optional when another destination is available. Direct users can override pre-configured storage; marketplace users can also reuse saved credentials or use platform storage when enabled. Supports 4 providers via the provider field. See Inline Storage examples below. Mutually exclusive with storage_provider.

string

Deliver this job to one of your saved storage destinations, selected by provider: "s3", "blob" (Azure), "gcs", "oss". Resolved against the destinations configured on your API key first, then on your organization. Returns 400 storage_provider_not_configured if no destination of that provider exists. Mutually exclusive with storage (both present → 400). Omit it to use your default destination. See Choosing a saved destination.

boolean

default:"false"

For Spotify show batches only. Creates the batch in paused mode: jobs are not enqueued for processing immediately. Use PATCH /batch/{id}/jobs to rename episodes, then POST /batch/{id}/start to launch.

string

Cookies of a signed-in, age-verified YouTube account, used only to download an age-restricted YouTube video. Send the Netscape cookies.txt export as one string (one cookie per line, 7 tab-separated columns). Accepted with a single YouTube video URL only, up to 64 KiB. Cookies are never logged, never returned by the API, and are discarded once the download finishes. See Age-Restricted Videos.

Single Job Response

string

UUID of the created job

Response

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}

Batch Response (Spotify Shows)

When the URL is a Spotify show, a batch is created automatically:

string

UUID of the batch job

integer

Number of episodes in the show

boolean

Whether the batch was created in paused mode

array

List of episode details with job IDs, URLs, titles, descriptions, and release dates

array

List of job IDs for each episode (legacy field)

Response (default mode)

{
  "batch_id": "550e8400-e29b-41d4-a716-446655440001",
  "total_episodes": 142,
  "paused": false,
  "episodes": [
    {
      "job_id": "uuid-1",
      "url": "https://open.spotify.com/episode/abc",
      "title": "Episode 1 - Introduction",
      "description": "In this episode we cover...",
      "release_date": "2024-01-15"
    },
    {
      "job_id": "uuid-2",
      "url": "https://open.spotify.com/episode/def",
      "title": "Episode 2 - Deep Dive",
      "description": "A deep dive into...",
      "release_date": "2024-01-22"
    }
  ],
  "episode_jobs": ["uuid-1", "uuid-2"]
}

Response (paused mode)

{
  "batch_id": "550e8400-e29b-41d4-a716-446655440001",
  "total_episodes": 142,
  "paused": true,
  "episodes": [
    {
      "job_id": "uuid-1",
      "url": "https://open.spotify.com/episode/abc",
      "title": "Episode 1 - Introduction"
    },
    {
      "job_id": "uuid-2",
      "url": "https://open.spotify.com/episode/def",
      "title": "Episode 2 - Deep Dive"
    }
  ],
  "episode_jobs": ["uuid-1", "uuid-2"]
}

Examples

curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "format": "mp4",
    "filename": "my-video"
  }'

curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "webhook_url": "https://myapp.com/webhook"
  }'

curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "format": "mkv",
    "video_codec": "h265",
    "audio_codec": "opus",
    "audio_bitrate": "256k",
    "video_quality": 20
  }'

curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://open.spotify.com/show/7iQXmUT7XGuZSzAMjoNWlX",
    "folder": "huberman-lab-2024"
  }'

curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "audio_only": true
  }'

curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "audio_only": true,
    "format": "mp3",
    "audio_bitrate": "320k"
  }'

curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "download_subtitles": true,
    "download_thumbnail": true
  }'

curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "quality_preset": "high"
  }'

curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "max_resolution": "720"
  }'

curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "clip_start": "00:01:30",
    "clip_end": "00:03:00"
  }'

curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/live/abc123",
    "live_recording": true,
    "live_from_start": true,
    "max_duration": 3600
  }'

curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "webhook_url": "https://myapp.com/webhook",
    "enable_progress_webhook": true
  }'

# cookies.txt: Netscape export of a signed-in, age-verified YouTube account
curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --arg url 'https://www.youtube.com/watch?v=VIDEO_ID' \
        --rawfile cookies cookies.txt '{url: $url, cookies: $cookies}')"

curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "storage": {
      "provider": "s3",
      "endpoint": "https://s3.us-east-1.amazonaws.com",
      "bucket": "my-videos",
      "region": "us-east-1",
      "access_key": "AKIAIOSFODNN7EXAMPLE",
      "secret_key": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
      "folder_prefix": "downloads/",
      "base_folder": "videos"
    }
  }'

curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "storage": {
      "provider": "blob",
      "account_name": "mystorageaccount",
      "container": "tornado-downloads",
      "account_key": "your-storage-account-key-base64==",
      "folder_prefix": "downloads/"
    }
  }'

curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "storage": {
      "provider": "gcs",
      "project_id": "my-gcp-project",
      "bucket": "tornado-downloads",
      "service_account_json": "{\"type\":\"service_account\",\"project_id\":\"my-gcp-project\",...}",
      "folder_prefix": "downloads/"
    }
  }'

curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "storage": {
      "provider": "oss",
      "endpoint": "https://oss-cn-hangzhou.aliyuncs.com",
      "bucket": "tornado-downloads",
      "access_key_id": "your-oss-access-key-id",
      "access_key_secret": "your-oss-access-key-secret",
      "folder_prefix": "downloads/"
    }
  }'

Choosing a saved destination

If you configured several storage destinations (one per provider) in the dashboard, pick the one a job should use with storage_provider:

{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "storage_provider": "gcs" }

Accepted values: "s3", "blob" (Azure Blob), "gcs", "oss" — the provider of a destination you saved.
Resolution order: destinations on the API key, then on the organization. Omit the field to use your default destination (the one marked default, else the most recently saved).
400 storage_provider_not_configured — no saved destination of that provider on the key or the organization.
400 storage_and_storage_provider_are_exclusive — you sent both storage (inline credentials) and storage_provider.
If the destination cannot be resolved when the worker uploads (credentials revoked in between), the job is marked Failed — it is never silently delivered elsewhere.

Inline Storage

The storage field lets you provide cloud storage credentials directly in the request. Marketplace requests first use supplied credentials, then previously saved credentials. If neither is available, platform storage is allowed when MARKETPLACE_DEFAULT_STORAGE is enabled (the server default); otherwise the request requires customer storage.

Inline storage credentials take priority over pre-configured storage and are validated before the job is accepted, in three steps — each failure returns 400 with the reason:

Shape — bucket/container name, keys, endpoint (Invalid storage configuration: …), no network call.
Backend construction — provider-specific requirements (e.g. GCS project_id).
Live probe — a small test object is uploaded then deleted with your credentials (Storage credentials validation failed: …). The result is cached for 5 minutes per credential set, so repeated jobs with the same storage don’t pay the probe again.

A 201 Created means validation passed, possibly using a result cached for up to five minutes; permissions and reachability can change afterward. If, despite that, the backend cannot be initialised at upload time, the job is marked Failed with storage_unreachable — it is never silently delivered to another bucket.Credentials are never logged. For direct API keys they live only in the encrypted job payload until the job completes. For marketplace users (RapidAPI, Apify, Zyla) they are saved so later requests can omit storage — see the marketplace section.

Provider Fields

S3 / S3-Compatible
Azure Blob
Google Cloud Storage
Alibaba OSS

Field	Type	Required	Description
`provider`	`string`	Yes	Must be `"s3"`
`endpoint`	`string`	Yes	S3 endpoint URL (e.g., `https://s3.us-east-1.amazonaws.com`, `https://ACCOUNT.r2.cloudflarestorage.com`)
`bucket`	`string`	Yes	Bucket name
`region`	`string`	Yes	AWS region (e.g., `us-east-1`) or `auto` for R2
`access_key`	`string`	Yes	Access key ID
`secret_key`	`string`	Yes	Secret access key
`folder_prefix`	`string`	No	Folder prefix (e.g., `downloads/2024/`)
`base_folder`	`string`	No	Top-level folder (default: `videos`)

Field	Type	Required	Description
`provider`	`string`	Yes	Must be `"blob"`
`account_name`	`string`	Yes	Azure Storage account name
`container`	`string`	Yes	Container name
`account_key`	`string`	No*	Account key (Base64)
`sas_token`	`string`	No*	SAS token
`folder_prefix`	`string`	No	Folder prefix
`base_folder`	`string`	No	Top-level folder (default: `videos`)

*Provide at least one of account_key or sas_token. If both are present, the account key takes precedence.

Field	Type	Required	Description
`provider`	`string`	Yes	Must be `"gcs"`
`project_id`	`string`	Yes	GCP project ID
`bucket`	`string`	Yes	GCS bucket name
`service_account_json`	`string`	Yes	Full service account JSON as string
`folder_prefix`	`string`	No	Folder prefix
`base_folder`	`string`	No	Top-level folder (default: `videos`)

Field	Type	Required	Description
`provider`	`string`	Yes	Must be `"oss"`
`endpoint`	`string`	Yes	OSS endpoint (e.g., `https://oss-cn-hangzhou.aliyuncs.com`)
`bucket`	`string`	Yes	Bucket name
`access_key_id`	`string`	Yes	Access key ID
`access_key_secret`	`string`	Yes	Access key secret
`folder_prefix`	`string`	No	Folder prefix
`base_folder`	`string`	No	Top-level folder (default: `videos`)

Age-Restricted Videos

YouTube serves age-restricted videos only to a signed-in account whose age is verified. Without cookies, such a job ends with status Warning and an age-restriction error. To download it, send the cookies of an age-verified account in the cookies field:

curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --arg url 'https://www.youtube.com/watch?v=VIDEO_ID' \
        --rawfile cookies cookies.txt '{url: $url, cookies: $cookies}')"

import requests

with open("cookies.txt", encoding="utf-8") as f:
    cookies = f.read()

response = requests.post(
    "https://api.tornadoapi.io/jobs",
    headers={"x-api-key": "sk_your_api_key"},
    json={"url": "https://www.youtube.com/watch?v=VIDEO_ID", "cookies": cookies},
)
print(response.json())  # {"job_id": "..."}

The job then runs like any other: poll GET /jobs/{id} until it is Completed. All other options (max_resolution, format, storage, webhook_url…) work as usual.

Exporting the cookies

Use a dedicated account

Create or pick a YouTube account used only for this purpose, and verify its age. The cookies give access to the whole Google account: never send the cookies of a personal or company account.

Open a private (incognito) browser window and sign in to youtube.com with that account.

Export youtube.com cookies

Export the cookies of the youtube.com tab in Netscape cookies.txt format with a cookies.txt browser extension. The file format is the one yt-dlp reads with --cookies.

Close the private window

Close the window right after the export. While a YouTube tab stays open, the browser rotates the session cookies and an export taken from an everyday window usually stops working within hours.

Accepted format

Rule	Detail
Format	Netscape `cookies.txt`: one cookie per line, 7 tab-separated columns. `#` comment lines and the `#HttpOnly_` prefix are allowed. JSON exports and `Cookie:` header strings are rejected.
Domains	`.youtube.com`, `.google.com` and `.googlevideo.com` only, subdomains included. Remove any other domain from the file.
Session	The file must contain a signed-in session cookie: `SID` or `__Secure-3PSID`.
Size	64 KiB at most.
URL	A single YouTube video URL. Playlists, channels, Spotify and other sources are refused, and so is `POST /jobs/bulk`.

Send cookies only for videos that need them: other videos download without an account.

How cookies are handled

They are used for this job’s YouTube requests only, never for another job or another customer.
They are never written to logs, never stored in the job record, and never returned by GET /jobs/{id}. While the job waits in the queue they are kept encrypted, and they are discarded as soon as the download finishes.
POST /jobs/{id}/retry runs without them. To retry, submit POST /jobs again with fresh cookies.

When YouTube rejects the cookies

If the cookies have expired, belong to a signed-out session or to an account whose age is not verified, the job ends with status Warning. Nothing is delivered, so nothing is billed:

{
  "status": "Warning",
  "error": "cookies were provided but YouTube rejected them (expired or not age-verified); sign in on youtube.com and export fresh cookies",
  "error_type": "warning"
}

Export fresh cookies (see above) and submit the job again.

Success Response

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "batch_id": "550e8400-e29b-41d4-a716-446655440001",
  "total_episodes": 142,
  "paused": false,
  "episodes": [
    {
      "job_id": "job-uuid-1",
      "url": "https://open.spotify.com/episode/abc",
      "title": "Episode 1 - Introduction"
    }
  ],
  "episode_jobs": ["job-uuid-1", "job-uuid-2", "job-uuid-3"]
}

{
  "batch_id": "550e8400-e29b-41d4-a716-446655440002",
  "total_videos": 25,
  "video_jobs": ["job-uuid-1", "job-uuid-2", "job-uuid-3"]
}

Playlist Auto-Detection

POST /jobs inspects url and automatically creates a batch (one job per video) instead of a single job whenever it detects a genuine YouTube playlist or a YouTube channel. There is no separate “batch” endpoint or flag to opt into this — it happens automatically based on the URL you send.

Which URLs trigger it

`url` contains…	Example	Behavior
`list=PL...`	`youtube.com/watch?v=xxx&list=PLxxxx` or `youtube.com/playlist?list=PLxxxx`	✅ Downloads the whole playlist (this is a real, user-created playlist)
`list=UU...`	`...&list=UUxxxx`	✅ Downloads the whole playlist (a channel’s uploads)
`list=OL...`	`...&list=OLxxxx`	✅ Downloads the whole playlist (an “Online courses”-style auto playlist)
`list=RD...`	`...&list=RDxxxx&start_radio=1`	❌ Downloads only the single video in `v=`
`list=WL` or `list=LL`	`...&list=WL`	❌ Downloads only the single video in `v=`
channel URL	`youtube.com/@handle`, `youtube.com/channel/UCxxxx`, `/c/name`, `/user/name`	✅ Downloads every public upload of the channel (videos, Shorts, past live streams)
channel tab URL	`youtube.com/@handle/videos`, `/shorts`, `/streams`	✅ Downloads only that tab (long-form videos, Shorts, or past live streams)
no `list=` at all	`youtube.com/watch?v=xxx`	❌ Downloads only that one video

This is the #1 source of “I asked for one video and got thousands of jobs” confusion. YouTube’s own UI automatically appends &list=RD<video_id>&start_radio=1 to the URL bar any time you open a video from an autoplay queue, the homepage, related videos, or a “Radio”/Mix button — not because you’re viewing a playlist. If you’re integrating by copy-pasting URLs from a browser, always double-check for a list= parameter before sending it here. As of 2026-07-08, list=RD.../WL/LL URLs are correctly treated as single-video requests (this was previously a real bug that caused two production incidents) — but if you’re on an older integration or unsure, strip any list=/start_radio= query parameters from the URL yourself before calling this endpoint to be safe.

Size limit

Even a genuine playlist (PL/UU/OL) is capped at 500 videos per request (configurable server-side via MAX_PLAYLIST_BATCH_SIZE). A channel URL is capped at 20,000 videos (MAX_CHANNEL_BATCH_SIZE), because it cannot be an accidental copy-paste. A collection larger than its cap is rejected outright with a 413 Payload Too Large — it is never silently truncated. If you need to download a larger playlist, split it into smaller batches or contact support. Videos that YouTube lists as unavailable in the playlist or channel (deleted, private, blocked) are skipped: they would only produce failed jobs.

Channels and concurrency

Every video of the batch becomes its own job, but a channel is not downloaded all at once. Each API key has a limit of jobs in flight (250 by default). Jobs beyond that limit are created immediately with status pending and the step Queued (account concurrency limit), then released automatically as earlier jobs finish. Nothing is refused, and every job ID is returned in video_jobs right away. An unknown channel, or a tab the channel does not have (for example /streams on a channel that never streamed), returns 404.

Response

string

UUID of the batch job

integer

Number of videos in the playlist

array

List of job IDs for each video

Genuine Playlist (downloads all videos)

curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/playlist?list=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf"
  }'

Response

{
  "batch_id": "550e8400-e29b-41d4-a716-446655440002",
  "total_videos": 25,
  "video_jobs": ["job-uuid-1", "job-uuid-2", "job-uuid-3"]
}

Channel (downloads every upload, queued past the key's concurrency limit)

curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/@veritasium"
  }'

Response

{
  "batch_id": "550e8400-e29b-41d4-a716-446655440003",
  "total_videos": 536,
  "video_jobs": ["job-uuid-1", "job-uuid-2", "job-uuid-3"],
  "channel_id": "UCHnyfMqiRRG1u-2MsSQLbXA",
  "playlist_id": "UUHnyfMqiRRG1u-2MsSQLbXA"
}

Radio/Mix URL (downloads only the one video)

curl -X POST "https://api.tornadoapi.io/jobs" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=LVCpDa6ymtQ&list=RDLVCpDa6ymtQ&start_radio=1"
  }'

Response

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}

413 Payload Too Large (playlist exceeds the cap)

{
  "error": "This playlist has more than 500 videos, which exceeds the 500-video limit for automatic playlist expansion in a single request.",
  "hint": "Split it into smaller batches (e.g. multiple playlist URLs, or the batch API), or contact support@velys.software if you need a one-off exception.",
  "max_playlist_batch_size": 500
}

Error Responses

{
  "error": "Folder name too long (max 200 characters)"
}

{
  "error": "Invalid folder name: path traversal not allowed"
}

{
  "error": "Folder name cannot be empty or whitespace only"
}

{
  "error": "Invalid video URL"
}

{
  "error": "Invalid webhook URL"
}

{
  "error": "Invalid resolution '4k'. Valid options: [\"best\", \"lowest\", \"2160\", \"1440\", \"1080\", \"720\", \"480\", \"360\", \"240\", \"144\"]"
}

{
  "error": "Invalid clip_start format '90x'. Use HH:MM:SS or seconds"
}

{
  "error": "clip_end must be greater than clip_start"
}

{
  "error": "No episodes found in this show"
}

{
  "error": "cookies must include a signed-in session cookie (SID or __Secure-3PSID): export them from youtube.com while signed in"
}

{
  "error": "cookies line 4: domain 'example.com' is not allowed (only .youtube.com, .google.com and .googlevideo.com)"
}

{
  "error": "cookies line 1: expected 7 tab-separated columns (Netscape cookies.txt export), found 1; JSON and Cookie-header formats are not accepted"
}

{
  "error": "cookies are only accepted with a single YouTube video URL (not a playlist, channel, Spotify show or other source); remove any list= parameter"
}

{
  "error": "Missing x-api-key header"
}

{
  "error": "Invalid API Key"
}

{
  "error": "Storage quota exceeded",
  "limit_gb": "1024.00",
  "used_gb": "1024.00",
  "message": "This API key has a 1024 GB limit and has used 1024.00 GB"
}

{
  "error": "IP address not allowed for this API key"
}

{
  "error": "Server is at capacity, please retry later",
  "queue_depth": 5000,
  "retry_after": 30
}

{
  "error": "Service is draining, try another node",
  "retry_after": 30
}

{
  "error": "credential_encryption_unavailable",
  "hint": "Cookies cannot be accepted right now. Retry later."
}

{
  "error": "Spotify show extraction timed out. The show may have too many episodes."
}

Notes

The 429 Too Many Requests (server at capacity) and 503 Service Unavailable (service draining) responses include a Retry-After header indicating how many seconds to wait before retrying. The 503 credential_encryption_unavailable response has no Retry-After header: retry after a short delay.

Codec auto-correction: When format is set, incompatible codec/format combinations are automatically corrected to ensure valid output (the same rule applies to POST /jobs/bulk):

webm + h264/h265 or no video codec → video codec changed to vp9
webm + aac/mp3 or no audio codec → audio codec changed to opus
mov + vp9/vp8 or no video codec → video codec changed to h264 (mov cannot hold VP9, VP8 or AV1)
mp4 + vp8 → video codec changed to vp9 (mp4 cannot hold VP8)
mp4/mov + opus/vorbis or no audio codec → audio codec changed to aac
m4a + any codec other than aac → audio codec changed to aac
ogg + aac/mp3 or no audio codec → audio codec changed to opus
opus + any other codec → opus; mp3 + any other codec → mp3
Setting audio_bitrate without audio_codec (or with copy) → audio codec defaults to aac

Codec names are case-insensitive. vp8 is encoded with libvpx and vorbis with libvorbis.Unknown or empty format values return 400 at admission. Omitting the field selects the default.

API Reference

Jobs

Bulk

Metadata

Batch Operations

User

Create Job

Overview

Billing

Header Parameters

Request

Single Job Response

Batch Response (Spotify Shows)

Examples

Choosing a saved destination

Inline Storage

Provider Fields

Age-Restricted Videos

Exporting the cookies

Accepted format

How cookies are handled

When YouTube rejects the cookies

Success Response

Playlist Auto-Detection

Which URLs trigger it

Size limit

Channels and concurrency

Response

Error Responses

Notes

​Overview

​Billing

​Header Parameters

​Request

​Single Job Response

​Batch Response (Spotify Shows)

​Examples

​Choosing a saved destination

​Inline Storage

​Provider Fields

​Age-Restricted Videos

​Exporting the cookies

​Accepted format

​How cookies are handled

​When YouTube rejects the cookies

​Success Response

​Playlist Auto-Detection

​Which URLs trigger it

​Size limit

​Channels and concurrency

​Response

​Error Responses

​Notes

Overview

Billing

Header Parameters

Request

Single Job Response

Batch Response (Spotify Shows)

Examples

Choosing a saved destination

Inline Storage

Provider Fields

Age-Restricted Videos

Exporting the cookies

Accepted format

How cookies are handled

When YouTube rejects the cookies

Success Response

Playlist Auto-Detection

Which URLs trigger it

Size limit

Channels and concurrency

Response

Error Responses

Notes