Errors Reference¶
When an error occurs, Smart Proxy Manager sends a response containing an error code.
When using the Smart Proxy Manager API, the error code is returned in the X-Crawlera-Error header, with a human-readable description in the response body.
Errors can be classified into two main categories:
Bans. These are the errors produced when Smart Proxy Manager couldn’t find enough unblocked IPs, and are plotted in red in the Smart Proxy Manager usage stats.
Failures. These are all the remaining errors, some of them produced by errors on the user side and other produced by errors on Smart Proxy Manager server side. These are plotted in gray in the Smart Proxy Manager usage stats.
In both of these cases requests don’t count towards your monthly successful quota.
Note
These error codes are subject to change at any time, so they should not be relied on and only used for debugging.
Ban Errors (Not Enough Capacity)¶
X-Crawlera-Error |
Response Code |
Error Message |
How to fix or debug |
---|---|---|---|
|
503 |
No available proxies to fulfill request. |
Trying again usually works. If you keep getting this message, you may need to consider a Smart Proxy Manager Enterprise plan with dedicated capacity. |
Failure Errors (User Side)¶
X-Crawlera-Error |
Response Code |
Error Message |
How to fix or debug |
---|---|---|---|
|
400 |
Bad session ID |
Create a new session, this one probably expired. |
|
400 |
Session limit exceeded |
Create less sessions or upgrade your plan. |
|
400 |
Invalid request (typically malformed) |
The client-side technology you’re using with Smart Proxy Manager may have some incompatibilities. Contact our support team for help. |
|
401 |
Malformed URL |
Check the URL you’re passing to Smart Proxy Manager. Contact our support team if you need help. |
|
401 |
User account suspended |
Extend the overage limit in your account through the Billing section |
|
407 |
Incorrect authentication data |
Make sure you’re using the right Smart Proxy Manager credentials. |
|
429 |
The number of parallel connections has exceeded the concurrency limit. |
Reduce concurrency or upgrade your Smart Proxy Manager plan |
|
470 |
Unauthorized header |
You’re using a Smart Proxy Manager header (or header value) that is not allowed in your current plan. Consider upgrading to a higher plan or contact our support team for alternatives. |
|
499 |
Connection closed early by client |
Check the timeout used when connecting to Smart Proxy Manager from your code. It may need to be increased. |
Failure Errors (Server Side)¶
X-Crawlera-Error |
Response Code |
Error Message |
How to fix or debug |
---|---|---|---|
|
502 |
Domain not found |
Check the domain of the URL you’re trying to fetch, it may be wrong. |
|
502 |
Host is unreachable |
The domain you’re trying to access may be down. Contact our support team if this is not the case. |
|
502 |
Targey website is refusing connection |
Check the website works in your browser, and contact support it if does. |
|
502 |
Connection with website lost |
Trying again usually works. unless the target website is having some issues. If the issue persists, contact our support team. |
|
502 |
Target website closed the connection |
Trying again usually works, unless the target website is having some issues. If the issue persists, contact our support team. |
|
502 |
Failed to initialize SSL tunnel. This contemplates both client SSL errors trying to connect to Smart Proxy Manager and Smart Proxy connect to target websites. |
Make sure you have the Smart Proxy Manager CA file installed in your trusted certificates. Contact support if you still have issues. Manager trying to |
|
503 |
Server busy: too many outstanding requests |
Try again after some minutes |
|
504 |
Timeout trying to establishe the TCP connection with the target domain |
Check if the URL you’re trying to access actually works, contact support if it does. |
|
504 |
Timeout receiving data from the domain, after the TCP connection is established. |
Check if the URL works well in your browser, and contact our support team if it does. |
|
523 |
The domain you are trying to access is restricted in Smart Proxy Manager |
Contact support to check if the restriction can be lifted |
|
540 |
Invalid Smart Proxy Manager header value |
Check the value you passed in the |
|
541 |
Response size is too big. The maximum response size in Smart Proxy Manager is 500 Mb. |
Fetch a URL that is smaller in size. |
|
542 |
You’re accessing the wrong API endpoint for Smart Proxy Manager. |
If you’re on an Enterprise plan, make sure you’re using your Enteprise hostname (eg. |