APIs Documentation
How To Use Whois API
Whois API use case
Are you looking for the owner of a certain domain name? Is someone infringing on your trademark? Are you hunting down recently registered “fake” domains? Are you looking for common patterns between phishing websites? Are you looking for 100% accurate domain availability checks?
Are you doing analytical research around domain names?
We could go on and on with different use cases, but hopefully, we found one that you can relate to. If we haven’t, we would love to hear from you!
But in the meantime, try our robust whois API, which we are improving every month!
Whois API
List of supported TLDs – Click here
For detailed code examples on how to use whois API, see our code examples page.
Let’s make an example request:
http://api.whoapi.com/?domain=whoapi.com&r=whois&apikey=demokey
Output in 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
Output 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>