Error Codes

All possible error responses and how to handle them.

400

Bad Request

The request body is invalid or missing required fields.

{ "error": { "message": "Missing required field: url", "status": 400 } }

How to fix: Ensure you're sending a JSON body with a valid 'url' field.

401

The API key is missing, invalid, or revoked.

{ "error": { "message": "Invalid or missing API key", "status": 401 } }

How to fix: Include a valid API key in the Authorization header: Bearer idx_live_xxx

429

You've exceeded your per-minute rate limit or monthly call limit.

{ "error": { "message": "Rate limit exceeded", "status": 429, "retry_after": 12 } }

How to fix: Wait for the retry_after duration, or upgrade your plan for higher limits.

500

The scraper failed to fetch or parse the target website.

{ "error": { "message": "Failed to fetch https://example.com: 403 Forbidden", "status": 500 } }

How to fix: The target site may be blocking requests. Try a different URL, or retry later.