O que é um erro 429 Too Many Requests?

Quando você vê um código de status 429, isso geralmente é causado por limitação de taxa—um mecanismo utilizado pelos servidores para proteger recursos e manter a estabilidade. Os sites ou APIs definem limites específicos (por exemplo, 100 solicitações por minuto) e, caso o seu tráfego ultrapasse esse limite, o servidor bloqueia novas solicitações até que o limite seja reiniciado.

Em fluxos de trabalho de scraping ou baseados em proxy, esse erro costuma ocorrer quando:

• Várias solicitações provenientes do mesmo endereço IP estão sendo enviadas com muita rapidez.
• Cabeçalhos ou cookies idênticos fazem com que seu tráfego pareça automatizado.
• O site alvo detecta padrões que se assemelham à atividade de bots (atualização automática, intervalos não humanos, ausência de user agents, etc.).
  

Do ponto de vista da rede, isso não significa que o site esteja fora do ar — significa que Seu acesso está temporariamente restrito. Os sites podem emitir um Retry-After cabeçalho que indica quando você pode enviar a próxima solicitação com segurança. Ignorá-lo muitas vezes prolonga o bloqueio ou leva a restrições de IP e captchas.

Como corrigir o erro 429 “Too Many Requests”

1. Reduza a velocidade e respeite os limites de velocidade

Insira pequenos intervalos entre as solicitações ou utilize intervalos aleatórios para simular a navegação natural de um usuário. Mesmo algumas centenas de milissegundos podem fazer a diferença para permanecer abaixo do limite do site.

2. Utilize a rotação de proxies

Alterne entre diferentes endereços IP usando um residencial rotativoou Grupo de proxies ISP. Isso distribui as solicitações por vários nós de saída, evitando que qualquer endereço IP específico seja submetido a limitação de taxa. Evite o uso excessivo da mesma sub-rede ou ASN — uma lógica de rotação inteligente ajuda a manter os sinais de confiança.

3. Randomizar cabeçalhos e o comportamento do usuário

Utilize valores realistas cabeçalhos do navegador, variem os agentes de usuário e evitem padrões repetitivos. Os sites dependem cada vez mais de coleta de impressões digitais para detectar a automação — pequenos ajustes (por exemplo, diversidade de referenciadores, variação no tamanho da janela de visualização) podem ajudá-lo a passar despercebido.

4. Verifique se há o cabeçalho “Retry-After”

Quando a resposta 429 inclui um Retry-After campo, ele especifica quantos segundos devem ser aguardados antes de uma nova tentativa. Respeite sempre esse cabeçalho em seu código.

Exemplo:

‍

5. Evite ferramentas de atualização automática agressivas

Extensões ou scripts que recarregam páginas dezenas ou centenas de vezes por dia podem provocar restrições permanentes de IP. Caso necessite de atualizações contínuas, utilize uma API oficial ou distribua os intervalos de forma inteligente por meio do balanceamento de proxies.

Extracção de dados da Web em grande escala

Um sistema de coleta de dados pode enviar milhares de solicitações diariamente a um site de varejo. Sem rotação de proxies ou, em caso de limitação de largura de banda, começam a aparecer erros 429 — interrompendo o fluxo de dados até que o sistema imponha intervalos aleatórios.

Consumo da API

Um desenvolvedor que está integrando um produto de terceiros API ultrapassa sua cota de solicitações ao executar um script de teste com muita frequência. A API responde com o código 429, obrigando o script a respeitar os limites definidos antes de retomar a execução.

Monitoramento automatizado

Ferramentas de monitoramento de sites ou bots de disponibilidade às vezes geram erros 429 quando enviam pings com muita frequência a partir de um único local. O uso de proxies distribuídos pode ajudar a evitar alertas falsos de indisponibilidade.

Utilize o Controle Adaptativo de Velocidade

Implemente uma lógica que reduza automaticamente a velocidade quando os tempos de resposta aumentarem ou quando surgirem erros 429. A limitação adaptativa melhora a confiabilidade e minimiza os bloqueios.

Distribuir o tráfego de forma inteligente

Utilize proxies residenciais ou de ISP em vários locais geográficos e sub-redes. Isso não apenas reduz a chance de atingir limites, mas também faz com que o tráfego pareça mais natural.

Armazene as respostas em cache sempre que possível

Em vez de solicitar o mesmo recurso repetidamente, armazene os dados localmente e atualize-os periodicamente. Isso reduz a carga no site de destino e mantém a eficiência do seu fluxo de trabalho.

Monitorar e registrar respostas

Acompanhe a frequência e o momento em que ocorrem os erros 429. O reconhecimento de padrões ajuda a ajustar os atrasos nas tentativas de repetição, o ritmo das solicitações e a frequência de rotação dos proxies.

Um erro 429 “Too Many Requests” indica que você está enviando dados em um ritmo muito rápido para que o servidor consiga processá-los. Não se trata de uma falha, mas sim de um feedback. Ao regular o ritmo de suas solicitações, alternar entre proxies e respeitar os cabeçalhos de limite de taxa, você pode manter pipelines de scraping ou automação estáveis e éticos.

‍