WhoAPI is a RESTful based API. Communication is made through a normal HTTP requests.
Requests are made as strings using HTTP GET method. All outputs are provided as a JSON formatted response.
Authentication is needed in order to use the API, and for this a WhoAPI account is required. You'll need your API key every time you make a request. You have the option to limit API requests by a certain IP addresses in your account settings.
You can find your unique API key inside the "My account" section on the left once you register.
Example: In the professional package you can either make 8 whois queries per minute OR 50 queries on any other API. We don't measure the number of queries you make in a month.
|2 / min||8 / min||30 / min|
|Whois requests / month||86,400||345,600||1,296,000|
|Register without a credit card|
|Money back guarantee|
|$49 / Month
$499 / Year
|$199 / Month
$1999 / Year
|$499 / Month
$4999 / Year
|Order now||Order now||Order now|
Result is stored in the "taken" value which is in this case "1", same as "Domain not available for registration".
Each function has a set of its own resulting variables.
|1||Invalid characters in domain name.|
|2||Use of double dot in domain name.|
|3||Domain name starting or ending with dash or dot.|
|4||TLD does not exist.|
|5||Too many characters in domain name (without TLD), maximum length is 64.|
|6||Too many characters in TLD.|
|7||Whois server not yet supported. We are adding new servers on a weekly basis.|
|8||Missing request type in 'r' parameter.|
|9||Invalid request type in 'r' parameter.|
|10||API key invalid.|
|11||Invalid characters in 'port' parameter.|
|12||Invalid API account.|
|15||IP not whitelisted in Account settings.|
|16||Too many tries, your IP has been blocked for a minute.|
|17||Query limit exceeded.|
|18||Query high usage limit exceeded.|
|19||Missing domain name in 'domain' parameter.|
|20||Invalid IP address in 'ip' parameter.|
|21||Invalid 'fullurl' parameter, must be fully qualified URI.|
|22||Invalid node data, only numeric characters allowed.|
|23||Missing 'port' parameter.|
|24||Missing valid TLD in domain name.|
|25||Unknown output type.|
|26||Timeout getting the result from a node.|
|27||Fatal error detected in result from a node.|
|28||Unknown error detected in result from a node.|
|29||Cannot resolve domain name, IP needed.|
|30||Problem with the WHOIS server, please try again later.|
|31||WHOIS limit reached for used WhoAPI node. Please make a new request.|
|32||Cannot resolve domain availability by using the requested method.|