What a 429 means
A 429 response means a server has applied rate limiting because it associates too many requests with the same client. It may count requests by IP address, API key, account, cookie or endpoint.
The sender is usually the target website or API, or a CDN or firewall in front of it. If the error appears only when you use a proxy, the proxy may instead be enforcing its own connection or account quota.
HTTP/1.1 429 Too Many Requests
Retry-After: 60
Retry-After tells the client when to try again. Its value can be a number of seconds or an HTTP date, but servers aren’t required to include it. Other quota and reset headers vary by implementation.
Common causes
- Short traffic bursts. Many requests arrive within a small time window, even if the daily total is low.
- API quota exhaustion. An API key or account has reached its per-minute, daily or billing-plan allowance.
- Too much concurrency. Several workers send requests at once and exceed the endpoint’s parallel request limit.
- A shared source address. Users behind the same NAT, VPN or shared proxy contribute to one IP-based limit.
- Aggressive retry loops. Failed requests are retried immediately, creating more 429 responses.
How to fix it
- Pause new requests. Continuing at the same rate can extend the throttling period.
- Honor
Retry-After. If it’s absent, wait before testing again rather than polling continuously. - Limit rate and concurrency. Use a queue or token bucket to keep workers below the documented allowance.
- Back off with jitter. Increase the delay after each 429 and add a small random offset. Automatically retry safe requests such as GET; protect POST requests with API-supported idempotency controls.
- Reduce request volume. Cache results, remove duplicates or batch calls when the API supports it. If you need more capacity, request authorized access instead of changing identities.
Similar HTTP errors
| Code | Meaning | Next action |
|---|---|---|
| 429 Too Many Requests | Client exceeded a rate or quota | Wait and reduce traffic |
| 403 Forbidden | Server understood but refused the request | Fix the access or policy issue |
| 407 Proxy Authentication Required | Your proxy rejected the credentials | Fix the proxy username and password |
FAQ
How long does a 429 error last?
It depends on the limit. Follow Retry-After or the documented reset time. If neither is available, wait and resume at a lower rate.
Can rotating proxies fix a 429 error?
Not reliably. IP rotation changes the source IP, but it won’t fix limits tied to an API key, account, cookie or global quota. Don’t use rotation to evade a site’s stated limits.
Does a 429 mean my IP is permanently blocked?
No. It usually indicates temporary throttling rather than an IP ban. If requests still fail after the limit should have reset, inspect the new status code and response headers.