error field:
Error Codes
| Status | Meaning | Common Cause |
|---|---|---|
400 | Bad Request | Missing or invalid url parameter, private IP address, non-HTTP scheme |
401 | Unauthorized | Missing or invalid API key |
429 | Too Many Requests | Per-minute or monthly rate limit exceeded |
502 | Bad Gateway | Target URL is unreachable, timed out, or returned an error |
500 | Internal Server Error | Something went wrong on our end |
Troubleshooting
400 — Invalid URL
400 — Invalid URL
Make sure your URL:
- Starts with
http://orhttps:// - Is a valid, publicly accessible URL
- Does not point to a private IP address (e.g.,
localhost,10.x.x.x,192.168.x.x)
401 — Invalid API key
401 — Invalid API key
- Check that your key starts with
ml_live_ - Ensure you’re passing it in the
X-API-Keyheader orapi_keyquery parameter - Verify the key is still active in your Dashboard
429 — Rate limit exceeded
429 — Rate limit exceeded
- Check the
Retry-Afterheader for per-minute limits - Check
X-Monthly-Remainingto see if you’ve hit your monthly cap - Consider upgrading your plan for higher limits
502 — Target URL unreachable
502 — Target URL unreachable
- The URL you’re fetching may be down or blocking requests
- Try increasing the
timeoutparameter (up to 15000ms) - Verify the URL is accessible from a browser