Como baixar vídeos do YouTube

Antes de começar: a parte que todo mundo pula

Baixar só é lícito quando você tem o direito de fazer isso. Isso inclui seus próprios uploads, material publicado sob licença que permita cópia, vídeos em que o criador habilitou a opção de salvar e conteúdo para o qual você obteve permissão de reutilização. Não inclui pegar um videoclipe comercial ou um curso pago para redistribuir ou para montar uma biblioteca que você não licenciou.

Se a sua intenção é reenviar, montar uma compilação ou usar a trilha de fundo em um vídeo monetizado, a permissão é uma questão separada de o fluxo técnico conseguir alcançar o arquivo. O fluxo muitas vezes vai funcionar; esse não é o critério que importa.

Passo 1: copie o link correto

O link precisa identificar um único vídeo. No computador, copie da barra de endereços. No celular, use o menu de compartilhar e escolha Copiar link. Todos estes formatos levam ao mesmo id de vídeo de onze caracteres:

• https://www.youtube.com/watch?v=VIDEOID - a página de reprodução padrão
• https://youtu.be/VIDEOID - a forma curta de compartilhar
• https://m.youtube.com/watch?v=VIDEOID - o site móvel
• https://www.youtube.com/shorts/VIDEOID - um Short vertical

Uma página de playlist, de canal ou de resultados de busca não funciona, porque nenhuma delas identifica um único vídeo. Se o seu link tiver um parâmetro de lista, a parte do vídeo continua ali, então esses links são aceitos; o contexto da playlist é ignorado.

Passo 2: cole e deixe o servidor consultar

Cole o link no campo de qualquer ferramenta e clique no botão principal. Duas coisas acontecem em sequência, e vale saber qual é qual:

• Validação seu link é analisado localmente no servidor. O protocolo precisa ser http ou https, o host precisa estar na lista permitida do YouTube e um id de vídeo válido precisa ser extraído. Esta etapa não faz nenhuma chamada de rede e falha na hora com INVALID_URL ou UNSUPPORTED_PLATFORM quando não passa.
• Resolução o link validado é entregue ao backend de análise configurado. Esta é a etapa que pode demorar e a que falha com PROVIDER_UNAVAILABLE quando não há backend configurado no servidor.

Apenas a URL normalizada é repassada. Parâmetros de rastreamento do menu de compartilhar são removidos antes de a requisição sair do servidor.

Passo 3: leia os resultados com honestidade

O painel de resultados é uma tabela do que o backend realmente devolveu, não um menu que inventamos. Três colunas importam:

• Contêiner mp4, webm, m4a. Isso diz o que vai rodar nativamente no seu dispositivo e o que o seu editor aceita.
• Tipo vídeo, áudio, somente vídeo ou somente áudio. Uma linha somente de vídeo em 1080p não está quebrada: é assim que a plataforma armazena altas resoluções, e ela precisa de uma faixa de áudio para ser útil.
• Disponível se foi emitido um link de download funcional para aquela linha. Linhas sem link aparecem para que você veja que existem, e não são escondidas em silêncio.

Se o painel diz que a análise está indisponível, isso é um fato da instalação e não um problema temporário: este servidor ainda não tem backend de análise configurado.

Passo 4: escolha um formato que sirva ao dispositivo

Escolha pensando em onde o arquivo vai ficar, não no número maior. Um fluxo 4K somente de vídeo é a escolha errada para um celular com pouco espaço e sem ferramenta de muxing.

• Celular ou tablet, assistindo ali MP4 progressivo com áudio; 720p ou 1080p já sobra em tela pequena.
• Arquivar ou editar a versão de vídeo mais alta com a faixa de áudio correspondente, e muxing local depois.
• Somente áudio, em aparelhos atuais M4A com o bitrate mais alto informado. Converta para MP3 depois apenas se o aparelho exigir.
• Com dados limitados confira a coluna de tamanho estimado antes de começar, principalmente em dados móveis.

Resolver os erros que você vai ver de fato

Cada falha corresponde a uma causa específica. Erros vagos não ajudam ninguém, então a API devolve códigos e a interface mostra esses códigos.

• INVALID_URL o texto não era uma URL, ou a URL não tinha id de vídeo. Normalmente é um link de playlist ou de canal copiado.
• UNSUPPORTED_PLATFORM o host não está na lista permitida. Hoje o TikTok é a plataforma principal, com outras suportadas de forma parcial.
• PROVIDER_UNAVAILABLE não há backend de análise configurado ou acessível no servidor. O seu link não tem nada de errado.
• RATE_LIMITED consultas demais da sua rede em pouco tempo. Aguarde um momento e tente de novo.
• VIDEO_UNAVAILABLE o backend não conseguiu resolver o vídeo: privado, removido, com restrição de idade ou bloqueado por região.
• DOWNLOAD_UNAVAILABLE o formato existe, mas não foi possível emitir um link direto utilizável agora.
• INTERNAL_ERROR uma falha inesperada no servidor. Tentar de novo é razoável; se se repetir, avise pela página de contato.

Como lidar com links temporários

A URL de download de um provedor é um ponteiro assinado e com prazo, não um endereço permanente. Duas consequências. Primeiro, não salve uma URL de download nos favoritos: ela vai parar de funcionar, talvez antes do que você imagina. Segundo, se um download falhar no meio, o correto é iniciar de novo para que um link novo seja emitido, em vez de repetir o que já morreu.

Isso também explica como o download é produzido. Quando uma plataforma entrega imagem e som como dois fluxos, nenhum deles isolado é um arquivo reproduzível, então o servidor baixa os dois, reencapsula num único MP4 e envia o resultado. O arquivo existe no servidor apenas enquanto é preparado e por alguns minutos depois; em seguida é apagado.

O que este site decide não fazer

Não contorna controles de acesso, DRM, travas de idade ou paywalls, e não aceita credenciais. Não repassa nem recodifica vídeo no servidor. Não expande playlists nem baixa canais em massa. Não guarda histórico dos seus downloads. São decisões de produto, não recursos que faltam, e são a razão de o serviço seguir gratuito de operar.