Screenshot API error · HTTP 401

Missing API key

missing_api_key

The request carried no API key. Every call to /v1/take needs one, in the apikey header or the apikey query parameter.

How to recognize it

The API answers with status 401 and a JSON body with the message and the error.code missing_api_key, for example:

HTTP/1.1 401
Content-Type: application/json

{
  "error": {
    "code": "missing_api_key",
    "message": "No API key found in request"
  },
  "message": "No API key found in request"
}

Common causes

The apikey header or query parameter is missing, or misspelled (api_key, apiKey).
An HTTP client or proxy that drops custom headers, or a redirect that loses them.
An environment variable with the key that is empty in this environment.

How to fix it

Send the key as the apikey header: curl -H "apikey: YOUR-API-KEY" ..., or append &apikey=YOUR-API-KEY to the URL.
Get a free key at app.screenshotbase.com: 300 screenshots a month, no credit card.
The body’s actions.sign_up link leads to the sign-up.

Billing

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

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 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_blocked_private_range422 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.