Error Codes

Complete reference for all API error codes and how to resolve them.

MISSING_API_KEY
401

No API key was provided in the request.

Solution: Include your API key in the X-API-Key header, query parameter, or request body.

INVALID_API_KEY
401

The provided API key is invalid or has been revoked.

Solution: Check your API key in settings and generate a new one if needed.

RATE_LIMIT_EXCEEDED
429

You have exceeded your tier's rate limit.

Solution: Wait until the rate limit resets (check X-RateLimit-Reset header) or upgrade your plan.

QUOTA_EXCEEDED
403

You have reached your monthly screenshot quota.

Solution: Upgrade your subscription or wait until next month when quota resets.

STORAGE_LIMIT_EXCEEDED
403

Your storage quota is full.

Solution: Delete old captures or upgrade your plan for more storage.

INVALID_PARAMETER
400

One or more parameters have invalid values.

Solution: Check parameter types and allowed ranges in the documentation.

DURATION_EXCEEDED
400

The video duration exceeds your tier's maximum.

Solution: Reduce duration or upgrade to a higher tier.

FEATURE_LOCKED
403

Feature not available in your current tier.

Solution: Upgrade to PRO or ENTERPRISE for access to this feature.

CAPTURE_FAILED
500

Screenshot or video generation failed.

Solution: Retry the request. If it persists, contact support.

Error Examples

Common Errors

401 - Missing API Key

{
  "error": "API key required",
  "code": "MISSING_API_KEY"
}

429 - Rate Limit Exceeded

{
  "error": "Rate limit exceeded. You can make 20 requests per minute. Try again in 45 seconds.",
  "code": "RATE_LIMIT_EXCEEDED",
  "limit": 20,
  "remaining": 0,
  "reset": 1695123456789
}

403 - Quota Exceeded

{
  "error": "Monthly quota exceeded. Your plan allows 100 screenshots per month.",
  "code": "QUOTA_EXCEEDED",
  "limit": 100,
  "remaining": 0
}

400 - Invalid Parameter

{
  "error": "viewport_width must be between 100 and 7680",
  "code": "INVALID_PARAMETER"
}

500 - Capture Failed

{
  "error": "Capture failed",
  "code": "CAPTURE_FAILED",
  "details": "Navigation timeout exceeded"
}