Teste a API de Download e Informações do YouTube do Zyla API Hub com Postman

Sua equipe de produto precisa de um downloader do YouTube funcionando esta semana, e você precisa verificá-lo de ponta a ponta no Postman antes de integrá-lo ao seu backend. Ao final deste guia, você será capaz de autenticar-se com o Zyla API Hub, acessar o endpoint de Download da API de Download e Informações do YouTube no Postman e recuperar programaticamente o ID do trabalho e a URL da miniatura que você pode usar para rastrear e apresentar o progresso aos seus usuários.

O que a API de Download e Informações do YouTube faz

A API de Download e Informações do YouTube fornece um endpoint HTTP simples para iniciar downloads de vídeos regulares do YouTube em formatos específicos (resoluções de vídeo ou formatos de áudio) e retorna um JSON curto com um ID de trabalho de download único, a URL da imagem em miniatura do vídeo e uma URL de progresso. É comumente usada em:

Ilustração: Teste a API de Download e Informações do YouTube do Zyla API Hub com Postman

Trabalhadores do lado do servidor que enfileiram uma conversão e verificam o progresso.
Serviços de backend para frontend que retornam um ID de trabalho para os clientes para atualizações de UI.
Ferramentas internas que precisam de uma maneira rápida de buscar um arquivo reproduzível em um formato específico.

Anotações que você deve planejar em sua implementação:

Os links de download de áudio expiram após 2 horas.
Este endpoint suporta apenas o download de vídeos regulares.

Começando no Zyla API Hub

Abra a página da API de Download e Informações do YouTube no Zyla API Hub: API de Download e Informações do YouTube. Clique em Inscrever-se (ou Iniciar Teste Gratuito quando disponível), em seguida, gere uma chave de API. A cobrança é por assinatura + cota (não é por chamada). A primeira API no Zyla geralmente oferece um teste de 7 dias ou 50 solicitações; não há Plano Gratuito. Verifique a página da API para opções de acesso e preços atuais.

Se você ainda não tem uma conta, crie uma aqui: Registrar. Você pode explorar outras categorias e APIs a qualquer momento no Zyla API Hub.

Endpoint que você testará no Postman

A API expõe um único endpoint de acionamento para download que você pode invocar com a URL do vídeo e o formato desejado.

Download (GET)

Método: GET
URL: https://zylalabs.com/api/11016/youtube-download-and-info-api/20761/download
Auth: Cabeçalho de autorização com token Bearer
Parâmetros de consulta obrigatórios:
- url (string): A URL do vídeo do YouTube. Exemplo: https://www.youtube.com/watch?v=aGSKrC7dGcY
- format (string): Formato de saída desejado.

Valores aceitos para o parâmetro de formato:

Vídeos: 360p, 480p, 720p, 1080p, 1440p, 2160p
Áudios: mp3, m4a, flac, opus, wav

Anotações:

Os links de download de áudio expiram após 2 horas.
Este endpoint suporta apenas o download de vídeos regulares.

Postman: passo a passo

1) Crie uma nova solicitação

No Postman, clique em Novo → Solicitação HTTP. Defina o método como GET.

2) Defina a URL da solicitação

Cole o endpoint completo com os parâmetros de consulta (você pode colar a forma codificada ou usar a aba 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

Se estiver usando a interface Params no Postman, adicione:

Chave: url | Valor: https://www.youtube.com/watch?v=aGSKrC7dGcY
Chave: format | Valor: 720

3) Adicione o cabeçalho de autorização

Em Cabeçalhos, adicione:

Chave: Authorization
Valor: Bearer YOUR_API_KEY

Substitua YOUR_API_KEY pela chave da sua conta Zyla.

4) Envie e inspecione a resposta

Clique em Enviar. Você deve receber um payload JSON com campos que pode usar para rastrear o trabalho e mostrar uma imagem de pré-visualização ao usuário.

cURL oficial que você pode importar para o Postman

Você também pode importar este cURL exato para o Postman (Arquivo → Importar → Texto bruto) para obter uma solicitação pré-preenchida:

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"

Exemplo de resposta JSON

{
"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 dos campos que você realmente usará:

success: Booleano indicando que a solicitação foi aceita.
id: Identificador único do trabalho para o download iniciado.
image: Uma URL de miniatura (útil para sua UI enquanto o download está em progresso).
progress_url: Uma URL que você pode usar para rastrear o progresso do trabalho do seu lado.

Exemplo de código: JavaScript (Node.js)

Este exemplo em Node.js chama o mesmo endpoint, analisa o JSON e registra os campos que você integrará ao seu rastreamento de trabalho e código de UI. Ele usa apenas a URL e os parâmetros documentados.

import fetch from "node-fetch";

const API_KEY = process.env.ZYLA_API_KEY; // defina YOUR_API_KEY em env
const videoUrl = "https://www.youtube.com/watch?v=aGSKrC7dGcY";
const format = "720"; // veja a lista de valores suportados abaixo

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 por amostra oficial:
// success, id, image, progress_url
console.log("Aceito:", data.success);
console.log("ID do Trabalho:", data.id);
console.log("Miniatura:", data.image);
console.log("URL de Progresso:", data.progress_url);

// Agora você pode persistir data.id e data.progress_url para consultar de um trabalhador/UI.
}

startDownload().catch(err => {
console.error("Falha ao iniciar download:", err);
});

Valores de formato suportados:

Vídeo: 360p, 480p, 720p, 1080p, 1440p, 2160p
Áudio: mp3, m4a, flac, opus, wav

Anotações de implementação:

Os links de download de áudio expiram após 2 horas; planeje seu fluxo de trabalho de acordo.
Este endpoint suporta apenas vídeos regulares.

Dicas de integração do mundo real

Codificação de URL: Se você construir manualmente a string de consulta, certifique-se de que a URL do YouTube esteja codificada em porcentagem, como mostrado no exemplo de cURL. Clientes de alto nível (URL, aba Params no Postman) lidam com isso para você.
Tratamento de Auth: Mantenha o cabeçalho de autorização como Bearer YOUR_API_KEY. Não envie chaves como parâmetros de consulta.
Rastreamento de trabalho: Persista imediatamente o id e progress_url em seu datastore para que trabalhadores ou clientes possam consultar e atualizar a UI.
Seleção de formato: Ofereça apenas o conjunto documentado aos usuários. Para vídeo: 360p, 480p, 720p, 1080p, 1440p, 2160p. Para áudio: mp3, m4a, flac, opus, wav.
UX ciente da expiração: Se você apresentar links de áudio aos usuários finais, mostre mensagens sensíveis ao tempo, pois os links expiram após 2 horas.
Superfícies de erro: Se você receber uma resposta não 2xx, registre tanto o status quanto o corpo para depuração (como mostrado no exemplo JS).

Usando a API de agentes de IA via MCP

Toda API no Zyla pode ser chamada de agentes de IA que suportam o Protocolo de Contexto do Modelo (MCP). Aponte seu cliente compatível com MCP (por exemplo, Claude Code, Cursor, Windsurf) para o endpoint MCP e forneça sua chave de API Zyla. Veja os detalhes do MCP aqui: MCP. O mesmo cabeçalho de autorização se aplica: Bearer YOUR_API_KEY. Uma vez que a ferramenta esteja configurada, solicite ao agente que invoque o endpoint de Download com os parâmetros url e format para iniciar um trabalho e retornar o id, image e progress_url.

Fluxos de trabalho comuns que você pode implementar esta semana

API de backend para o botão “Download”: Seu serviço recebe uma URL do YouTube, valida-a e chama o endpoint de Download com uma resolução ou formato de áudio selecionado pelo usuário. Ele retorna o id do trabalho e image imediatamente para uma UI responsiva.
Conversão baseada em trabalhador: Um trabalhador em segundo plano lê trabalhos enfileirados, monitora progress_url e atualiza o estado do banco de dados para que seus clientes exibam o progresso ao usuário.
Fluxo apenas de áudio: Para ferramentas de podcasting ou bibliotecas de som, solicite formatos de áudio (mp3, m4a, flac, opus, wav) e apresente um lembrete de que os links expiram após 2 horas.

Recapitulação: campos mínimos que você precisa integrar

Endpoint: GET https://zylalabs.com/api/11016/youtube-download-and-info-api/20761/download
Cabeçalhos: Authorization: Bearer YOUR_API_KEY
Parâmetros de consulta: url, format
Campos principais da resposta: success, id, image, progress_url

Adicione a página da API aos favoritos para referência: API de Download e Informações do YouTube no Zyla. Explore outras APIs prontas para uso em várias categorias no Zyla API Hub.

FAQ

Há um plano gratuito?
Não há Plano Gratuito. O Zyla utiliza um modelo de assinatura + cota. A primeira API geralmente oferece um teste de 7 dias ou 50 solicitações. Verifique a página da API para opções atuais.

Quais formatos posso solicitar?
Vídeo: 360p, 480p, 720p, 1080p, 1440p, 2160p. Áudio: mp3, m4a, flac, opus, wav.

Como faço para autenticar?
Envie o cabeçalho Authorization: Bearer YOUR_API_KEY com cada solicitação.

Posso baixar transmissões ao vivo?
Este endpoint suporta apenas o download de vídeos regulares.

Os links de download expiram?
Os links de download de áudio expiram após 2 horas. Projete seu fluxo para buscá-los e consumi-los prontamente.

Pronto para testá-lo no Postman e implementar sua integração? Crie sua conta, inscreva-se na API e obtenha sua chave aqui: Registrar. Em seguida, abra a página da API de Download e Informações do YouTube e execute o endpoint de Download conforme mostrado acima.