Skip to main content
POST
Download YouTube video audio

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

Optional key for safely retrying a billable write request.

Required string length: 1 - 255

Body

application/json
url
string<uri>
required

Public YouTube video URL (watch, Shorts, live, embed, or youtu.be link). Playlist URLs are not accepted.

bitrate
enum<string>
default:auto

Audio bitrate preference. source keeps the original stream with no re-encode; specific bitrates transcode but never exceed the source. Ignored by lossless formats (wav/flac/alac).

Available options:
source,
auto,
320k,
256k,
192k,
128k,
64k
format
enum<string>
default:mp3

Audio output format.

Available options:
mp3,
m4a,
wav,
aac,
flac,
opus,
vorbis,
alac

Response

Retained audio file URL and normalized public track metadata.

audio_url
string<uri>
required
format
string
required
url
string<uri>
required
video_id
string
required
bitrate
string
channel
string
duration_seconds
number
file_size_bytes
integer<int64>
thumbnail_url
string<uri>
title
string