Get audio files list
curl --request GET \
--url https://api.poix.io/files/audio/{videoId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.poix.io/files/audio/{videoId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.poix.io/files/audio/{videoId}', 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.poix.io/files/audio/{videoId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.poix.io/files/audio/{videoId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.poix.io/files/audio/{videoId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poix.io/files/audio/{videoId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"itag": 139,
"url": "https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=139&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fmp4&rqh=1&gir=yes&clen=1295035&dur=212.183&lmt=1717047826596234&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgWMJorIvdLaJa5oqpWV2xWTAuk1sV8oTZ1wjj0TeXq6gCIQCc0aP2FLhIo6RzJJTNQZQs5HSHpoG2h5Xv3gTQ0Bn8RQ%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D",
"mimeType": "audio/mp4; codecs=\"mp4a.40.5\"",
"bitrate": 50079,
"initRange": {
"start": "0",
"end": "731"
},
"indexRange": {
"start": "732",
"end": "1027"
},
"lastModified": "1717047826596234",
"contentLength": "1295035",
"quality": "tiny",
"projectionType": "RECTANGULAR",
"averageBitrate": 48827,
"audioQuality": "AUDIO_QUALITY_LOW",
"approxDurationMs": "212183",
"audioSampleRate": "22050",
"audioChannels": 2,
"parsedContentLength": "1.24 MiB",
"lengthSeconds": "212",
"parsedLastModified": "2024-05-30T05:43:46.596Z"
},
{
"itag": 140,
"url": "https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=140&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fmp4&rqh=1&gir=yes&clen=3433605&dur=212.091&lmt=1717047821006373&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRAIga0ETV3wIzfWxNuu_lGfcvjsfUXpH8E-WIyji7IufSAMCICJcXNhLSWKt7P7r6FRQIwWeui_BseZ7jSYCAf6esbDh&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D",
"mimeType": "audio/mp4; codecs=\"mp4a.40.2\"",
"bitrate": 130675,
"initRange": {
"start": "0",
"end": "722"
},
"indexRange": {
"start": "723",
"end": "1018"
},
"lastModified": "1717047821006373",
"contentLength": "3433605",
"quality": "tiny",
"projectionType": "RECTANGULAR",
"averageBitrate": 129514,
"highReplication": true,
"audioQuality": "AUDIO_QUALITY_MEDIUM",
"approxDurationMs": "212091",
"audioSampleRate": "44100",
"audioChannels": 2,
"parsedContentLength": "3.27 MiB",
"lengthSeconds": "212",
"parsedLastModified": "2024-05-30T05:43:41.006Z"
},
{
"itag": 249,
"url": "https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=249&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fwebm&rqh=1&gir=yes&clen=1232413&dur=212.061&lmt=1717047819209140&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgT1IgHRdP6_0ejnZKkTKrWFF3UWNbYA4N9MNbKOQQJL4CIQDu5ccVYqi0UDWjx3vm9IXdnutM514_3yRrzqczVavudQ%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D",
"mimeType": "audio/webm; codecs=\"opus\"",
"bitrate": 49668,
"initRange": {
"start": "0",
"end": "265"
},
"indexRange": {
"start": "266",
"end": "635"
},
"lastModified": "1717047819209140",
"contentLength": "1232413",
"quality": "tiny",
"projectionType": "RECTANGULAR",
"averageBitrate": 46492,
"audioQuality": "AUDIO_QUALITY_LOW",
"approxDurationMs": "212061",
"audioSampleRate": "48000",
"audioChannels": 2,
"parsedContentLength": "1.18 MiB",
"lengthSeconds": "212",
"parsedLastModified": "2024-05-30T05:43:39.209Z"
},
{
"itag": 250,
"url": "https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=250&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fwebm&rqh=1&gir=yes&clen=1630086&dur=212.061&lmt=1717047822840442&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgI4Vwy12m6UidKdL0SqCi5G7nbKx1UAXev-TObNRRlGICIQDA0SL6AnZEqhpvypdLKdwR2QtcsUZQSVk-exV4Z10Vaw%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D",
"mimeType": "audio/webm; codecs=\"opus\"",
"bitrate": 65984,
"initRange": {
"start": "0",
"end": "265"
},
"indexRange": {
"start": "266",
"end": "636"
},
"lastModified": "1717047822840442",
"contentLength": "1630086",
"quality": "tiny",
"projectionType": "RECTANGULAR",
"averageBitrate": 61494,
"audioQuality": "AUDIO_QUALITY_LOW",
"approxDurationMs": "212061",
"audioSampleRate": "48000",
"audioChannels": 2,
"parsedContentLength": "1.55 MiB",
"lengthSeconds": "212",
"parsedLastModified": "2024-05-30T05:43:42.840Z"
},
{
"itag": 251,
"url": "https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=251&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fwebm&rqh=1&gir=yes&clen=3437753&dur=212.061&lmt=1717047822556748&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRAIgPQ-Q-5PkH0mnKI6pXIOEj7f_qrvovoGY7VCh8F4M7ZQCIGy0TOgdwKUHiE3xi0Jm8VqfgUXpQ9TlSSZtk4xXHdcV&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D",
"mimeType": "audio/webm; codecs=\"opus\"",
"bitrate": 136946,
"initRange": {
"start": "0",
"end": "265"
},
"indexRange": {
"start": "266",
"end": "636"
},
"lastModified": "1717047822556748",
"contentLength": "3437753",
"quality": "tiny",
"projectionType": "RECTANGULAR",
"averageBitrate": 129689,
"audioQuality": "AUDIO_QUALITY_MEDIUM",
"approxDurationMs": "212061",
"audioSampleRate": "48000",
"audioChannels": 2,
"parsedContentLength": "3.28 MiB",
"lengthSeconds": "212",
"parsedLastModified": "2024-05-30T05:43:42.556Z"
}
]{
"success": false,
"error": {
"issues": [
{
"code": "too_big",
"maximum": 11,
"type": "string",
"inclusive": true,
"exact": true,
"message": "String must contain exactly 11 character(s)",
"path": [
"videoId"
]
}
],
"name": "ZodError"
}
}{
"error": {
"message": "Forbidden"
}
}Files
Get audio files list
This endpoint retrieves a list of audio files for a specified YouTube video.
GET
/
files
/
audio
/
{videoId}
Get audio files list
curl --request GET \
--url https://api.poix.io/files/audio/{videoId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.poix.io/files/audio/{videoId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.poix.io/files/audio/{videoId}', 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.poix.io/files/audio/{videoId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.poix.io/files/audio/{videoId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.poix.io/files/audio/{videoId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poix.io/files/audio/{videoId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"itag": 139,
"url": "https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=139&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fmp4&rqh=1&gir=yes&clen=1295035&dur=212.183&lmt=1717047826596234&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgWMJorIvdLaJa5oqpWV2xWTAuk1sV8oTZ1wjj0TeXq6gCIQCc0aP2FLhIo6RzJJTNQZQs5HSHpoG2h5Xv3gTQ0Bn8RQ%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D",
"mimeType": "audio/mp4; codecs=\"mp4a.40.5\"",
"bitrate": 50079,
"initRange": {
"start": "0",
"end": "731"
},
"indexRange": {
"start": "732",
"end": "1027"
},
"lastModified": "1717047826596234",
"contentLength": "1295035",
"quality": "tiny",
"projectionType": "RECTANGULAR",
"averageBitrate": 48827,
"audioQuality": "AUDIO_QUALITY_LOW",
"approxDurationMs": "212183",
"audioSampleRate": "22050",
"audioChannels": 2,
"parsedContentLength": "1.24 MiB",
"lengthSeconds": "212",
"parsedLastModified": "2024-05-30T05:43:46.596Z"
},
{
"itag": 140,
"url": "https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=140&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fmp4&rqh=1&gir=yes&clen=3433605&dur=212.091&lmt=1717047821006373&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRAIga0ETV3wIzfWxNuu_lGfcvjsfUXpH8E-WIyji7IufSAMCICJcXNhLSWKt7P7r6FRQIwWeui_BseZ7jSYCAf6esbDh&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D",
"mimeType": "audio/mp4; codecs=\"mp4a.40.2\"",
"bitrate": 130675,
"initRange": {
"start": "0",
"end": "722"
},
"indexRange": {
"start": "723",
"end": "1018"
},
"lastModified": "1717047821006373",
"contentLength": "3433605",
"quality": "tiny",
"projectionType": "RECTANGULAR",
"averageBitrate": 129514,
"highReplication": true,
"audioQuality": "AUDIO_QUALITY_MEDIUM",
"approxDurationMs": "212091",
"audioSampleRate": "44100",
"audioChannels": 2,
"parsedContentLength": "3.27 MiB",
"lengthSeconds": "212",
"parsedLastModified": "2024-05-30T05:43:41.006Z"
},
{
"itag": 249,
"url": "https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=249&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fwebm&rqh=1&gir=yes&clen=1232413&dur=212.061&lmt=1717047819209140&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgT1IgHRdP6_0ejnZKkTKrWFF3UWNbYA4N9MNbKOQQJL4CIQDu5ccVYqi0UDWjx3vm9IXdnutM514_3yRrzqczVavudQ%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D",
"mimeType": "audio/webm; codecs=\"opus\"",
"bitrate": 49668,
"initRange": {
"start": "0",
"end": "265"
},
"indexRange": {
"start": "266",
"end": "635"
},
"lastModified": "1717047819209140",
"contentLength": "1232413",
"quality": "tiny",
"projectionType": "RECTANGULAR",
"averageBitrate": 46492,
"audioQuality": "AUDIO_QUALITY_LOW",
"approxDurationMs": "212061",
"audioSampleRate": "48000",
"audioChannels": 2,
"parsedContentLength": "1.18 MiB",
"lengthSeconds": "212",
"parsedLastModified": "2024-05-30T05:43:39.209Z"
},
{
"itag": 250,
"url": "https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=250&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fwebm&rqh=1&gir=yes&clen=1630086&dur=212.061&lmt=1717047822840442&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgI4Vwy12m6UidKdL0SqCi5G7nbKx1UAXev-TObNRRlGICIQDA0SL6AnZEqhpvypdLKdwR2QtcsUZQSVk-exV4Z10Vaw%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D",
"mimeType": "audio/webm; codecs=\"opus\"",
"bitrate": 65984,
"initRange": {
"start": "0",
"end": "265"
},
"indexRange": {
"start": "266",
"end": "636"
},
"lastModified": "1717047822840442",
"contentLength": "1630086",
"quality": "tiny",
"projectionType": "RECTANGULAR",
"averageBitrate": 61494,
"audioQuality": "AUDIO_QUALITY_LOW",
"approxDurationMs": "212061",
"audioSampleRate": "48000",
"audioChannels": 2,
"parsedContentLength": "1.55 MiB",
"lengthSeconds": "212",
"parsedLastModified": "2024-05-30T05:43:42.840Z"
},
{
"itag": 251,
"url": "https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=251&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fwebm&rqh=1&gir=yes&clen=3437753&dur=212.061&lmt=1717047822556748&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRAIgPQ-Q-5PkH0mnKI6pXIOEj7f_qrvovoGY7VCh8F4M7ZQCIGy0TOgdwKUHiE3xi0Jm8VqfgUXpQ9TlSSZtk4xXHdcV&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D",
"mimeType": "audio/webm; codecs=\"opus\"",
"bitrate": 136946,
"initRange": {
"start": "0",
"end": "265"
},
"indexRange": {
"start": "266",
"end": "636"
},
"lastModified": "1717047822556748",
"contentLength": "3437753",
"quality": "tiny",
"projectionType": "RECTANGULAR",
"averageBitrate": 129689,
"audioQuality": "AUDIO_QUALITY_MEDIUM",
"approxDurationMs": "212061",
"audioSampleRate": "48000",
"audioChannels": 2,
"parsedContentLength": "3.28 MiB",
"lengthSeconds": "212",
"parsedLastModified": "2024-05-30T05:43:42.556Z"
}
]{
"success": false,
"error": {
"issues": [
{
"code": "too_big",
"maximum": 11,
"type": "string",
"inclusive": true,
"exact": true,
"message": "String must contain exactly 11 character(s)",
"path": [
"videoId"
]
}
],
"name": "ZodError"
}
}{
"error": {
"message": "Forbidden"
}
}This endpoint returns the direct media URLs for a video’s available audio-only formats, along with their codec, bitrate, container and file size.
Choosing a region
Media URLs are always resolved from a specific country. By default that is the country your request originates from, falling back toDE when it cannot be determined. Pass regionCode to resolve the request as if it came from somewhere else — use it when a video is region-restricted and returns no formats from the default region.
regionCode accepts an ISO 3166-1 alpha-2 code; see Countries for the full list of accepted values.
cURL
curl --request GET \
--url 'https://api.poix.io/files/audio/dQw4w9WgXcQ?regionCode=US' \
--header 'Authorization: Bearer poix-xxx'
Downloading the files
Theurl of each format is a signed, time-limited link served directly by YouTube’s CDN. Two things follow from that:
- The links expire within a few hours. Request the list right before you download rather than storing the URLs.
- The links are issued to the host that fetched them, which is Poix — not your own IP address. For most videos this makes no difference and the link downloads from anywhere. For some region-licensed content YouTube additionally restricts playback to the network the link was issued for, and downloading it yourself returns
403 Forbidden.
regionCode does not fix a 403 on download. It controls which region the
link is issued for, not which IP address may use it — the link is never issued
for your own IP. If you hit one, request a fresh list and retry; the same link
frequently succeeds from a different network.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The YouTube video ID
Required string length:
11Example:
"dQw4w9WgXcQ"
Query Parameters
Instructs the API to return results as if the request was made from a specific country. ISO 3166 alpha-2 country code.
Available options:
AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BM, BN, BO, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, EU, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, ST, SV, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW Response
Successful response
The itag of the audio format
The URL of the audio file
The MIME type of the audio file
The bitrate of the audio in bits per second
The initialization range for the audio file
Show child attributes
Show child attributes
The index range for the audio file
Show child attributes
Show child attributes
The last modified timestamp of the audio file
The content length of the audio file in bytes
The quality label of the audio
The projection type of the audio
The average bitrate of the audio in bits per second
The audio quality label
The approximate duration of the audio in milliseconds
The audio sample rate
The number of audio channels
The parsed content length in a human-readable format
The length of the audio in seconds
The parsed last modified date in ISO 8601 format
Indicates if the audio has high replication
Example:
[
{
"itag": 139,
"url": "https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=139&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fmp4&rqh=1&gir=yes&clen=1295035&dur=212.183&lmt=1717047826596234&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgWMJorIvdLaJa5oqpWV2xWTAuk1sV8oTZ1wjj0TeXq6gCIQCc0aP2FLhIo6RzJJTNQZQs5HSHpoG2h5Xv3gTQ0Bn8RQ%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D",
"mimeType": "audio/mp4; codecs=\"mp4a.40.5\"",
"bitrate": 50079,
"initRange": { "start": "0", "end": "731" },
"indexRange": { "start": "732", "end": "1027" },
"lastModified": "1717047826596234",
"contentLength": "1295035",
"quality": "tiny",
"projectionType": "RECTANGULAR",
"averageBitrate": 48827,
"audioQuality": "AUDIO_QUALITY_LOW",
"approxDurationMs": "212183",
"audioSampleRate": "22050",
"audioChannels": 2,
"parsedContentLength": "1.24 MiB",
"lengthSeconds": "212",
"parsedLastModified": "2024-05-30T05:43:46.596Z"
},
{
"itag": 140,
"url": "https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=140&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fmp4&rqh=1&gir=yes&clen=3433605&dur=212.091&lmt=1717047821006373&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRAIga0ETV3wIzfWxNuu_lGfcvjsfUXpH8E-WIyji7IufSAMCICJcXNhLSWKt7P7r6FRQIwWeui_BseZ7jSYCAf6esbDh&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D",
"mimeType": "audio/mp4; codecs=\"mp4a.40.2\"",
"bitrate": 130675,
"initRange": { "start": "0", "end": "722" },
"indexRange": { "start": "723", "end": "1018" },
"lastModified": "1717047821006373",
"contentLength": "3433605",
"quality": "tiny",
"projectionType": "RECTANGULAR",
"averageBitrate": 129514,
"highReplication": true,
"audioQuality": "AUDIO_QUALITY_MEDIUM",
"approxDurationMs": "212091",
"audioSampleRate": "44100",
"audioChannels": 2,
"parsedContentLength": "3.27 MiB",
"lengthSeconds": "212",
"parsedLastModified": "2024-05-30T05:43:41.006Z"
},
{
"itag": 249,
"url": "https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=249&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fwebm&rqh=1&gir=yes&clen=1232413&dur=212.061&lmt=1717047819209140&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgT1IgHRdP6_0ejnZKkTKrWFF3UWNbYA4N9MNbKOQQJL4CIQDu5ccVYqi0UDWjx3vm9IXdnutM514_3yRrzqczVavudQ%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D",
"mimeType": "audio/webm; codecs=\"opus\"",
"bitrate": 49668,
"initRange": { "start": "0", "end": "265" },
"indexRange": { "start": "266", "end": "635" },
"lastModified": "1717047819209140",
"contentLength": "1232413",
"quality": "tiny",
"projectionType": "RECTANGULAR",
"averageBitrate": 46492,
"audioQuality": "AUDIO_QUALITY_LOW",
"approxDurationMs": "212061",
"audioSampleRate": "48000",
"audioChannels": 2,
"parsedContentLength": "1.18 MiB",
"lengthSeconds": "212",
"parsedLastModified": "2024-05-30T05:43:39.209Z"
},
{
"itag": 250,
"url": "https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=250&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fwebm&rqh=1&gir=yes&clen=1630086&dur=212.061&lmt=1717047822840442&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgI4Vwy12m6UidKdL0SqCi5G7nbKx1UAXev-TObNRRlGICIQDA0SL6AnZEqhpvypdLKdwR2QtcsUZQSVk-exV4Z10Vaw%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D",
"mimeType": "audio/webm; codecs=\"opus\"",
"bitrate": 65984,
"initRange": { "start": "0", "end": "265" },
"indexRange": { "start": "266", "end": "636" },
"lastModified": "1717047822840442",
"contentLength": "1630086",
"quality": "tiny",
"projectionType": "RECTANGULAR",
"averageBitrate": 61494,
"audioQuality": "AUDIO_QUALITY_LOW",
"approxDurationMs": "212061",
"audioSampleRate": "48000",
"audioChannels": 2,
"parsedContentLength": "1.55 MiB",
"lengthSeconds": "212",
"parsedLastModified": "2024-05-30T05:43:42.840Z"
},
{
"itag": 251,
"url": "https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=251&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fwebm&rqh=1&gir=yes&clen=3437753&dur=212.061&lmt=1717047822556748&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRAIgPQ-Q-5PkH0mnKI6pXIOEj7f_qrvovoGY7VCh8F4M7ZQCIGy0TOgdwKUHiE3xi0Jm8VqfgUXpQ9TlSSZtk4xXHdcV&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D",
"mimeType": "audio/webm; codecs=\"opus\"",
"bitrate": 136946,
"initRange": { "start": "0", "end": "265" },
"indexRange": { "start": "266", "end": "636" },
"lastModified": "1717047822556748",
"contentLength": "3437753",
"quality": "tiny",
"projectionType": "RECTANGULAR",
"averageBitrate": 129689,
"audioQuality": "AUDIO_QUALITY_MEDIUM",
"approxDurationMs": "212061",
"audioSampleRate": "48000",
"audioChannels": 2,
"parsedContentLength": "3.28 MiB",
"lengthSeconds": "212",
"parsedLastModified": "2024-05-30T05:43:42.556Z"
}
]