API Error Codes
Understanding the ZenRows® Scraper API error codes is crucial for troubleshooting and optimizing your interactions with ZenRows. Below are common errors you may encounter, along with explanations and recommended actions.
Each error code corresponds to specific conditions encountered during the Scraper API usage, from authentication problems to request handling and server responses.
400 Bad Request
REQS001 Requests To This Domain Are Forbidden
Requests to this URL are forbidden. See our target sites’ access restrictions and user behavior guidelines for more information.
REQS002 Request Requirements Unsatisfied
The requested URL domain needs JavaScript rendering and/or Premium Proxies due to it’s high-level security defenses. Please check the error’s body for more details or retry by adding js_render and premium_proxy parameters to your request.
REQS004 Invalid Params Provided
Some parameters or even the URL are invalid or not properly encoded. Please check the error’s body for more details.
RESP004 CSS Extractor Parameter Is Not Valid
The css_extractor parameter sent in your request is not valid. Please retry your request with a valid css_extractor formatted parameter.
REQS006 Invalid CAPTCHA Solver Key
The configured CAPTCHA solver integration API key is invalid. Check that the API key configured in your account integrations page is valid and has enough funds.
RESP008 Non-Retryable Error not related to ZenRows
The target returned an error on the site’s config or certificate, not an error ZenRows can solve or bypass. These are non-retryable (for example, ERR_CERT_DATE_INVALID). Some targets are only accessible from certain geolocations, please review the configuration used.
The target can’t be processed and this request will get charged.
401 Unauthorized
AUTH001 API Key Missing
No apikey information was sent in your request. Please retry by adding the apikey parameter along with your request.
AUTH002 Invalid API Key
The apikey sent does not match the expected format. The apikey must match the following regular expression: /^[0-9][a-f]{40}$/.
AUTH003 API Key Not Found
The apikey sent in your request is not valid. Please retry by adding a valid apikey along with your request.
402 Payment Required
AUTH004 Usage Exceeded
This apikey has no more usage remaining. Please upgrade to a higher plan to continue using the service.
AUTH005 API Key Is No Longer Valid
This apikey has reached its validity period. Please upgrade to a higher plan to continue using the service.
AUTH010 Feature Is Not Included In Plan
The requested feature is not included in your subscription plan. Please upgrade to a higher plan to use this feature.
AUTH011 No Subscription Found
This account does not have an active subscription. Purchase a subscription to use the service, or contact support.
AUTH012 Subscription Does Not Allow To Use The Product
This account subscription does not allow to use this service. Purchase a subscription including the service, or contact support.
403 Forbidden
AUTH009 User Is Not Verified
This apikey belongs to a user that has not verified the email account. Please, check your email and confirm your account before using the service.
BLK0001 IP Address Blocked
Your IP address has been blocked for exceeding the maximum error rate allowed. Please try again in a few minutes, or contact support if you need further guidance.
404 Not Found
RESP002 Page Not Found
The requested URL page returned a 404 HTTP Status Code. Please make sure this URL exists and retry your request. Note that these requests are billed.
RESP007 Site Not Found
The requested target domain could not be resolved, or there is no DNS record associated with it. Please make sure this site exists and retry your request. Note that these requests are billed.
405 Method Not Allowed
REQS005 Method Not Allowed
The HTTP verb used to access this page is not allowed. Only GET, POST, or PUT requests are allowed.
407 Proxy Authentication Required
AUTH007 Invalid Proxy-Authorization Header
The Proxy-Authorization header sent does not match the expected format. The Proxy-Authorization header must be a base64 <apikey>:<params> string.
413 Content Too Large
RESP005 Response Size Exceeded The Limit
The response data size is bigger than the maximum allowed download size. Please desist from requesting heavy-response size endpoints or contact support if you need further assistance.
422 Unprocessable Entity
RESP001 Could Not Get Content
The service couldn’t get the content. There are several possible reasons for this error. Please check the error’s body for more details.
424 Failed Dependency
RESP006 Failed To Solve CAPTCHA
The CAPTCHA solver provider was unable to solve the CAPTCHA detected in the page. Please, check that the CAPTCHA solver you’ve integrated with is properly configured, and try again.
429 Too Many Requests
AUTH006 Concurrency Exceeded
The concurrency limit was reached. Upgrade to a higher plan or adjust your request rate to continue using the service. Learn more about what is and how ZenRows concurrency works.
AUTH008 Rate Limit Exceeded
The rate limit was reached. Please upgrade to a higher plan or slow down your requests to continue using the service.
500 Internal Server Error
CTX0001 Context Cancelled
The request was canceled from the client’s side.
ERR0001 Unknown Error
An internal error occurred. Please contact support if this problem persists.
ERR0000 Unknown Error
An unexpected internal error occurred. Please contact support if this problem persists.
502 Bad Gateway
RESP003 Could Not Parse Content
The request failed because the URL could not be automatically parsed. Retry your request without the autoparse parameter.
504 Gateway Timeout
CTX0002 Operation Timeout Exceeded
The request exceeded the maximum allowed time and was aborted.
Was this page helpful?