Ambas são ferramentas gratuitas de linha de comando para download, e as duas conseguem baixar suas publicações do Instagram para o disco. Elas se diferenciam na forma de login, no controle do ritmo das requisições e na quantidade de metadados que entregam. Nenhuma das duas restaura algo de volta para o Instagram.
Resposta curta
- Instaloader foi criado em torno do Instagram. Ele baixa perfis públicos e privados, hashtags, stories, feeds e mídias salvas, além de comentários, geotags e legendas, e a documentação diz que ele é adequado para rodar como cronjob para atualizar um arquivo pessoal.
- gallery-dl é um downloader geral para galerias de imagens e coleções de vários sites de hospedagem de imagens. O Instagram é um entre muitos sites suportados, e ele faz login com cookies.
Se o Instagram é tudo o que você precisa, o Instaloader é a opção mais focada. Se você já usa o gallery-dl para outros sites, ele também cobre o Instagram com uma lista ampla de recursos. Sobre o risco para a conta, as fontes que encontramos documentam o comportamento principalmente do Instaloader e não trazem evidência de banimento específica do gallery-dl, então qualquer comparação de risco entre as duas é uma inferência.
Não quer cuidar de um script, de um arquivo de sessão ou de cookies? O SocialGuardian precisa apenas do seu @ público - sem senha, sem login. Comece um teste gratuito de 30 dias
Comparação lado a lado
| Instaloader | gallery-dl | |
|---|---|---|
| Instalação | pip3 install instaloader; licença MIT | python -m pip install -U gallery-dl, além de executáveis independentes, Snap, Chocolatey, Scoop, Homebrew, MacPorts, Docker, Nix; GPL-2.0 |
| Comando básico | instaloader profile [profile ...] | gallery-dl [OPTIONS]... URLS... |
| Método de login | --login USERNAME salva um cookie de sessão, não sua senha | Cookies (cookies.txt, ou a partir de um navegador) |
| Uso anônimo | Perfis públicos funcionam sem login | Não informado: a tabela de sites suportados lista o método de autenticação do Instagram como "Cookies" e não diz nada sobre execuções anônimas |
| Ritmo das requisições | Controlador de taxa próprio | sleep-request "6.0-12.0" segundos por padrão |
| Atualizações incrementais | --fast-update, --latest-stamps | opção archive (desativada por padrão); skip é true por padrão |
| Metadados extras | JSON por publicação mais arquivos de texto com as legendas | metadata é false por padrão (opt-in) |
Instalação e primeira execução
Instaloader
- Com o Python instalado, execute
pip3 install instaloader. - Execute
instaloader profile [profile ...].
Ambos os passos vêm da página inicial do Instaloader.
gallery-dl
- Instale com
python -m pip install -U gallery-dl. Ele requer Python 3.8+ e Requests (também existem executáveis independentes). - Chame-o com as URLs que você quer:
gallery-dl [OPTIONS]... URLS.... - A configuração é um arquivo JSON, procurado em locais como
~/.config/gallery-dl/config.jsonou%APPDATA%\gallery-dl\config.json, conforme o README do projeto.
Login e risco para a conta
O Instaloader precisa de login? Não para perfis públicos. Hashtags, locais, :stories, :feed, :saved, e --stories/--highlights/--comments/--geotags exigem login, e você precisa seguir uma conta privada para acessar a maior parte das informações dela.
Para fazer login, passe --login SEU-USUARIO. O cookie de sessão, não sua senha, é salvo em um arquivo local (padrão ~/.config/instaloader/session-SEU-USUARIO). Como alternativa, --load-cookies NAVEGADOR importa uma sessão de um navegador como Chrome, Firefox ou Safari. Passar --password na linha de comando não é recomendado.
A documentação do Instaloader diz que usuários relataram problemas de login em várias issues. O projeto recomenda sempre manter o arquivo de sessão, porque, com um arquivo de sessão presente, --login pula o procedimento de login sujeito a falhas.
O gallery-dl precisa de login? A tabela de sites suportados lista o Instagram com o método de autenticação Cookies. O README mostra duas formas: definir extractor.instagram.cookies com o caminho de um cookies.txt, ou executar gallery-dl --cookies-from-browser firefox "URL". As fontes que encontramos não dizem se o gallery-dl consegue acessar o Instagram de forma anônima.
Qualquer um dos dois pode fazer sua conta ser banida? Os projetos não publicam taxas de banimento, então não vamos inventar uma. O que está documentado:
- O Instaloader diz ser um projeto independente e não oficial, a ser usado por sua conta e risco.
- O Instaloader 4.15 adicionou uma salvaguarda: ele interrompe o download, salvando o arquivo do iterador de retomada, se uma consulta receber feedback_required, checkpoint_required ou challenge_required.
- Um fornecedor concorrente, o instagrapi, diz que o uso logado de qualquer uma das bibliotecas pode gerar challenge_required ou feedback_required se você fizer scraping agressivo, e que o uso anônimo do Instaloader não arrisca conta alguma porque nenhuma conta fica logada. Trate isso como opinião de fornecedor. "Qualquer uma das bibliotecas", aqui, se refere ao Instaloader e ao instagrapi, não ao gallery-dl.
- Outro blog de fornecedor diz que downloaders de linha de comando como o Instaloader podem acionar a detecção de automação do Instagram, com consequências que vão de limitação a restrições de conta, embora admita que o Instaloader é uma abordagem razoável para arquivar a própria conta.
Nenhuma fonte que encontramos traz evidência específica do gallery-dl sobre banimentos. Nossa regra prática, portanto, é uma inferência, não uma constatação documentada: qualquer execução com login ou baseada em cookies vincula o comportamento da ferramenta à sua conta real, e isso inclui o login por cookies do gallery-dl.
Limites de requisições e erros 429
O Instaloader mantém o próprio controlador de taxa. Ele presume que é o único consumidor das requisições, então reiniciá-lo com frequência em um intervalo curto tende a provocar um 429. Quando uma requisição recebe um 429, ele tenta novamente depois que presume que o bloqueio temporário expirou. --max-connection-attempts tem padrão 3, e --abort-on=302,400,429 faz ele parar nessas respostas. "Too many queries in the last time" é um aviso, não um erro.
Para evitar 429s com o Instaloader:
- Execute uma instância por vez e evite reiniciá-la repetidamente.
- Mantenha o arquivo de sessão para que os logins não se repitam.
- Considere
--abort-onse preferir parar a tentar novamente.
O gallery-dl adota uma abordagem mais simples. Sua configuração padrão para o Instagram espera 6.0-12.0 segundos entre as requisições, com um sleep-429 geral de 60 segundos e 4 tentativas.
Mesmo com essa espera, um blog do WFDownloader alerta que enfileirar uma lista grande de contas do Instagram pode gerar um bloqueio.
Stories, destaques e outros conteúdos
- Instaloader: stories, destaques, comentários e geotags exigem login e uma flag explícita. --stories, --highlights, --comments e --geotags exigem login, então nenhum deles vem em uma execução anônima simples de
instaloader profile. Mídias salvas, o feed e hashtags também exigem login. A página inicial do Instaloader lista comentários, geotags e legendas de cada publicação entre o que ele consegue baixar. - gallery-dl: a entrada do Instagram lista Avatars, Collections, Followers, Followed Users, Highlights, Highlights Covers, User Profile Information, Photos, Posts, Reels, Reposts, Saved Posts, Stories, Stories Home Tray, Tag Searches, Tagged Posts, User Profiles. A configuração padrão só inclui "posts", então outros tipos precisam de configuração.
Mantendo o arquivo atualizado
Instaloader: --fast-update para na primeira imagem já baixada. --latest-stamps guarda a hora em que cada perfil foi baixado pela última vez e busca apenas mídias mais novas, então você pode mover ou apagar mídias baixadas e ainda manter o arquivo atualizado.
Para agendar como cronjob, crie uma sessão com instaloader --login=seu_usuario e depois execute instaloader --login=seu_usuario --quiet alvo. O código de saída 4 indica erro fatal de download, 3 um erro de login e 1 um erro não fatal.
gallery-dl: a opção archive é nula por padrão, então você define um arquivo de archive para pular arquivos já baixados; skip tem padrão true.
O Instaloader também exige manutenção: o histórico de releases mostra ciclos de correção ligados a mudanças do Instagram. A v4.15.1 migrou para novos endpoints GraphQL, e a v4.16 corrigiu Profile.get_posts() tanto logado quanto não logado.
Dá para restaurar a partir de algum dos backups?
Não para o Instagram. O Instaloader salva um arquivo JSON de metadados por publicação (comprimido em xz por padrão) mais as legendas, e o gallery-dl salva arquivos em um diretório base local ./gallery-dl/ por padrão. A documentação de ambos descreve download, não reenvio nem reconstrução de uma conta. Essa é nossa leitura das listas de recursos, não uma declaração de nenhum dos projetos. O que você fica com isso é uma pasta de arquivos que você mesmo precisa armazenar, fazer backup e organizar.
Quando um backup gerenciado é a escolha mais segura
Escolha uma ferramenta gerenciada quando:
- Você não quer entregar um cookie de sessão da sua conta real, que o Instaloader precisa para stories e conteúdo privado e que o gallery-dl lista como método de autenticação do Instagram.
- Você quer que ela rode todo dia sem cron job, arquivo de sessão ou quebra após uma mudança do Instagram.
- Você precisa de algo mais próximo de uma restauração do que de uma pasta de arquivos.
O SocialGuardian pede apenas seu @ - sem senha, sem login. Ele arquiva publicações, fotos, vídeos, reels, stories, legendas e metadados, além de listas de seguidores e seguidos e engajamento, com backups rodando automaticamente todos os dias e um arquivo que você pode exportar a qualquer momento, sem lock-in. Os três passos são: compartilhe seu @, deixe o app arquivar e baixe ou restaure com um clique.
Mantenha a linha de comando para experimentos e deixe um backup gerenciado proteger a conta que importa. Comece seu teste gratuito de 30 dias - sem senha