WHOIS API - Usage Guide

Replace "XXXXX" with your API key, generated through the Members Area.

JSON Format

Check your current account balance and total usage:

https://api.autowhois.com/?key=XXXXX

Fetch live WHOIS record of a domain name:

https://api.autowhois.com/?key=XXXXX&domain=example.com

Fetch cached WHOIS record of a domain name:

https://api.autowhois.com/?key=XXXXX&domain=example.com&cache

XML Format

Check your current account balance and total usage:

https://api.autowhois.com/?key=XXXXX&format=xml

Fetch live WHOIS record of a domain name:

https://api.autowhois.com/?key=XXXXX&domain=example.com&format=xml

Fetch cached WHOIS record of a domain name:

https://api.autowhois.com/?key=XXXXX&domain=example.com&format=xml&cache

API Usage Limits

When you signup with us, your account's initial limit is set to 25,000 queries per hour. This limit increases based on the package that you purchase. When you purchase our 100,000 WHOIS Lookups package ($90), your account's limit is changed to 100,000 queries per hour. When you purchase the Enterprise package (1 Billion WHOIS Lookups), your account's limit is permanently set to 250,000 queries per hour. If you exceed the allocated limit, your access to the API will be blocked for the entire hour. Your account limit is never decreased, even if you purchase a lower package at a later time. Please contact us if you wish to have a higher API usage limit.

Partial WHOIS Records

Only applicable for .COM and .NET domains.

Some domain registrars (like GoDaddy) do not provide a domain's complete WHOIS record on query. For such domain names, we are only able to provide you with the WHOIS data that we receive from the central registry (Verisign). This will contain most of the domain's registration information ("domain_registered", "create_date", "update_date", "expiry_date", "domain_registrar", "name_servers", "domain_status", "dnssec"). However, the domain's ownership details would not be available. Such results are marked ("partial_whois": true). GoDaddy is one of the most common registrar involved in partial WHOIS data. On an average, GoDaddy sends partial WHOIS in about 15-20% of the requests.

Frequently Asked Questions

Q. Where can I get an API key?

You can generate API keys through the Members Area.

Q. Which domain extensions (TLDs) are supported?

The latest list can be downloaded at https://www.autowhois.com/tlds.txt

Q. Will I get Raw WHOIS in JSON/XML?

Yes! Raw WHOIS will be included along with the parsed WHOIS data in both JSON and XML response.
In case of .com and .net domain names, Raw WHOIS from both the domain registry and registrar will be included.

Q. What are cached WHOIS records?

The most recent WHOIS of a domain stored in our server can be provided through cache, at a speed 10 times faster than live WHOIS. Similar to live WHOIS, you will be charged a single API query per domain name. The maximum age of cache would be 24 hours. We recommend using cached WHOIS for popular domain names, as their most recent WHOIS would be readily available in our cache.

Q. Am I charged for empty WHOIS or failed queries?

No! Your account balance will only be deducted for successful WHOIS lookups.
In case of cached WHOIS, you will be charged only if the domain's WHOIS record is present in our cache.