Ir para o conteúdo
yt-dlp

Gerador de comandos yt-dlp para Instagram

Monte um comando do yt-dlp para posts e reels do Instagram. Os cookies já vêm ligados porque quase nada funciona sem eles.

Opcional. Se deixar vazio, o comando termina em URL para você preencher.

Seu comando

yt-dlp --merge-output-format mp4 --no-playlist --cookies-from-browser chrome https://www.instagram.com/p/Cxxxxxxxxxx/
Básico

Só áudio extrai a trilha sonora e descarta o vídeo.

Vídeo e qualidade

Limita a altura. O yt-dlp ainda escolhe a melhor faixa nesse limite ou abaixo.

O tipo de arquivo em que as faixas separadas de vídeo e áudio são unidas.

Opções avançadas (3)

Substitui a lista de qualidade. Para quem já conhece a sintaxe de formatos.

Reempacota as faixas sem recodificar. Rápido e sem perdas.

Recodifica o vídeo. Lento e com perdas — só quando remux não resolver.

Áudio

O arquivo para o qual o áudio é convertido.

VBR dá a melhor relação tamanho-qualidade; bitrates fixos são mais previsíveis.

Legendas

Embutir coloca as legendas dentro do vídeo; salvar grava um .srt separado ao lado.

Separados por vírgula. Use all para todos os idiomas disponíveis.

Playlists e canais

O que fazer quando a URL pertence a um vídeo e a uma playlist ao mesmo tempo.

Intervalos e listas funcionam, por exemplo 1-10,15 ou -5::2 para um a cada dois de trás para frente.

Opções avançadas (1)

Anota o que já foi baixado para que uma nova execução pule. É assim que se mantém um canal sincronizado.

Trechos e capítulos
Opções avançadas (2)

Um intervalo como *00:01:30-00:03:00, ou o nome de um capítulo. O asterisco na frente indica que é um horário.

Metadados e capa
Opções avançadas (3)
SponsorBlock

Corta do arquivo os trechos marcados pela comunidade, usando os dados do SponsorBlock.

Opções avançadas (1)

Mantém os trechos, mas marca-os para você pular por conta própria.

Arquivos e pastas

Os campos vão em %(...)s. Barras criam pastas.

Opções avançadas (4)

Onde os arquivos são gravados. Combine com o modelo acima para criar subpastas.

Tamanho máximo do nome do arquivo, em caracteres.

Filtros
Opções avançadas (5)

AAAAMMDD, ou uma data relativa como now-1month.

AAAAMMDD, ou uma data relativa.

Pula o que for menor. Aceita 5M, 500K e similares.

Pula o que for maior.

Quantidade de arquivos a baixar antes de parar.

Rede

Por exemplo 2M ou 500K. Útil quando você precisa do resto da banda.

Opções avançadas (5)

Acelera faixas fragmentadas. Quatro é um bom ponto de partida.

Quantas vezes tentar de novo uma parte que falhou. infinite é aceito.

URL de proxy HTTP, HTTPS ou SOCKS.

Faz as requisições parecerem de um navegador real. É a solução comum para um 403 repentino.

Login e cookies

Lê sua sessão logada diretamente. Necessário para conteúdo privado, com restrição de idade ou só para membros.

Opções avançadas (1)

Um cookies.txt no formato Netscape exportado do seu navegador.

Transmissões ao vivo
Opções avançadas (2)

Consulta até uma transmissão agendada começar. MIN-MAX segundos entre as checagens.

Contornos
Opções avançadas (3)

Obsoleto em favor de --add-headers. Mantido porque muitos guias antigos ainda usam.

Obsoleto em favor de --add-headers.

Opções específicas de cada site, por exemplo youtube:player_client=web.

Saída e depuração
Opções avançadas (2)
Redefinir

O Instagram precisa de uma sessão

O Instagram entrega muito pouco a requisições sem login, então --cookies-from-browser é obrigatório na prática, não opcional. Feche o navegador antes de rodar o comando: Chrome e Edge travam o banco de cookies enquanto estão abertos.

Um carrossel é exposto como playlist, então coloque o modo de playlist em playlist inteira para pegar todos os itens. Stories exigem uma sessão que siga a conta e desaparecem em 24 horas.

O Instagram desconfia cada vez mais do acesso automatizado, e uma sessão que baixa demais rápido demais recebe o pedido de logar de novo — a pista é um comando que funcionava ontem e hoje devolve uma página de login. Use uma conta dedicada em vez da principal, mantenha os cookies dela frescos entrando normalmente de vez em quando, e aceite que uma conta usada assim ocasionalmente é marcada, por mais bem escrito que o comando esteja. Esse é o custo da plataforma, não um bug do yt-dlp.

Posts, reels e destaques resolvem pelo mesmo extrator mas mostram coisas diferentes a sessões diferentes. Reels de contas que você segue baixam bem; reels da página de explorar muitas vezes se recusam para uma sessão que nunca interagiu com aquele conteúdo. Os destaques — os círculos de stories fixados num perfil — cada um desce como uma playlist de suas stories. O IGTV foi aposentado: links antigos às vezes ainda resolvem, mas nada novo o usa.

O Instagram limita mais duro que qualquer outra plataforma que o yt-dlp enfrenta com regularidade. Fragmentos em paralelo pioram as coisas, não melhoram; um item por vez com pausas entre rodadas é o padrão que sobrevive. Uma rodada de vários itens que falha no meio é normal — o arquivo de registro mais continuar após um erro transforma a nova tentativa numa retomada em vez de um recomeço, o que importa porque quando a rodada termina, as URLs de CDN dos primeiros itens normalmente já expiraram, e uma rodada completa traria páginas de novo em vez de mídia.

O que não se recupera: posts de contas privadas que você não segue, stories passadas das vinte e quatro horas, e tudo que foi apagado antes de você rodar o comando. URLs de CDN dentro de uma página baixada expiram rápido, então uma URL de mídia que funcionava uma hora atrás pode se recusar agora — busque de novo a página do post em vez de retentar o link velho. Essa expiração é também o argumento para baixar logo e não um dia: o Instagram não promete manter a mídia alcançável — e cumpre isso.

Perguntas frequentes

Por que o Instagram falha sem cookies?
O Instagram quase não entrega nada a requisições sem login. --cookies-from-browser é praticamente obrigatório, e a sessão precisa pertencer a uma conta que consiga ver o post.
Posso baixar stories ou reels?
Reels se comportam como posts normais. Stories exigem uma sessão que siga a conta e expiram em 24 horas.
Como pego todos os itens de um carrossel?
Coloque o modo de playlist em playlist inteira — o yt-dlp trata um post de vários itens como uma playlist.