Errors
Errors follow the Problem Details format. Each response includes a code and a request ID for debugging.
Error Format
The API returns errors in Problem Details format:
{"type": "https://api.scraper.run/errors/rate_limited","status": 429,"code": "rate_limited","message": "Rate limit exceeded","requestId": "req_abc123","docUrl": "https://docs.scraper.run/errors/rate_limited","retryable": true}
Status Codes
| Status | Code | Description |
|---|---|---|
| 400 | bad_request | Invalid URL or parameters |
| 401 | unauthorized | Invalid or missing API key |
| 402 | no_credits | Credit balance exhausted |
| 429 | rate_limited | Rate limit exceeded |
| 500 | internal_error | Internal server error |
| 503 | browser_capacity_exceeded | Browser capacity temporarily full |
Browser-backed requests wait briefly for an available session. When the code is browser_capacity_exceeded, that wait has expired or the wait queue is full. The response is retryable, but it does not prescribe a delay because browser session completion times vary.