APIs Documentation

How To Use Whois API

How can Whois API help you?

Do you need an API that does Whois lookups programmatically? With a Whois lookup API, you can check millions of domain names if they are registered or not. If the Whois API returns a positive result, then you can check domain expiration dates, domain registration dates, nameservers, which domain registrar holds the domain name and other information.

With this whois information, you can do analytical research around domain names.

In this article, we listed different use cases for a Whois lookup API.

But in the meantime, try our robust whois API with live whois, which we are improving every month!

Whois API

Whois API how to use

List of supported TLDs – Click here
For detailed code examples that will help you use Whois API, see our code examples page.

Let’s make an example Whois lookup API request:

http://api.whoapi.com/?domain=whoapi.com&r=whois&apikey=demokey

Output in Whois JSON format:

{
  "status": "0",
  "whois_server": "whois.PublicDomainRegistry.com",
  "status_desc": "Successfully processed",
  "limit_hit": false,
  "registered": true,
  "whois_raw": "Disabled due to GDPR",
  "disclaimer": "",
  "premium": false,
  "generic_whois": true,
  "registry_domain_id": "1640154939_DOMAIN_COM-VRSN",
  "registrar_iana_id": "303",
  "date_created": "2011-02-14 15:31:26",
  "date_expires": "2021-02-14 15:31:26",
  "date_updated": "2016-04-26 17:42:17",
  "domain_status": [ "clientTransferProhibited https:\/\/icann.org\/epp#clientTransferProhibited",
  "clientTransferProhibited https:\/\/icann.org\/epp#clientTransferProhibited" ],
  "nameservers": [ "NS1.FIRST-NS.DE",
  "ROBOTNS2.SECOND-NS.DE",
  "ROBOTNS3.SECOND-NS.COM" ],
  "emails": "Disabled due to GDPR",
  "whois_raw_parent": "Disabled due to GDPR",
  "whois_name": "PublicDomainRegistry",
  "contacts": [ {
    "type": "registrar",
    "name": "",
    "organization": "PDR Ltd. d\/b\/a PublicDomainRegistry.com",
    "phone": "+1.2013775952",
    "email": "abuse-contact@publicdomainregistry.com",
    "full_address": ""
  },
   {
    "type": "registrant",
    "name": "Disabled due to GDPR",
    "organization": "WhoAPI Inc.",
    "street": "Disabled due to GDPR",
    "city": "Disabled due to GDPR",
    "zipcode": "Disabled due to GDPR",
    "state": "California",
    "country": "US",
    "phone": "Disabled due to GDPR",
    "fax": "Disabled due to GDPR",
    "email": "Disabled due to GDPR",
    "full_address": "Disabled due to GDPR"
  },
   {
    "type": "admin",
    "name": "Disabled due to GDPR",
    "organization": "WhoAPI Inc.",
    "street": "Disabled due to GDPR",
    "city": "Disabled due to GDPR",
    "zipcode": "Disabled due to GDPR",
    "state": "California",
    "country": "US",
    "phone": "Disabled due to GDPR",
    "fax": "Disabled due to GDPR",
    "email": "Disabled due to GDPR",
    "full_address": "Disabled due to GDPR"
  },
   {
    "type": "tech",
    "name": "Disabled due to GDPR",
    "organization": "WhoAPI Inc.",
    "street": "Disabled due to GDPR",
    "city": "Disabled due to GDPR",
    "zipcode": "Disabled due to GDPR",
    "state": "California",
    "country": "US",
    "phone": "Disabled due to GDPR",
    "fax": "Disabled due to GDPR",
    "email": "Disabled due to GDPR",
    "full_address": "Disabled due to GDPR"
  } ],
   "domain_name": "whoapi.com",
   "_cached": false,
   "requests_available": 10000
}

http://api.whoapi.com/?domain=whoapi.com&r=whois&apikey=demokey&asxml

Parsed Whois in XML format:

<?xml version="1.0"?>
<response>
  <status>0</status>
  <whois_server>whois.PublicDomainRegistry.com</whois_server>
  <status_desc>Successfully processed</status_desc>
  <limit_hit/>
  <registered>1</registered>
  <whois_raw>Disabled due to GDPR</whois_raw>
  <disclaimer/>
  <premium/>
  <generic_whois>1</generic_whois>
  <registry_domain_id>1640154939_DOMAIN_COM-VRSN</registry_domain_id>
  <registrar_iana_id>303</registrar_iana_id>
  <date_created>2011-02-14 15:31:26</date_created>
  <date_expires>2021-02-14 15:31:26</date_expires>
  <date_updated>2016-04-26 17:42:17</date_updated>
  <domain_status>
    <item0>clientTransferProhibited https://icann.org/epp#clientTransferProhibited</item0>
    <item1>clientTransferProhibited https://icann.org/epp#clientTransferProhibited</item1>
  </domain_status>
  <nameservers>
    <item0>NS1.FIRST-NS.DE</item0>
    <item1>ROBOTNS2.SECOND-NS.DE</item1>
    <item2>ROBOTNS3.SECOND-NS.COM</item2>
  </nameservers>
  <emails>Disabled due to GDPR</emails>
  <whois_raw_parent>Disabled due to GDPR</whois_raw_parent>
  <whois_name>PublicDomainRegistry</whois_name>
  <contacts>
    <item0>
      <type>registrar</type>
      <name/>
      <organization>PDR Ltd. d/b/a PublicDomainRegistry.com</organization>
      <phone>+1.2013775952</phone>
      <email>abuse-contact@publicdomainregistry.com</email>
      <full_address/>
    </item0>
    <item1>
      <type>registrant</type>
      <name>Disabled due to GDPR</name>
      <organization>WhoAPI Inc.</organization>
      <street>Disabled due to GDPR</street>
      <city>Disabled due to GDPR</city>
      <zipcode>Disabled due to GDPR</zipcode>
      <state>California</state>
      <country>US</country>
      <phone>Disabled due to GDPR</phone>
      <fax>Disabled due to GDPR</fax>
      <email>Disabled due to GDPR</email>
      <full_address>Disabled due to GDPR</full_address>
    </item1>
    <item2>
      <type>admin</type>
      <name>Disabled due to GDPR</name>
      <organization>WhoAPI Inc.</organization>
      <street>Disabled due to GDPR</street>
      <city>Disabled due to GDPR</city>
      <zipcode>Disabled due to GDPR</zipcode>
      <state>California</state>
      <country>US</country>
      <phone>Disabled due to GDPR</phone>
      <fax>Disabled due to GDPR</fax>
      <email>Disabled due to GDPR</email>
      <full_address>Disabled due to GDPR</full_address>
    </item2>
    <item3>
      <type>tech</type>
      <name>Disabled due to GDPR</name>
      <organization>WhoAPI Inc.</organization>
      <street>Disabled due to GDPR</street>
      <city>Disabled due to GDPR</city>
      <zipcode>Disabled due to GDPR</zipcode>
      <state>California</state>
      <country>US</country>
      <phone>Disabled due to GDPR</phone>
      <fax>Disabled due to GDPR</fax>
      <email>Disabled due to GDPR</email>
      <full_address>Disabled due to GDPR</full_address>
    </item3>
  </contacts>
  <domain_name>whoapi.com</domain_name>
  <_cached/>
  <requests_available>10000</requests_available>
</response>