Resolvendo o erro HTTP 429 Too Many Requests do yt-dlp

Entendendo o erro HTTP 429 do yt-dlp
HTTP 429 Too Many Requests significa que o YouTube limitou seu endereço IP. Quem usa yt-dlp vê isso na maioria das vezes depois que um script de batch tenta puxar uma playlist com mais de 50 vídeos em sequência, ou quando um IP compartilhado (universidade, escritório, nó de saída de VPN) já gastou o orçamento de requisições daquela hora. Diferente do 403, que costuma indicar um problema de assinatura ou token, o 429 é puramente sobre frequência de requisições. A solução é esperar, mudar de IP, ou parar de mandar tantas requisições tão rápido.
Por que acontece
O YouTube aplica cotas de requisição por IP para se defender de scraping. Com as configurações padrão, o yt-dlp envia várias requisições por vídeo (metadados, decifragem de assinatura, URL do stream, segmentos). Uma playlist multiplica isso rapidamente. Se você também estiver com outras abas do YouTube abertas usando o mesmo IP, atinge o limite mais cedo do que esperaria.
Gatilhos comuns:
--yes-playlistem uma playlist longa sem--sleep-interval- Vários processos do yt-dlp rodando em paralelo
- IPs NAT compartilhados (corporativos, dormitórios, CGNAT de operadora móvel)
- Nós de saída de VPN nos quais outros usuários também acessam o YouTube
- Reexecutar um lote falho imediatamente em vez de retomar
O que você pode tentar com o yt-dlp
- Esperar de 1 a 6 horas. O limite de taxa se reseta sozinho.
- Adicionar
--sleep-interval 5 --max-sleep-interval 20para reduzir o ritmo. - Adicionar
--retries 10 --retry-sleep linear=10:300:30para que os retries façam backoff. - Trocar a rede — hotspot do celular, outro nó VPN, conexão de casa.
- Autenticar com
--cookiesdo seu navegador; requisições logadas ganham uma cota um pouco maior.
Nenhuma elimina o 429 por completo — apenas reduzem a chance de bater nele.
Usar o Any4K em vez disso
O Any4K faz o parse no lado do servidor. Seu IP nunca conversa direto com o YouTube, então os limites por usuário não se aplicam da mesma forma. Para um vídeo só ou um punhado deles, basta colar a URL em any4k.com e baixar. Sem sleep intervals para ajustar, sem estratégias de retry para escrever.
Vantagens do Any4K em situações de rate limit
- Sem exposição do seu IP pessoal: a infraestrutura do Any4K conversa com o YouTube; você só baixa o arquivo pronto.
- Teto de qualidade mais alto: até 8K quando a fonte tem.
- Multiplataforma: a mesma UI para YouTube, TikTok, Twitter, Instagram, Facebook, Reddit e Shorts.
- Sem instalação: abre em qualquer navegador.
Quando o yt-dlp ainda é a escolha certa
Trabalhos de arquivamento em massa com centenas de vídeos, extração de legendas e embed de metadados são onde o yt-dlp brilha. Para esses, aceite que o 429 faz parte do fluxo e ajuste os sleep intervals de acordo. Para vídeos isolados ou pequenos lotes, Any4K é mais rápido de ponta a ponta.
Conclusão
429 não é um bug — é a modelagem de tráfego do YouTube. O yt-dlp pode ser ajustado para conviver com isso, ou você pode contornar o limite por IP usando uma ferramenta do lado do servidor, como o Baixador de vídeos Any4K.