Tu equipo de producto necesita un descargador de YouTube funcional esta semana, y necesitas verificarlo de extremo a extremo en Postman antes de integrarlo en tu backend. Al final de esta guía, podrás autenticarte con Zyla API Hub, acceder al endpoint de Descarga de la API de Descarga e Información de YouTube en Postman, y recuperar programáticamente el ID del trabajo y la URL de la miniatura que puedes usar para rastrear y presentar el progreso a tus usuarios.
Qué hace la API de Descarga e Información de YouTube
La API de Descarga e Información de YouTube proporciona un endpoint HTTP simple para iniciar descargas de videos de YouTube regulares en formatos específicos (resoluciones de video o formatos de audio) y devuelve un JSON corto con un ID de trabajo de descarga único, la URL de la imagen en miniatura del video y una URL de progreso. Se utiliza comúnmente en:
- Trabajadores del lado del servidor que encolan una conversión y sondean el progreso.
- Servicios de backend para frontend que devuelven un ID de trabajo a los clientes para actualizaciones de UI.
- Herramientas internas que necesitan una forma rápida de obtener un archivo reproducible en un formato específico.
Notas que deberías planear en tu implementación:
- Los enlaces de descarga de audio expiran después de 2 horas.
- Este endpoint solo admite la descarga de videos regulares.
Comenzando en Zyla API Hub
Abre la página de la API de Descarga e Información de YouTube en Zyla API Hub: API de Descarga e Información de YouTube. Haz clic en Suscribirse (o Comenzar Prueba Gratuita cuando esté disponible), luego genera una clave API. La facturación es por suscripción + cuota (no por llamada). La primera API en Zyla generalmente ofrece una prueba de 7 días o 50 solicitudes; no hay Plan Gratuito. Consulta la página de la API para las opciones de acceso y precios actuales.
Si aún no tienes una cuenta, crea una aquí: Registrarse. Puedes explorar otras categorías y APIs en cualquier momento en Zyla API Hub.
Endpoint que probarás en Postman
La API expone un único endpoint de activación descargable que puedes invocar con la URL del video y el formato deseado.
Descargar (GET)
- Método: GET
- URL: https://zylalabs.com/api/11016/youtube-download-and-info-api/20761/download
- Auth: Encabezado de autorización con token Bearer
- Parámetros de consulta requeridos:
- url (string): La URL del video de YouTube. Ejemplo: https://www.youtube.com/watch?v=aGSKrC7dGcY
- format (string): Formato de salida deseado.
Valores aceptados para el parámetro de formato:
- Videos: 360p, 480p, 720p, 1080p, 1440p, 2160p
- Audios: mp3, m4a, flac, opus, wav
Notas:
- Los enlaces de descarga de audio expiran después de 2 horas.
- Este endpoint solo admite la descarga de videos regulares.
Postman: paso a paso
1) Crea una nueva solicitud
En Postman, haz clic en Nuevo → Solicitud HTTP. Establece el método en GET.
2) Establece la URL de la solicitud
Pega el endpoint completo con los parámetros de consulta (puedes pegar la forma codificada o usar la pestaña Params):
https://zylalabs.com/api/11016/youtube-download-and-info-api/20761/download?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DaGSKrC7dGcY&format=720
Si usas la interfaz de Params en Postman, agrega:
- Clave:
url| Valor:https://www.youtube.com/watch?v=aGSKrC7dGcY - Clave:
format| Valor:720
3) Agrega el encabezado de autorización
Bajo Encabezados, agrega:
- Clave:
Authorization - Valor:
Bearer YOUR_API_KEY
Reemplaza YOUR_API_KEY con la clave de tu cuenta de Zyla.
4) Envía y revisa la respuesta
Haz clic en Enviar. Deberías recibir una carga útil JSON con campos que puedes usar para rastrear el trabajo y mostrar una imagen de vista previa al usuario.
cURL oficial que puedes importar en Postman
También puedes importar este cURL exacto en Postman (Archivo → Importar → Texto sin formato) para obtener una solicitud prellenada:
curl -s -X GET "https://zylalabs.com/api/11016/youtube-download-and-info-api/20761/download?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DaGSKrC7dGcY&format=720" \
-H "Authorization: Bearer YOUR_API_KEY"Respuesta JSON de ejemplo
{
"success": true,
"id": "2ec15939807689549d3f3115f168be6b9c868105",
"image": "https://i.ytimg.com/vi/aGSKrC7dGcY/hqdefault.jpg",
"progress_url": "https://youtube-api-progress-copy-development.up.railway.app/api/progress?id=2ec15939807689549d3f3115f168be6b9c868105"
}Significados de los campos que realmente usarás:
- success: Booleano que indica que la solicitud fue aceptada.
- id: Identificador único del trabajo para la descarga iniciada.
- image: Una URL de miniatura (útil para tu UI mientras la descarga está en progreso).
- progress_url: Una URL que puedes usar para rastrear el progreso del trabajo de tu lado.
Ejemplo de código: JavaScript (Node.js)
Este ejemplo de Node.js llama al mismo endpoint, analiza el JSON y registra los campos que conectarás a tu seguimiento de trabajos y código de UI. Utiliza solo la URL y los parámetros documentados.
import fetch from "node-fetch";
const API_KEY = process.env.ZYLA_API_KEY; // establece YOUR_API_KEY en env
const videoUrl = "https://www.youtube.com/watch?v=aGSKrC7dGcY";
const format = "720"; // consulta la lista de valores soportados a continuación
async function startDownload() {
const endpoint = "https://zylalabs.com/api/11016/youtube-download-and-info-api/20761/download";
const url = new URL(endpoint);
url.searchParams.set("url", videoUrl);
url.searchParams.set("format", format);
const res = await fetch(url.toString(), {
method: "GET",
headers: {
Authorization: `Bearer ${API_KEY}`
}
});
if (!res.ok) {
const text = await res.text();
throw new Error(`HTTP ${res.status}: ${text}`);
}
const data = await res.json();
// Campos esperados según el ejemplo oficial:
// success, id, image, progress_url
console.log("Aceptado:", data.success);
console.log("ID del trabajo:", data.id);
console.log("Miniatura:", data.image);
console.log("URL de progreso:", data.progress_url);
// Ahora puedes persistir data.id y data.progress_url para sondear desde un trabajador/UI.
}
startDownload().catch(err => {
console.error("Error al iniciar la descarga:", err);
});Valores de formato soportados:
- Video: 360p, 480p, 720p, 1080p, 1440p, 2160p
- Audio: mp3, m4a, flac, opus, wav
Notas de implementación:
- Los enlaces de descarga de audio expiran después de 2 horas; planifica tu flujo de trabajo en consecuencia.
- Este endpoint solo admite videos regulares.
Consejos de integración en el mundo real
- Codificación de URL: Si construyes manualmente la cadena de consulta, asegúrate de que la URL de YouTube esté codificada en porcentaje como se muestra en el ejemplo de cURL. Los clientes de alto nivel (URL, pestaña Params en Postman) manejan esto por ti.
- Manejo de Auth: Mantén el encabezado de autorización como
Bearer YOUR_API_KEY. No envíes claves como parámetros de consulta. - Seguimiento de trabajos: Persiste inmediatamente el
idyprogress_urlen tu almacén de datos para que los trabajadores o clientes puedan sondear y actualizar la UI. - Selección de formato: Ofrece solo el conjunto documentado a los usuarios. Para video: 360p, 480p, 720p, 1080p, 1440p, 2160p. Para audio: mp3, m4a, flac, opus, wav.
- UX consciente de la expiración: Si muestras enlaces de audio a los usuarios finales, muestra mensajes sensibles al tiempo porque los enlaces expiran después de 2 horas.
- Superficies de error: Si recibes una respuesta no 2xx, registra tanto el estado como el cuerpo para depuración (como se muestra en el ejemplo de JS).
Usando la API desde agentes de IA a través de MCP
Cada API en Zyla puede ser llamada desde agentes de IA que soportan el Protocolo de Contexto de Modelo (MCP). Apunta tu cliente compatible con MCP (por ejemplo, Claude Code, Cursor, Windsurf) al endpoint MCP y proporciona tu clave API de Zyla. Consulta los detalles de MCP aquí: MCP. El mismo encabezado de autorización se aplica: Bearer YOUR_API_KEY. Una vez que la herramienta esté configurada, solicita al agente que invoque el endpoint de Descarga con los parámetros url y format para iniciar un trabajo y devolver el id, image y progress_url.
Flujos de trabajo comunes que puedes implementar esta semana
- API de backend para el botón “Descargar”: Tu servicio recibe una URL de YouTube, la valida y llama al endpoint de Descarga con una resolución o formato de audio seleccionado por el usuario. Devuelve el
iddel trabajo yimageinmediatamente para una UI receptiva. - Conversión basada en trabajadores: Un trabajador en segundo plano lee trabajos en cola, monitorea
progress_urly actualiza el estado de la base de datos para que tus clientes muestren el progreso al usuario. - Flujo solo de audio: Para herramientas de podcasting o bibliotecas de sonido, solicita formatos de audio (mp3, m4a, flac, opus, wav) y muestra un recordatorio de que los enlaces expiran después de 2 horas.
Resumen: campos mínimos que necesitas para integrar
- Endpoint: GET https://zylalabs.com/api/11016/youtube-download-and-info-api/20761/download
- Encabezados: Authorization: Bearer YOUR_API_KEY
- Parámetros de consulta: url, format
- Campos centrales de respuesta: success, id, image, progress_url
Marca la página de la API para referencia: API de Descarga e Información de YouTube en Zyla. Explora otras APIs listas para usar en diferentes categorías en Zyla API Hub.
FAQ
¿Hay un plan gratuito?
No hay Plan Gratuito. Zyla utiliza un modelo de suscripción + cuota. La primera API generalmente ofrece una prueba de 7 días o 50 solicitudes. Consulta la página de la API para las opciones actuales.
¿Qué formatos puedo solicitar?
Video: 360p, 480p, 720p, 1080p, 1440p, 2160p. Audio: mp3, m4a, flac, opus, wav.
¿Cómo me autentico?
Envía el encabezado Authorization: Bearer YOUR_API_KEY con cada solicitud.
¿Puedo descargar transmisiones en vivo?
Este endpoint solo admite la descarga de videos regulares.
¿Los enlaces de descarga expiran?
Los enlaces de descarga de audio expiran después de 2 horas. Diseña tu flujo para obtener y consumirlos rápidamente.
¿Listo para probarlo en Postman y enviar tu integración? Crea tu cuenta, suscríbete a la API y obtén tu clave aquí: Registrarse. Luego abre la página de la API de Descarga e Información de YouTube y ejecuta el endpoint de Descarga como se muestra arriba.
