The error answer
Errors come back with a 4xx or 5xx status and JSON like {"error": {"code": "rate_limited", "message": "…"}}. Check the status and error.code in your code. The message is for people, and its wording may change.
Error codes
| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_domain | The domain isn’t valid. Send just the name, like example.com, without https:// or a path. |
| 400 | invalid_parameter | A query parameter isn’t valid, such as an unknown section or a timeout outside 5–30. |
| 401 | invalid_key | The API key is missing, wrong or revoked. |