API de descarga multimedia desde YouTube.
Los archivos se cachean con el base64. Si ya existe en cache se entrega directamente sin llamar al scraper.
GET
/api/info
query
URL, ID del video o termino de busqueda
requerido
Por URL
Por busqueda (usa cache si ya fue descargado antes)
"status": true,
"data": {
"videoId": "dQw4w9WgXcQ",
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"titulo": "Rick Astley - Never Gonna Give You Up",
"duracion": "3:32",
"autor": "Rick Astley",
"vistas": 1500000000,
"miniatura": "https://i.ytimg.com/vi/.../hqdefault.jpg",
"cached": true
}
GET
/api/download
query
Video ID, URL o titulo
requerido
format
Formato de salida
mp3 | mp4
MP3
MP4
Descargar a archivo
"status": true,
"cached": true,
"videoId": "dQw4w9WgXcQ",
"titulo": "Rick Astley - Never Gonna Give You Up",
"formato": "mp3",
"downloadUrl": "https://tudominio.com/dl/dQw4w9WgXcQ.mp3"
"status": false,
"error": "Todos los scrapers fallaron para: ..."
GET
/dl/:videoId.:format
Endpoint proxy que sirve el archivo binario directamente desde cache. Recibe el videoId y la extension. Si el archivo esta en memoria o GitHub lo entrega, si no devuelve 404.
Descargar archivo
Content-Type: audio/mpeg
Content-Disposition: attachment; filename="Rick Astley - Never Gonna Give You Up.mp3"
Content-Length: 3456789
Accept-Ranges: bytes
GET
Error — sin resultados
Busqueda invalida
"status": false,
"error": "No se encontraron resultados."