Skip to main content

Error Response Format

HTTP Status Codes

Error Codes

Validation Errors (400)

Authentication Errors (401)

Quota Errors (402)

Rate Limit Errors (429)

Rate limits reset per minute. Wait 60 seconds before retrying.

Server Errors (500)

Troubleshooting

Common Issues

“Unauthorized” despite valid key
  • Ensure Bearer prefix is included
  • Check for extra whitespace
  • Verify key hasn’t expired
“Capture failed” on specific URLs
  • Some sites block headless browsers - try antiBot: true
  • Site may be down - check manually
  • Site may block certain regions - try different region
Slow captures
  • Use waitUntil: "domcontentloaded" instead of networkidle
  • Reduce viewport size
  • Check target site performance
Large file sizes
  • Use format: "webp" for better compression
  • Reduce quality for JPEG/WebP
  • Use smaller viewport

Retry Strategy

Implement exponential backoff for transient errors: