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: