Ambas as ferramentas são downloaders gratuitos de linha de comando, e as duas podem baixar suas publicações do Instagram para o disco. Elas diferem na forma de fazer login, no ritmo das requisições e na quantidade de metadados que entregam. Nenhuma das duas restaura algo de volta para o Instagram.
Resposta rápida
- Instaloader é construído 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 sua 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 dos 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 para o 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 ficar cuidando 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 grátis 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 standalone, 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 obtidos 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 (desligada 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, ativação manual) |
Configuraçã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 standalone). - 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). Alternativamente, --load-cookies BROWSER importa uma sessão de um navegador como Chrome, Firefox ou Safari. Passar --password na linha de comando é desaconselhado.
A documentação do Instaloader diz que usuários relataram problemas de login em várias issues. Ela recomenda sempre manter o arquivo de sessão, porque, com um arquivo de sessão presente, --login pula o procedimento de login, que costuma falhar.
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 uma das ferramentas pode fazer minha 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 incluiu 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 do fornecedor. "Qualquer uma das bibliotecas" ali 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 de velocidade 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 um achado documentado: 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 seu próprio controlador de taxa. Ele assume que é o único consumidor de requisições, então reiniciá-lo com frequência em pouco tempo tende a causar um 429. Quando uma requisição recebe um 429, ele tenta de novo depois que presume que o bloqueio temporário expirou. --max-connection-attempts tem padrão 3, e --abort-on=302,400,429 faz com que ele pare 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 não repetir logins.
- Considere
--abort-onse preferir parar em vez de tentar de novo.
O gallery-dl adota uma abordagem mais simples. Sua configuração padrão para Instagram aguarda de 6.0 a 12.0 segundos entre requisições, com um sleep-429 geral de 60 segundos e 4 novas tentativas.
Mesmo com esse ritmo, um blog do WFDownloader alerta que enfileirar uma lista grande de contas do Instagram pode levar a 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 as 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 os 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 é um 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 versões mostra ciclos de correção ligados a mudanças do Instagram. A v4.15.1 migrou para os novos endpoints GraphQL, e a v4.16 corrigiu Profile.get_posts() tanto logado quanto não logado.
Dá para restaurar a partir de qualquer um dos backups?
Não para o Instagram. O Instaloader salva um arquivo JSON de metadados por publicação (comprimido em xz por padrão), além das legendas, e o gallery-dl salva arquivos em um diretório base local ./gallery-dl/ por padrão. A documentação deles descreve download, não reenvio nem reconstrução de uma conta. Essa é a 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 precisa armazenar, fazer backup e organizar por conta própria.
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 exige para stories e conteúdo privado e que o gallery-dl lista como seu método de autenticação do Instagram.
- Você quer que ela rode todos os dias 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 o seu @ - sem senha, sem login. Ele arquiva publicações, fotos, vídeos, reels, stories, legendas e metadados, além das listas de seguidores e seguidos e do engajamento, com backups rodando automaticamente todo dia e um arquivo que você pode exportar a qualquer momento, sem lock-in. Os três passos são: compartilhe seu @, deixe que ele arquive, e então 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 grátis de 30 dias - sem senha