429 Too Many Requests (RFC 6585) significa que o usuário enviou requisições demais em um determinado período. A resposta deve explicar a situação e pode incluir um cabeçalho Retry-After com o número de segundos, ou uma data, após o qual o cliente pode tentar de novo. Os caches não podem armazenar respostas 429.
Os limites de requisições podem valer por endereço IP, usuário, chave de API ou endpoint. Muitas APIs também enviam cabeçalhos como X-RateLimit-Limit e X-RateLimit-Remaining, ou os campos de cabeçalho RateLimit que o IETF está padronizando, para mostrar a cota restante.
Clientes bem-comportados esperam o tempo indicado em Retry-After ou aplicam um backoff exponencial, em vez de tentar de novo imediatamente. A própria API do TrueURL também responde com 429 e Retry-After se você fizer um número muito grande de verificações em pouco tempo.
Exemplo de resposta
HTTP/1.1 429 Too Many Requests
Date: Fri, 06 Nov 2026 10:15:32 GMT
Retry-After: 120
Content-Type: application/json
Content-Length: 81
{"error":"rate_limited","message":"Too many requests. Try again in 120 seconds."}SEO e verificação de redirecionamentos
O Google trata o 429 como um sinal de que o servidor está sobrecarregado, de forma parecida com um erro 5xx. O Googlebot reduz o ritmo de rastreamento, e URLs que continuam retornando 429 podem acabar sendo removidas do índice. Retornar 429 ou 503 por pouco tempo é a forma recomendada de reduzir o rastreamento em uma emergência; retorná-lo por mais de um ou dois dias, não.
Garanta que os limites de requisições e a proteção contra bots não atinjam rastreadores legítimos durante a operação normal. Uma verificação de redirecionamentos que retorna 429 significa que o destino está limitando as requisições do verificador; espere um pouco antes de verificar de novo.
Causas comuns e casos de uso
- Um cliente de API excedeu a cota ou o limite de pico.
- Um formulário de login bloqueia tentativas repetidas vindas do mesmo endereço IP.
- Uma regra de limite de requisições de uma CDN ou WAF é acionada por um rastreador, uma ferramenta de monitoramento ou um verificador em massa.
- Muitos usuários compartilham um único endereço IP (rede corporativa, operadora de celular) e atingem juntos um limite por IP.