API Error Reference
Troubleshoot Scrnpix API errors with detailed explanations, reproduction steps, and fix instructions for every error code.
Find Your Error
Every error returned by the Scrnpix API is documented below with its HTTP status code, trigger conditions, and step-by-step fix instructions. Search by status code, error message, or keyword to find the solution you need.
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.
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.
clip=true requires clip_width and clip_height
How to fix the Scrnpix API error when clip=true is set but clip_width or clip_height is missing from your animate request.
clip rectangle must fit within viewport
How to fix the Scrnpix API error when the clip rectangle extends beyond the viewport dimensions in an animate request.
Invalid JSON body
How to fix the Scrnpix API error when the request body contains malformed or invalid JSON.
Unauthorized
How to fix the Scrnpix API 401 Unauthorized error when the X-KEY header is missing from your screenshot or animate request.
Unauthorized
How to fix the Scrnpix API 401 Unauthorized error when the provided API key is invalid, expired, or disabled.
Missing authorization
How to fix the Scrnpix API 401 error when the session cookie is missing from requests to dashboard endpoints.
Invalid token
How to fix the Scrnpix API 401 error when the session JWT token is expired, malformed, or has an invalid signature.
insufficient_credits
How to fix the Scrnpix API 402 error when your account has run out of credits for screenshot or animation requests.
Forbidden
How to fix the Scrnpix API 403 Forbidden error when your request Origin header is not in the allowed origins list.
Not found
How to fix the Scrnpix API 404 Not Found error when requesting an endpoint that does not exist.
API key not found
How to fix the Scrnpix API 404 error when trying to enable or disable an API key that does not exist.
rate_limit_exceeded
How to fix the Scrnpix API 429 error when you exceed your plan's rate limit for screenshot or animation requests.
Rendering error
How to fix the Scrnpix API 500 Rendering Error when the browser fails to capture a screenshot of the target page.
Animation error
How to fix the Scrnpix API 500 Animation Error when the browser fails to create a scrolling GIF animation of the target page.
Related Categories
Screenshot API for Every Language
Integrate web capture capabilities into your application using your preferred programming language. Simple REST API with examples for all major languages.
Testing Framework Integrations
Add visual regression testing to your test suite with Scrnpix. Ready-to-use integrations for Playwright, Cypress, Puppeteer, and more.
How Scrnpix Compares
See how Scrnpix stacks up against other screenshot tools and APIs with honest, feature-by-feature comparisons.
Need More Help?
Check your API key and subscription status in the dashboard, or explore our language guides for integration examples.
Go to Dashboard