What Is the 503 Status Code? (503 Service Unavailable)

On this page
HTTP 503 Service Unavailable means the server is temporarily unable to handle the request — usually because it's overloaded, undergoing maintenance, or actively rejecting traffic at the edge. For scrapers, 503 most often appears when a CDN or bot-detection layer decides to drop a request rather than forward it to the origin, or when an upstream is being throttled. The response should include a `Retry-After` header indicating when to come back.
Quick facts
| Status code | 503 |
|---|---|
| Category | 5xx Server Error |
| Common causes (general) | Server overload, scheduled maintenance, upstream timeouts |
| Common causes (scraping) | Cloudflare "Just a moment" challenge, WAF interstitials, edge throttling |
| Right response | Honor Retry-After, exponential backoff, escalate if persistent |
Related terms
Concept map
How 503 Status Code (503 Service Unavailable Error) connects
The terms most directly tied to this one. Hover a node to see its neighbours, click to preview, drag to rearrange.
Tools & solutions for this topic
Frequently asked questions
Is a 503 always temporary?
Semantically, yes — 503 means "come back later." In practice, bot-detection-driven 503s persist until you change something about your scraper's identity, so they're not temporary in the sense the spec implies.
What's the difference between 503 and 502?
502 Bad Gateway means the proxy got a bad response from upstream. 503 means the server itself is refusing to serve right now. Both are 5xx and both are retryable, but 502s often indicate a more serious upstream problem.
Should I treat 503 as success-eventually or as failure?
As eventual success on the first 2–3 retries, as failure after that. Most production scrapers have a max-retry policy of 3–5 with backoff, then mark the URL as failed and move on. Failing fast keeps the queue moving.
Does a 503 count against my scraping API quota?
Depends on the provider. Most credit you back for upstream 503s, charge you for transient ones, and mostly charge you when the 503 was caused by bot-detection. Read the provider's billing docs — this is one of the bigger sources of bill surprises.
Last updated: 2026-05-26