For developers
Limits and errors
Usage rules, blocked addresses and how the API reports errors.
These rules apply to the site and to the API.
Limits
- 30 requests per minute per IP. Go over that and the answer is 429, with a Retry-After header.
- Up to 20 ports per request in the port checker.
- In Fetch: up to 5 redirects, 10 seconds and 64 KB of body.
- Ping stops on its own after 30 packets.
Blocked addresses
For safety, we don't query private, local or reserved addresses, like 192.168.x.x, 10.x.x.x and 127.0.0.1.
Errors
When something goes wrong, the response has an error field with the explanation, in the language sent in the x-lang or Accept-Language header.
{ "error": "That domain doesn't look valid." }Status codes
- 400: invalid parameter.
- 403: private or reserved address.
- 404: domain not found.
- 429: request limit.
- 502 and 504: the target didn't respond.