Screenshot API error · HTTP 422

Target on a private network

target_blocked_private_range

The URL, or a page it redirects to, is on a private, reserved or internal network. The API renders public websites only, and checks every redirect and every resource of the page.

How to recognize it

The API answers with status 422 and a JSON body with the message, for example:

HTTP/1.1 422
Content-Type: application/json

{
  "message": "URLs targeting private or reserved IP ranges are not allowed."
}

Common causes

localhost, 127.0.0.1, 10.x, 192.168.x, link-local or cloud metadata addresses: URLs targeting localhost are not allowed. or URLs targeting private or reserved IP ranges are not allowed.
Internal host names such as *.local, *.internal or single-label names: URLs targeting internal host names are not allowed.
A public domain that resolves to a private address, or a page that redirects to one.

How to fix it

Render a public URL. For a site on your own machine or network, send its HTML in the html field of a POST request, or expose it with a tunnel.

Billing

Not billed: a request answered with this error does not count against your quota.

The same error in a browser

Chrome shows this failure as ERR_ACCESS_DENIED.

Every response carries an X-Request-Id header. If this page does not explain the error, write to support@screenshotbase.com with that id. All statuses: status codes.

Other API errors

forbidden403 grace_quota_exceeded429 invalid_api_key401 invalid_parameters422 key_not_allowed_for_product403 missing_api_key401 not_found404 output_too_large_for_format422 overage_quota_exceeded429 page_too_large422 quota_exceeded429 rate_limit_exceeded429 referrer_not_allowed403 render_failed500 storage_unavailable503 target_timeout408 target_unreachable502 target_unresolvable400

Screenshot API

Take screenshots from your code

screenshotbase renders any website in a real browser and returns the image: full page or viewport, any device size, retina, from 100+ countries, with cookie banners and ads hidden.

/v1/take documentation Screenshot API All documentation

300 free screenshots every month. No credit card required.

GET https://api.screenshotbase.com/v1/take?url=https://example.com&full_page=true

# Response: the image (PNG, JPG, WebP or GIF)
curl -G "https://api.screenshotbase.com/v1/take" \
  --data-urlencode "url=https://example.com" \
  -d viewport_width=1280 -d viewport_height=800 \
  -d format=png \
  -H "apikey: YOUR-API-KEY" \
  -o screenshot.png

More free tools

Website screenshot Capture any page as an image. Full page screenshot Capture a whole page, top to bottom. Mobile website screenshot See a site on iPhone, Android and iPad. URL to PDF Save any web page as a PDF. URL to markdown Turn a web page into markdown. HTML to PDF Print your own HTML as a PDF. HTML to image Render HTML and CSS as a PNG, JPG or WebP. HTML to markdown Turn HTML into clean markdown. URL to PNG Save a web page as a PNG image. URL to JPG Save a web page as a JPG image. Scrolling screenshot One long image of a page, no stitching. HTML to PNG Render HTML as a lossless PNG. HTML to JPG Render HTML as a compact JPG. Viewport sizesScreen sizes and pixel ratios of 46 devices. ErrorsChrome network errors and screenshot API errors, with fixes.