Errors
Errors use standard HTTP status codes and always return the same JSON shape, so you can handle them in one place.
Error format
error
- { "error": "Missing or invalid API key." }
Status codes
| Status | Meaning |
|---|---|
200 | Success. |
400 | Bad request — a required parameter (e.g. url) is missing or malformed. |
401 | Missing or invalid API key. |
403 | URL blocked — a private/internal address (SSRF protection). |
404 | Unknown endpoint. |
429 | Rate limit reached — see Rate limits. |
502 | The target URL couldn't be fetched (unreachable or upstream error). |
503 | API temporarily unavailable. |
Handling errors
Check the status code first, then read error for a human-readable message. 4xx errors are client-side (fix the request or key); 5xx and 429 are safe to retry with backoff.