docs
Errors

Errors

There are 2 levels of errors: job level and job item level.

Job level error codes:

Job item level error codes:

Job Level Errors

Job level errors means that the job failed to run. It could be for example that there is not enough balance or internal error from the service.

Insufficient Balance

This error occurs when the balance is not enough to run the job. Go to the dashboard (opens in a new tab) to top up your balance.

API error response example:

{
  "error_code": "insufficient_balance",
  "error_message": "Your balance is not enough to run this job"
}

Invalid request

This error occurs when the request is invalid. For example, the URL is invalid or the parameters are invalid.

API error response example:

{
  "error_code": "invalid_request",
  "error_message": "whitelist_regexp is invalid"
}

Internal error

This error means that something went wrong on our side. Please contact us on [email protected] if you encounter this error.

API error response example:

{
  "error_code": "internal_error",
  "error_message": "Internal server error"
}

Job Item Level Errors

Job item level error means that the job item failed with the specific error.

Job item level errors are returned in the job_items array. List of error codes:

Host returned error

Most common error. This error means that the response HTTP status code is not in range 200-299. Exception is 403 status code, that has a diffrenen error code website_access_denied.

API error response example:

{
    "id": "60b7c4a5-aca7-4183-87db-017418218641",
    //...
	"status": "done",
	"job_items": [
		{
			//...
			"error_code": "host_returned_error",
			"status": "error",
			"last_error": "Webpage returned error status code: 404"
		}
	]
}

Website access denied

This is a special case of the host_returned_error error. It means that the website returned a 403 status code.

API error response example:

{
    //...
	"status": "done",
	"job_items": [
		{
			//...
			"error_code": "website_access_denied",
			"status": "error",
			"last_error": "Webpage returned access denied status code: 403"
		}
	]
}
 
 
 
### Name resolution error
 
This error means that there was a problem with the website host name resolution. Most likelt the website does not exist or there is a typo in the URL.
 
API error response example:
```json
{
    //...
	"job_items": [
		{
			//...
			"error_code": "name_not_resolved",
			"status": "error",
			"last_error": "Connection refused"
		}
	]
}

Internal error

This error means that something went wrong on our side. Please contact us on [email protected] if you encounter this error.

API error response example:

{
    //...
	"job_items": [
		{
			//...
			"error_code": "internal_error",
			"status": "error",
			"last_error": "Internal server error"
		}
	]
}
Async requests and WebhooksRate Limits