Este guia mostra como escolher uma URL canônica, simular a extração, usar uma sessão de navegador que você controla, limitar o primeiro lote, proteger execuções repetidas com um arquivo de histórico e separar problemas de acesso de erros de configuração.
Comece com uma URL pública de post, perfil ou mídia do Instagram entre aspas e acrescente --simulate. Se o extrator pedir autenticação, entre normalmente em um perfil de navegador que você controla e use --cookies-from-browser. Depois de um teste pequeno, adicione um arquivo de histórico estável e só então passe opções revisadas para a configuração.
Use o tipo exato de URL que deseja verificar: um post público, perfil ou página de mídia copiada da barra de endereços normal. Evite links encurtados, parâmetros de rastreamento, redirecionamentos móveis e URLs recebidas em mensagens privadas até confirmar a página canônica no seu navegador.
A primeira execução normalmente deve ser uma simulação. Ela separa instalação, reconhecimento da URL, acesso e seleção de arquivos antes de gravar mídia. Coloque a URL entre aspas para que caracteres do shell não alterem o comando.
gallery-dl --simulate "https://www.instagram.com/p/POST_ID/"gallery-dl --simulate "https://www.instagram.com/USERNAME/"gallery-dl -K "https://www.instagram.com/p/POST_ID/"POST_ID e USERNAME são marcadores. Use uma URL e conteúdo que você pode acessar, veja a saída simulada e só depois remova --simulate.
A lista upstream de sites compatíveis inclui o Instagram e indica Cookies entre os métodos de autenticação mostrados. Isso é uma referência de planejamento, não uma promessa para todas as páginas, contas, regiões ou variações de URL. A versão instalada e a URL exata são a evidência prática.
Um post público único é um bom primeiro diagnóstico. Perfis, Reels, Stories e áreas personalizadas podem exigir uma sessão válida e regras de acesso diferentes; simule exatamente a URL que será usada.
Um post público é o caso de diagnóstico mais pequeno. Confirme extrator, mídia, nome do arquivo e destino antes de testar uma conta inteira.
Uma URL de perfil pode selecionar muitos itens e exigir autenticação. Comece com uma faixa pequena, sem percorrer toda a conta no primeiro teste.
Essas áreas dependem mais de sessão, expiração, privacidade e mudanças da plataforma. Simule a URL exata em vez de inferir suporte de outra página.
| URL ou objetivo | Primeiro teste | Nota de autenticação |
|---|---|---|
| Um post público | --simulate URL | Diagnóstico anônimo mais claro |
| Perfil ou página de mídia | --simulate --range 1-10 URL | Cookies podem ser necessários |
| Reels ou Stories | Simular a URL exata | Sessão e disponibilidade podem variar |
| Metadados ou filtros | -K URL | Confirme campos antes de criar filtros |
Quando o Instagram recusar uma solicitação anônima, entre normalmente em um perfil de navegador que você controla e confirme que o alvo abre ali. Depois indique esse perfil local ao gallery-dl. Não é necessário colar valores brutos de cookies neste site ou em um fórum público.
Feche o navegador completamente se o banco de cookies estiver bloqueado e selecione o perfil com a sessão ativa. Sessões expiradas, desafios de atividade, contas privadas, diferenças regionais e mudanças nas regras de requisição continuam sendo causas possíveis.
gallery-dl --cookies-from-browser firefox --simulate "https://www.instagram.com/USERNAME/"gallery-dl --cookies-from-browser chrome --simulate "https://www.instagram.com/USERNAME/"gallery-dl --cookies-from-browser edge --simulate "https://www.instagram.com/USERNAME/"Nunca publique bancos de cookies, caminhos de perfil, identificadores de sessão ou logs sem limpeza. Remova nomes locais e URLs privadas antes de pedir ajuda.
Depois de uma simulação bem-sucedida, mantenha a primeira execução real pequena. Use --range em perfis ou coleções, escolha uma pasta-base previsível e confira os primeiros caminhos. Assim você descobre vídeos, mídia repetida ou um escopo inesperado antes que o armazenamento cresça.
Para tarefas recorrentes, acrescente --download-archive em um caminho local estável. O arquivo registra IDs de extratores concluídos e ignora itens correspondentes depois. Ele evita duplicados, mas não substitui um backup dos arquivos.
gallery-dl --range "1-10" --destination "D:/Media/Instagram" "https://www.instagram.com/USERNAME/"gallery-dl --range "1-25" --download-archive "instagram.sqlite3" "https://www.instagram.com/USERNAME/"gallery-dl -K --simulate "https://www.instagram.com/p/POST_ID/"| Objetivo | Opção | Por que importa |
|---|---|---|
| Evitar um primeiro lote grande | --range 1-10 | Facilita revisar saída e acesso |
| Escolher uma pasta-raiz | --destination PATH | Mantém o trabalho em local previsível |
| Evitar downloads repetidos | --download-archive FILE | Guarda IDs concluídos |
| Ver campos de nome | -K URL | Mostra metadados antes dos filtros |
| Evitar surpresas da configuração | --config-ignore | Testa sem padrões carregados |
Mantenha valores experimentais na linha de comando, onde ficam visíveis e fáceis de remover. Só passe pasta-base, nomes, histórico, cookies e intervalos para uma configuração revisada depois que um comando limitado funcionar como esperado.
Uma configuração afeta todas as requisições correspondentes. Um filtro copiado pode selecionar nada quando o extrator expõe metadados diferentes. Confirme campos com -K, valide o JSON e compare com --config-ignore quando o resultado mudar.
{
"extractor": {
"base-directory": "D:/Media/Instagram",
"archive": "D:/Media/Instagram/archive.sqlite3"
}
}gallery-dl --config-ignore --simulate "https://www.instagram.com/USERNAME/"gallery-dl --config-statusNão inclua cookies, senhas, tokens, URLs privadas ou caminhos pessoais de navegador em uma configuração pública. Use marcadores e revise cada opção.
Nem todo erro do Instagram é resolvido com outra opção. Compare primeiro a URL exata no navegador comum e rode uma simulação limpa ignorando a configuração. Se ela funcionar, examine configuração, filtros, histórico e perfil do navegador um por vez.
Um banco de cookies bloqueado ou expirado é diferente de um limite de requisições. Um limite pede tempo e menos repetições, não uma sequência paralela de tentativas. Um resultado vazio também pode vir de URL incorreta, conteúdo indisponível, filtro restritivo ou item já presente no histórico.
| Sintoma | Primeira verificação | Próximo passo seguro |
|---|---|---|
| Resultado incompatível ou vazio | Copie a URL canônica e rode -E ou --simulate | Teste um post público antes do perfil |
| Cookies necessários | Abra o alvo no perfil selecionado | Atualize a sessão normal e feche o navegador |
| Atividade suspeita ou HTTP 429 | Pare repetições e confira o ritmo | Aguarde, reduza o escopo e consulte o upstream |
| Tudo é ignorado | Verifique o caminho do histórico | Use outro histórico apenas para diagnóstico |
| A configuração muda o resultado | Rode --config-ignore | Remova uma chave suspeita por vez |
gallery-dl é um downloader local, não um sistema de permissões. Baixe e reutilize somente mídia que você está autorizado a acessar, respeite privacidade, direitos autorais, regras da plataforma, permissões da conta e limites de requisição. A acessibilidade técnica não é licença para republicar conteúdo.
O comportamento do extrator pode mudar quando o Instagram muda o site ou suas regras de requisição. Em 6 de agosto de 2026, esta página verificou os metadados oficiais do PyPI e arquivos upstream; a versão confirmada foi gallery-dl 1.32.9. Confira novamente a versão quando um comando que funcionava deixar de funcionar.
A lista upstream atual inclui Instagram e mostra Cookies entre os métodos de autenticação da linha correspondente. A versão instalada, a URL, a conta, a região e o comportamento atual da plataforma ainda determinam o resultado; simule a URL exata primeiro.
Entre normalmente em um perfil de navegador que você controla, confirme a página e use --cookies-from-browser. Mantenha banco de cookies, sessões, caminhos de perfil e logs privados.
Uma URL de perfil pode selecionar muitos itens e exigir autenticação. Comece com --simulate e um --range pequeno, confira os caminhos e adicione um --download-archive estável antes de ampliar.
Confira URL canônica, extrator, sessão, filtros, configuração e histórico. Compare o comando normal com gallery-dl --config-ignore --simulate e reintroduza uma opção por vez.
Use --download-archive em um caminho local estável. Ele registra IDs concluídos e ignora correspondências posteriores, mas não é um backup dos arquivos.
Em 6 de agosto de 2026, gallery-dl 1.32.9 foi verificado pelos metadados oficiais do PyPI e pelos arquivos upstream. Confirme a release e o --version instalado antes de depender de comportamento sensível à versão.
Pare as repetições, reduza o escopo, aguarde e confirme a sessão normal do navegador. Não use tentativas paralelas para contornar um desafio; confira a release e as orientações upstream se o problema persistir.