guides

Error Codes

Reference table of all Scrappey error codes with causes and remediation steps.

Updated May 29, 2026

Reference table of all Scrappey error codes, their error messages, and what to do when you encounter them.

Example

When a request fails, the response has "data": "error" and an error field containing the message. Handle the stable CODE-XXXX identifier in your code — it is the canonical key. The public error messages below are normalized categories; the raw, provider-specific diagnostics (including which verification provider was involved) are available in the debug view of your Scrappey dashboard. Many errors are transient — an automatic retry or a different proxy often resolves them.

json7 lines

Error Code Reference

Code	Error Message	Description
`CODE-0001`	Server is overloaded	All server capacity is used, please try again.
`CODE-0002`	Browser verification failed	Browser verification could not be completed, preventing access.
`CODE-0003`	Too many verification attempts, try again	Too many attempts from your IP; try again later.
`CODE-0004`	Invalid cmd command	The provided command is invalid.
`CODE-0005`	Tunnel connection failed	Tunnel connection could not be established.
`CODE-0006`	ERR_HTTP_RESPONSE_CODE_FAILURE	Failure in HTTP response.
`CODE-0007`	Could not complete interactive verification	Clicking the verification widget failed.
`CODE-0007`	Proxy error - ERR_TUNNEL_CONNECTION_FAILED or ERR_EMPTY_RESPONSE	Proxy error. Review proxy configuration for the target site.
`CODE-0008`	Target site rejected request	The target site rejected the request.
`CODE-0009`	Error from ChatGPT, try again	ChatGPT API returned an error.
`CODE-0010`	Proxy rejected by verification provider	Proxy rejected by the verification provider. Review proxy configuration and authorization for the target site.
`CODE-0011`	Verification provider rejected session	A verification step could not be completed.
`CODE-0012`	Could not parse verification cookie	Issue parsing a verification cookie.
`CODE-0013`	Verification cookie processing error	A verification cookie could not be processed.
`CODE-0014`	Could not load verification provider	The verification provider could not be loaded.
`CODE-0015`	Socks4 With Authentication not Supported	Socks4 with authentication is not supported.
`CODE-0016`	Socks5 With Authentication not Supported	Socks5 with authentication is not supported.
`CODE-0017`	Browser verification temporarily unavailable, try again later	Temporary incompatibility with an updated verification release.
`CODE-0018`	Too high error rate for this URL	Temporary ban due to high error rate. Contact support.
`CODE-0019`	The proxy server is refusing connections	Check proxy settings. Proxy is refusing connections.
`CODE-0020`	Could not find intercept request	System could not find the intercept request.
`CODE-0021`	Unknown error occurred with request	An unknown request error occurred.
`CODE-0022`	Captcha type solve_captcha is not found	The specified captcha type was not found.
`CODE-0023`	Interactive verification handler not found	The interactive verification handler was not found.
`CODE-0024`	Proxy timeout - proxy too slow	Proxy took too long to respond.
`CODE-0025`	NS_ERROR_NET_TIMEOUT - proxy too slow	Browser-level timeout due to slow proxy.
`CODE-0026`	Internal browser error	Internal browser failure.
`CODE-0027`	No elements found for this CSS selector	The specified CSS selector did not match any elements.
`CODE-0028`	Verification provider rejected session	A verification step could not be completed.
`CODE-0029`	Too many sessions open	Maximum sessions exceeded. Sessions auto-expire after 240 seconds.
`CODE-0030`	Browser name must be: firefox, chrome or safari	Only these browsers are supported.
`CODE-0031`	Request error, please try again	General request error. Retry.
`CODE-0032`	Interactive verification could not be completed	An interactive verification step could not be completed. Review proxy configuration and authorization for the target site.
`CODE-0033`	Managed verification could not be completed	A managed verification step could not be completed.
`CODE-0034`	Verification could not be completed after multiple attempts	Review proxy configuration and authorization for the target site.
`CODE-0035`	Could not load verification widget	The verification widget failed to load.
`CODE-0036`	Keyboard action value not found	The specified keyboard action is invalid.
`CODE-0037`	Verification provider rejected session	The verification provider rejected the request. Review proxy configuration and authorization for the target site.
`CODE-10000`	Unknown error - has to be specified	An unspecified error occurred. Needs review.

Go deeper in the Scrappey knowledge base:

403 Forbidden — the classic "blocked by anti-bot" code
429 Too Many Requests — rate-limit responses
503 Service Unavailable — overload / challenge responses

Error Codes

Example

Error Code Reference

Related concepts