Scrnpix
400/screenshot, /animate

Missing `url` query parameter

How to fix the Scrnpix API error when the required url query parameter is missing from your screenshot or animate request.

When Does This Happen?

This error occurs when you send a request to the /screenshot or /animate endpoint without including the required url query parameter. Every capture request must specify which web page to screenshot or animate.

Reproduce This Error

curl -H "X-KEY: your-api-key" \
  "https://api.scrnpix.com/screenshot"
Missing `url` query parameter

How to Fix

  1. 1Add the url query parameter to your request URL
  2. 2Make sure the URL is properly URL-encoded (e.g., https%3A%2F%2F for https://)
  3. 3Verify that the url parameter is not empty

Correct Request

curl -H "X-KEY: your-api-key" \
  "https://api.scrnpix.com/screenshot?url=https%3A%2F%2Fexample.com" \
  --output screenshot.png
200 OK — returns the screenshot as a PNG image

Related Errors

400

URL must be http(s) and not private/localhost

How to fix the Scrnpix API error when the target URL resolves to a private, localhost, or non-HTTP address.

400

Invalid JSON body

How to fix the Scrnpix API error when the request body contains malformed or invalid JSON.

Frequently Asked Questions

Do I need to URL-encode the url parameter?

Yes. The url parameter must be properly URL-encoded. For example, https://example.com should be encoded as https%3A%2F%2Fexample.com. Most HTTP client libraries handle this automatically when you pass parameters.

Can I pass the URL in the request body instead?

No. The /screenshot and /animate endpoints accept the url as a query parameter only. Include it directly in the request URL string.

Still Having Issues?

Check your API key and subscription status in the dashboard, or explore our language guides for integration examples.

Go to Dashboard