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, such as 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.

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 Credit Usage Exceeded

This apikey has no more credits 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.

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. Please upgrade to a higher plan or slow down your requests 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 we couldn’t automatically parse the URL you requested. Please retry your request by removing the autoparse parameter.

504 Gateway Timeout

CTX0002 Operation Timeout Exceeded

The request took longer than the maximum allowed time and was aborted.