Network Error

It is an API error returned when the API cannot connect to the target host.

{
    "is_successful": false,
    "error_code": "network_error",
    "error_message": "The error happens when the API can't connect to the provided URL. It might mean that the site blocks the API or is temporarily unavailable. Generally, you can safely retry to take a screenshot.",
    "documentation_url": "https://screenshotone.com/docs/errors/network-error/"
}

Reasons and how to fix

HTTPS connection failures

A website may work over HTTP while its HTTPS connection fails. We are introducing secure_connection_failed for these failures; during rollout, they may still appear as network_error.

Check the exact HTTPS URL in your browser. If it fails there too, see how to resolve secure connection failures, including how to explicitly request the HTTP URL of a public page when appropriate. Do not automatically switch every network_error to HTTP: this code also covers other connection failures.

Proxy issues

If you use an external proxy, make sure that it has access to the target host.

Also, often when you use proxy providers, you might not notice that you don’t have sufficient credits to keep using proxy.

We noticed that for some providers, you sometimes need to recreate your proxy user/account to make it work again.

Also, many providers might block ScreenshotOne API IP addresses. In that case, consider adding our IP ranges to the proxy provider’s allow list.

Retrying with a proxy

If the request fails without a proxy and you are allowed to access the target page with automated tools, retrying once with a proxy can help when the target blocks ScreenshotOne IPs or has regional routing issues.

Do not retry indefinitely. If the proxied request also returns network_error, check the proxy balance, proxy credentials, allow lists, and whether the proxy can access the target host.

See when to retry with a proxy for a full error-by-error retry guide and a code example.

The API is under heavy load

Rarely but under heavy load, ScreenshotOne API might fail to connect to target hosts. In that case, retry requests.

Reach out to support

If nothing helps you, please, reach out to support@screenshotone.com and we will try to help you as fast as possible.