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

On this page
HTTP 503 Service Unavailable means the server can't handle your request right now — usually because it's overloaded, under maintenance, or deliberately turning traffic away at its outer edge. Think of it as a shop with a "back in 5 minutes" sign on the door. For scrapers, a 503 most often means a CDN (the network of edge servers that sits in front of a website) or a bot-detection layer chose to drop your request instead of passing it to the real server — or that an upstream service is being rate-limited. A proper 503 includes a `Retry-After` header telling you when to try again.
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?
By definition, yes — 503 means "come back later." In practice, the bot-detection kind sticks around until you change something about how your scraper presents itself, so it isn't temporary the way the spec assumes.
What's the difference between 503 and 502?
502 Bad Gateway means a proxy passed along a broken response it got from an upstream server. 503 means the server itself is refusing to serve right now. Both are 5xx errors and both are worth retrying, but a 502 usually points to a more serious upstream problem.
Should I treat 503 as success-eventually or as failure?
Treat it as eventual success on the first 2–3 retries, then as failure after that. Most production scrapers retry 3–5 times 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?
It depends on the provider. Most credit you back for upstream 503s, charge you for transient ones, and usually charge you when the 503 was caused by bot detection. Read the provider's billing docs — this is one of the bigger sources of surprise charges.
Last updated: 2026-05-31