API Usage Guide
Replace the key "XXXXX" with your own API key, generated through the Members Area.
API Status Check
Check our API status through the following link:
{
"success": true,
"server_load": "0.12 0.14 0.10",
"current_time": "Sun, 09 Jul 2023 14:02:12 +0000",
"api_status": "BigDomainData API is online and functioning properly.",
"usage_guide": "For API usage guide, please see https://www.bigdomaindata.com/guide.php"
}Account Balance
Check your current account balance and total usage.
Cost for Single Query = (0 API Credits)
{
"success": true,
"account_username": "[email protected]",
"current_balance": 325,
"total_usage": 175,
"api_hourly_limit": 25000,
"api_hourly_usage": 10
}XML Format
By default, all results are sent in JSON format. To get results in XML format, simply add "&format=xml" to your query.
Cost for Single Query = (Same as with JSON Format)
<root>
<success>true</success>
<account_username>[email protected]</account_username>
<current_balance>325</current_balance>
<total_usage>175</total_usage>
<api_hourly_limit>25000</api_hourly_limit>
<api_hourly_usage>10</api_hourly_usage>
</root>Current WHOIS Record
Get the most recent WHOIS record of a domain name.
Cost for Single Query = (1 API Credit per Domain Name)
{
"success": true,
"query": {
"current_whois": "yahoo.com"
},
"count": {
"total": 1,
"relation": "eq",
"current": 1
},
"results": [
{
"domain_name": "yahoo.com",
"domain_keyword": "yahoo",
"domain_tld": "com",
"query_time": "2023-06-05 12:31:35",
"create_date": "1995-01-18",
"update_date": "2023-02-03",
"expiry_date": "2024-01-19",
"registrar_iana": 292,
"registrar_name": "MarkMonitor, Inc.",
"registrar_website": "http://www.markmonitor.com",
"registrant_company": "Yahoo Assets LLC",
"registrant_state": "VA",
"registrant_country": "US",
"registrant_email": "select request email form at https://domains.markmonitor.com/whois/yahoo.com",
"name_servers": [
"ns1.yahoo.com",
"ns2.yahoo.com",
"ns3.yahoo.com",
"ns4.yahoo.com",
"ns5.yahoo.com"
],
"domain_status": [
"clientDeleteProhibited",
"clientTransferProhibited",
"clientUpdateProhibited",
"serverDeleteProhibited",
"serverTransferProhibited",
"serverUpdateProhibited"
],
"dns_sec": [
"unsigned"
]
}
],
"stats": {
"total_time": 0.032,
"api_credits_used": 1,
"cost_calculation": "current_whois [1 domain]"
}
}Bulk WHOIS Lookup
Get the current WHOIS record of multiple domain names (max 10,000).
Cost for Single Query = (1 API Credit * Total Number of Domain Names)
{
"success": true,
"query": {
"bulk_whois": "yahoo.com, google.com, facebook.com, twitter.com, amazon.com",
"sort_by": "query_time",
"sort_order": "asc"
},
"count": {
"total": 5,
"relation": "eq",
"current": 5
},
"unique_domains": "amazon.com, twitter.com, google.com, facebook.com, yahoo.com",
"results": [
{
"num": 1,
"domain_name": "amazon.com",
"domain_keyword": "amazon",
"domain_tld": "com",
"query_time": "2023-06-05 06:23:35",
"create_date": "1994-11-01",
"update_date": "2023-05-16",
"expiry_date": "2024-10-30",
"registrar_iana": 292,
"registrar_name": "MarkMonitor, Inc.",
"registrar_website": "http://www.markmonitor.com",
"registrant_name": "Hostmaster, Amazon Legal Dept.",
"registrant_company": "Amazon Technologies, Inc.",
"registrant_address": "P.O. Box 8102",
"registrant_city": "Reno",
"registrant_state": "NV",
"registrant_zip": "89507",
"registrant_country": "US",
"registrant_email": "[email protected]",
"registrant_phone": "+1.2062664064",
"registrant_fax": "+1.2062667010",
"name_servers": [
"ns1.amzndns.co.uk",
"ns1.amzndns.com",
"ns1.amzndns.net",
"ns1.amzndns.org",
"ns2.amzndns.co.uk",
"ns2.amzndns.com",
"ns2.amzndns.net",
"ns2.amzndns.org"
],
"domain_status": [
"clientDeleteProhibited",
"clientTransferProhibited",
"clientUpdateProhibited",
"serverDeleteProhibited",
"serverTransferProhibited",
"serverUpdateProhibited"
],
"dns_sec": [
"unsigned"
]
},
{
"num": 2,
"domain_name": "twitter.com",
"domain_keyword": "twitter",
"domain_tld": "com",
"query_time": "2023-06-05 07:05:36",
"create_date": "2000-01-21",
"update_date": "2023-03-07",
"expiry_date": "2024-01-21",
"registrar_iana": 299,
"registrar_name": "CSC CORPORATE DOMAINS, INC.",
"registrar_website": "www.cscprotectsbrands.com",
"registrant_name": "Twitter, Inc.",
"registrant_company": "Twitter, Inc.",
"registrant_address": "1355 Market Street",
"registrant_city": "San Francisco",
"registrant_state": "CA",
"registrant_zip": "94103",
"registrant_country": "US",
"registrant_email": "[email protected]",
"registrant_phone": "+1.4152229670",
"registrant_fax": "+1.4152220922",
"name_servers": [
"a.r06.twtrdns.net",
"a.u06.twtrdns.net",
"b.r06.twtrdns.net",
"b.u06.twtrdns.net",
"c.r06.twtrdns.net",
"c.u06.twtrdns.net",
"d.r06.twtrdns.net",
"d.u06.twtrdns.net"
],
"domain_status": [
"clientTransferProhibited",
"serverDeleteProhibited",
"serverTransferProhibited"
],
"dns_sec": [
"unsigned"
]
},
{
"num": 3,
"domain_name": "google.com",
"domain_keyword": "google",
"domain_tld": "com",
"query_time": "2023-06-05 09:35:59",
"create_date": "1997-09-15",
"update_date": "2019-09-09",
"expiry_date": "2028-09-13",
"registrar_iana": 292,
"registrar_name": "MarkMonitor, Inc.",
"registrar_website": "http://www.markmonitor.com",
"registrant_company": "Google LLC",
"registrant_state": "CA",
"registrant_country": "US",
"registrant_email": "select request email form at https://domains.markmonitor.com/whois/google.com",
"name_servers": [
"ns1.google.com",
"ns2.google.com",
"ns3.google.com",
"ns4.google.com"
],
"domain_status": [
"clientDeleteProhibited",
"clientTransferProhibited",
"clientUpdateProhibited",
"serverDeleteProhibited",
"serverTransferProhibited",
"serverUpdateProhibited"
],
"dns_sec": [
"unsigned"
]
},
{
"num": 4,
"domain_name": "facebook.com",
"domain_keyword": "facebook",
"domain_tld": "com",
"query_time": "2023-06-05 12:12:18",
"create_date": "1997-03-29",
"update_date": "2023-04-26",
"expiry_date": "2032-03-30",
"registrar_iana": 3237,
"registrar_name": "RegistrarSafe, LLC",
"registrar_website": "https://www.registrarsafe.com",
"registrant_name": "Domain Admin",
"registrant_company": "Meta Platforms, Inc.",
"registrant_address": "1601 Willow Rd",
"registrant_city": "Menlo Park",
"registrant_state": "CA",
"registrant_zip": "94025",
"registrant_country": "US",
"registrant_email": "[email protected]",
"registrant_phone": "+1.6505434800",
"name_servers": [
"a.ns.facebook.com",
"b.ns.facebook.com",
"c.ns.facebook.com",
"d.ns.facebook.com"
],
"domain_status": [
"clientDeleteProhibited",
"clientTransferProhibited",
"clientUpdateProhibited",
"serverDeleteProhibited",
"serverTransferProhibited",
"serverUpdateProhibited"
],
"dns_sec": [
"unsigned"
]
},
{
"num": 5,
"domain_name": "yahoo.com",
"domain_keyword": "yahoo",
"domain_tld": "com",
"query_time": "2023-06-05 12:31:35",
"create_date": "1995-01-18",
"update_date": "2023-02-03",
"expiry_date": "2024-01-19",
"registrar_iana": 292,
"registrar_name": "MarkMonitor, Inc.",
"registrar_website": "http://www.markmonitor.com",
"registrant_company": "Yahoo Assets LLC",
"registrant_state": "VA",
"registrant_country": "US",
"registrant_email": "select request email form at https://domains.markmonitor.com/whois/yahoo.com",
"name_servers": [
"ns1.yahoo.com",
"ns2.yahoo.com",
"ns3.yahoo.com",
"ns4.yahoo.com",
"ns5.yahoo.com"
],
"domain_status": [
"clientDeleteProhibited",
"clientTransferProhibited",
"clientUpdateProhibited",
"serverDeleteProhibited",
"serverTransferProhibited",
"serverUpdateProhibited"
],
"dns_sec": [
"unsigned"
]
}
],
"stats": {
"total_time": 1.584,
"api_credits_used": 5,
"cost_calculation": "bulk_whois [5 domains]"
}
}WHOIS History Lookup
Get the historical WHOIS records of a domain name.
Cost for Single Query = (2 API Credits for 100 Results)
{
"success": true,
"query": {
"database": "historical",
"domain_name": "yahoo.com",
"sort_by": "query_time",
"sort_order": "asc",
"page_size": 100
},
"count": {
"total": 45,
"relation": "eq",
"current": 45
},
"unique_domains": "yahoo.com",
"results": [
{
"num": 1,
"domain_name": "yahoo.com",
"domain_keyword": "yahoo",
"domain_tld": "com",
"query_time": "2012-11-18 08:00:00",
"create_date": "1995-01-18",
"update_date": "2012-11-08",
"expiry_date": "2013-01-19",
"registrar_name": "MARKMONITOR INC.",
"registrant_name": "Domain Administrator",
"registrant_company": "Yahoo! Inc.",
"registrant_address": "701 First Avenue",
"registrant_city": "Sunnyvale",
"registrant_state": "CA",
"registrant_zip": "94089",
"registrant_country": "US",
"registrant_email": "[email protected]",
"registrant_phone": "14083493300",
"registrant_fax": "14083493300",
"name_servers": [
"ns1.yahoo.com",
"ns2.yahoo.com",
"ns3.yahoo.com",
"ns4.yahoo.com"
],
"domain_status": [
"clientDeleteProhibited",
"clientTransferProhibited",
"clientUpdateProhibited",
"serverDeleteProhibited"
]
},
{
"num": 2,
"domain_name": "yahoo.com",
"domain_keyword": "yahoo",
"domain_tld": "com",
"query_time": "2015-03-26 00:00:00",
"create_date": "1995-01-18",
"update_date": "2015-01-14",
"expiry_date": "2023-01-19",
"registrar_iana": 292,
"registrar_name": "MARKMONITOR INC.",
"registrant_name": "Domain Administrator",
"registrant_company": "Yahoo! Inc.",
"registrant_address": "701 First Avenue",
"registrant_city": "Sunnyvale",
"registrant_state": "CA",
"registrant_zip": "94089",
"registrant_country": "US",
"registrant_email": "[email protected]",
"registrant_phone": "14083493300",
"registrant_fax": "14083493301",
"name_servers": [
"ns1.yahoo.com",
"ns2.yahoo.com",
"ns3.yahoo.com",
"ns4.yahoo.com"
],
"domain_status": [
"clientDeleteProhibited",
"clientTransferProhibited",
"clientUpdateProhibited",
"serverDeleteProhibited"
]
},
{
"num": 3,
"domain_name": "yahoo.com",
"domain_keyword": "yahoo",
"domain_tld": "com",
"query_time": "2015-06-22 02:56:03",
"create_date": "1995-01-18",
"update_date": "2015-01-14",
"expiry_date": "2023-01-19",
"registrar_iana": 292,
"registrar_name": "MARKMONITOR INC.",
"registrant_name": "Domain Administrator",
"registrant_company": "Yahoo! Inc.",
"registrant_address": "701 First Avenue",
"registrant_city": "Sunnyvale",
"registrant_state": "CA",
"registrant_zip": "94089",
"registrant_country": "US",
"registrant_email": "[email protected]",
"registrant_phone": "14083493300",
"registrant_fax": "14083493301",
"name_servers": [
"ns1.yahoo.com",
"ns2.yahoo.com",
"ns3.yahoo.com",
"ns4.yahoo.com"
],
"domain_status": [
"clientDeleteProhibited",
"clientTransferProhibited",
"clientUpdateProhibited"
]
},
// remaining results truncated for easy viewing...
],
"stats": {
"total_time": 1.075,
"api_credits_used": 2,
"cost_calculation": "1 (database[historical]) + 1 (search_fields[domain_name]) = 2"
}
}Fuzzy Domains Finder
Find active domain names that look and sound exactly like your brand name.
Cost for Single Query = (3 API Credits for 100 Results)
{
"success": true,
"query": {
"fuzzy_domains": "facebook.com",
"page_size": 100
},
"count": {
"total": 3435,
"relation": "eq",
"current": 100
},
"unique_domains": "3acebook.com, fatebook.taipei, racebook.pro", // remaining domains truncated...
"results": [
{
"num": 1,
"domain_name": "3acebook.com",
"domain_keyword": "3acebook",
"domain_tld": "com",
"query_time": "2023-06-10 20:51:19",
"create_date": "2023-06-06",
"update_date": "2023-06-06",
"expiry_date": "2024-06-06",
"registrar_iana": 1861,
"registrar_name": "Porkbun LLC",
"registrar_website": "http://www.porkbun.com",
"registrant_name": "Whois Privacy",
"registrant_company": "Private by Design, LLC",
"registrant_address": "500 Westover Dr #9816",
"registrant_city": "Sanford",
"registrant_state": "NC",
"registrant_zip": "27330",
"registrant_country": "US",
"registrant_email": "https://porkbun.com/whois/contact/registrant/3acebook.com",
"registrant_phone": "+1.9712666028",
"name_servers": [
"curitiba.ns.porkbun.com",
"fortaleza.ns.porkbun.com",
"maceio.ns.porkbun.com",
"salvador.ns.porkbun.com"
],
"domain_status": [
"clientDeleteProhibited",
"clientTransferProhibited"
],
"dns_sec": [
"unsigned"
]
},
{
"num": 2,
"domain_name": "fatebook.taipei",
"domain_keyword": "fatebook",
"domain_tld": "taipei",
"query_time": "2023-06-17 08:27:43",
"create_date": "2017-11-21",
"update_date": "2022-11-21",
"expiry_date": "2023-11-21",
"registrar_iana": 1336,
"registrar_name": "Net-Chinese Co., Ltd.",
"registrar_website": "www.net-chinese.com.tw",
"registrant_name": "REDACTED FOR PRIVACY",
"registrant_company": "ORION MUSEUM HOLDING GROUP CO., LTD.",
"registrant_address": "REDACTED FOR PRIVACY",
"registrant_city": "REDACTED FOR PRIVACY",
"registrant_state": "Taipei",
"registrant_zip": "REDACTED FOR PRIVACY",
"registrant_country": "TW",
"registrant_email": "please query the rdds service of the registrar of record identified in this output for information on how to contact the registrant, admin, or tech contact of the queried domain name.",
"registrant_phone": "REDACTED FOR PRIVACY",
"registrant_fax": "REDACTED FOR PRIVACY",
"name_servers": [
"ens1.net-chinese.com.tw",
"ens2.net-chinese.com.tw"
],
"domain_status": [
"clientTransferProhibited"
],
"dns_sec": [
"unsigned"
]
},
{
"num": 3,
"domain_name": "racebook.pro",
"domain_keyword": "racebook",
"domain_tld": "pro",
"query_time": "2023-06-17 14:20:25",
"create_date": "2016-10-10",
"update_date": "2022-09-16",
"expiry_date": "2023-10-10",
"registrar_iana": 69,
"registrar_name": "Tucows Domains Inc.",
"registrar_website": "http://www.tucows.com",
"registrant_name": "REDACTED FOR PRIVACY",
"registrant_company": "RSZMotorsport",
"registrant_address": "REDACTED FOR PRIVACY",
"registrant_city": "REDACTED FOR PRIVACY",
"registrant_zip": "REDACTED FOR PRIVACY",
"registrant_country": "NL",
"registrant_email": "please query the rdds service of the registrar of record identified in this output for information on how to contact the registrant, admin, or tech contact of the queried domain name.",
"registrant_phone": "REDACTED FOR PRIVACY",
"registrant_fax": "REDACTED FOR PRIVACY",
"name_servers": [
"ns01.hostnet.nl",
"ns02.hostnet.nl"
],
"domain_status": [
"clientTransferProhibited",
"clientUpdateProhibited"
],
"dns_sec": [
"unsigned"
]
},
// remaining results truncated for easy viewing...
],
"stats": {
"total_time": 1.861,
"api_credits_used": 3,
"cost_calculation": "3 (fuzzy_domains [1 domain])"
}
}Reverse WHOIS Lookup
BigDomainData is made up of two primary WHOIS databases (Current WHOIS Database and Historical WHOIS Database). Our Current WHOIS Database contains the latest WHOIS record of active domain names (over 268 Million), that are currently registered. While the Historical WHOIS Database contains WHOIS history (over 1.99 Billion records) of every domain name (over 592 Million) that were ever registered on the Internet. Historical database contains WHOIS of current as well as expired and deleted domain names.
Both these databases can be searched through our Reverse WHOIS API.
https://api.bigdomaindata.com/?key=XXXXX&database=historical&search_field=search_keyword
Cost for Single Query = (Varies based on Complexity of the Search Query, Use Cost Estimate API to find the Cost)
{
"success": true,
"query": {
"database": "current",
"domain_keyword": "yahoo",
"sort_by": "query_time",
"sort_order": "asc",
"page_size": 100
},
"count": {
"total": 543,
"relation": "eq",
"current": 100
},
"unique_domains": "yahoo.fr, yahoo.id, yahoo.ma", // remaining domains truncated...
"results": [
{
"num": 1,
"domain_name": "yahoo.fr",
"domain_keyword": "yahoo",
"domain_tld": "fr",
"query_time": "2022-06-03 17:07:15",
"create_date": "1996-09-19",
"update_date": "2022-05-02",
"expiry_date": "2023-06-03",
"registrar_name": "MARKMONITOR Inc.",
"registrant_name": "YAHOO EMEA LIMITED",
"registrant_address": "5-7 Point Square North Wall Quay D01 CF99 Dublin Ireland",
"registrant_country": "IE",
"registrant_email": "[email protected]",
"registrant_phone": "+353.18663100",
"name_servers": [
"ns1.yahoo.com",
"ns2.yahoo.com",
"ns3.yahoo.com",
"ns5.yahoo.com",
"ns7.yahoo.com"
],
"domain_status": [
"ACTIVE"
]
},
{
"num": 2,
"domain_name": "yahoo.id",
"domain_keyword": "yahoo",
"domain_tld": "id",
"query_time": "2022-07-07 21:06:19",
"create_date": "2014-06-13",
"update_date": "2022-05-17",
"expiry_date": "2023-06-13",
"domain_status": [
"clientTransferProhibited",
"serverTransferProhibited"
]
},
{
"num": 3,
"domain_name": "yahoo.ma",
"domain_keyword": "yahoo",
"domain_tld": "ma",
"query_time": "2023-01-16 14:48:53",
"create_date": "2016-10-21",
"update_date": "2022-10-31",
"expiry_date": "2023-10-21",
"registrar_name": "MAROC HOST DATA CENTER",
"registrant_name": "Yahoo! Inc.",
"name_servers": [
"ns10.marochostpro.com",
"ns11.marochostpro.com"
],
"domain_status": [
"ok"
]
},
// remaining results truncated for easy viewing...
],
"search_after": "1683374458000_171487",
"stats": {
"total_time": 1.457,
"api_credits_used": 1,
"cost_calculation": "1 (search_fields[domain_keyword])"
}
}Reverse WHOIS - Search Fields
The following search fields are available for exact search in reverse whois lookup. The searched keyword must be fully present in the results to be returned. For partial (non-exact) searches, kindly check the guide for Wildcard Searches below this guide.
| Search Field | What does it search for? |
|---|---|
| domain_keyword | Only the domain keyword (does not include the domain extension). Example: yahoo |
| domain_name | The entire domain name (includes the domain extension). Example: yahoo.com |
| domain_tld | Only the domain name extension (without the domain keyword). Example: com |
| query_date | The date when the WHOIS record was saved into our database. Example: 2022-06-03 |
| query_date_from | Fetch all records having query_date from the date sent in this field. Example: 2022-06-01 |
| query_date_to | Fetch all records having query_date till the date sent in this field. Example: 2022-06-05 |
| query_year | Fetch all the WHOIS records that were saved in the requested year. Example: 2022 |
| create_date | The date when the domain name was registered. Example: 2016-10-21 |
| create_date_from | Fetch all records having create_date from the date sent in this field. Example: 2016-10-01 |
| create_date_to | Fetch all records having create_date till the date sent in this field. Example: 2016-10-31 |
| create_year | Fetch all the domain names that were registered in the requested year. Example: 2016 |
| update_date | The date when the domain's WHOIS details were updated/modified. Example: 2022-05-17 |
| update_date_from | Fetch all records having update_date from the date sent in this field. Example: 2022-05-10 |
| update_date_to | Fetch all records having update_date till the date sent in this field. Example: 2022-05-20 |
| update_year | Fetch all the domain names that were updated in the requested year. Example: 2022 |
| expiry_date | The date when the domain name is going to expire (or has expired). Example: 2023-06-03 |
| expiry_date_from | Fetch all records having expiry_date from the date sent in this field. Example: 2023-06-01 |
| expiry_date_to | Fetch all records having expiry_date till the date sent in this field. Example: 2023-06-05 |
| expiry_year | Fetch all the domain names that are expiring (or have expired) in the requested year. Example: 2023 |
| registrar_iana | Searches the domain's Registrar ID (Assigned by ICANN). Example: 146 for domains registered at GoDaddy. |
| registrar_name | Searches the domain's exact Registrar Name. Example: GoDaddy.com, LLC |
| registrar_website | Searches the domain's exact Registrar Website URL. Example: http://www.godaddy.com |
| registrant_name | The person who has registered the domain name. Example: Mark Zuckerberg |
| registrant_company | The company/business who has registered the domain name. Example: Meta Platforms, Inc. |
| registrant_address | The mailing address of the domain owner. Example: 1601 Willow Rd |
| registrant_city | The city name in which the domain owner is located. Example: Menlo Park |
| registrant_state | The state name in which the domain owner is located. Example: California |
| registrant_zip | The ZIP code (postal code) of the domain owner's mailing address. Example: 94025 |
| registrant_country | 2 letter country code (3166-1 alpha-2 code) where the domain owner is located. Example: US |
| registrant_email | The domain owner's email address listed in the WHOIS record. Example: [email protected] |
| registrant_phone | The domain owner's phone number listed in the WHOIS record. Example: +1.6505434800 |
| registrant_fax | The domain owner's fax number listed in the WHOIS record. Example: +1.6505434811 |
| name_servers | Searches the domain's name servers. Example: a.ns.facebook.com |
| domain_status | Searches the domain name's status. Example: clientDeleteProhibited |
| dns_sec | Checks the domain name's DNSSEC (Domain Name System Security Extensions). Example: unsigned |
Remember, the keyword you are searching must be exactly present in the search fields for the results to be returned. For partial searches (keyword starting with, ending with or containing the term), kindly check the guide for Wildcard Searches below.
Reverse WHOIS - Wildcard Searches
You can fetch WHOIS records that contain terms matching a wildcard pattern. A wildcard operator is a placeholder that matches one or more characters. For example, the * wildcard operator matches zero or more characters. You can combine wildcard operators with other characters to create a wildcard pattern.
/?key=XXXXX&database=current&domain_name_wildcard=*aho*
/?key=XXXXX&database=current&domain_name_wildcard=*hoo.com
/?key=XXXXX&database=current&domain_name_wildcard=?ahoo.com
/?key=XXXXX&database=current&domain_name_wildcard=yaho?.*
Cost for Single Query = (Cost can vary based on your Wildcard Search Query, Use Cost Estimate API to find the Cost)
| Wildcard Operator | What does it match? |
|---|---|
| ? | This operator matches any single character. |
| * | This operator can match zero or more characters, including an empty one. |
| Search | Cost | What does it return? |
|---|---|---|
| yahoo* | 2 | Every domain name that starts with yahoo. Example: yahoo.com, yahooinc.com, yahoo.net |
| *aho* | 20 | Every domain name that has contains aho keyword. Example: yahoo.com, pragahotel.uz, alphahost.dk |
| *hoo.com | 10 | Every domain name that ends with hoo.com keyword. Example: yellowhoo.com, hirehoo.com, gmhoo.com |
| ?ahoo.com | 5 | Every domain that contains a single character before ahoo.com. Example: oahoo.com, bahoo.com, 0ahoo.com |
| yaho?.* | 4 | Every domain name that contains a single character after yaho, followed by a dot and then ending with any number of characters. Example: yahoo.fr, yahod.link, yahoi.co.uk, yahoo.ac.nz, yahoo.net.nz, yaho0.info, yahoo.be, yahog.space |
The following search fields are available for wildcard search in reverse whois lookup:
| Search Field | What does it search for? |
|---|---|
| domain_name_wildcard | The entire domain name (includes the domain extension). Example: yahoo* |
| domain_keyword_wildcard | Only the domain keyword (does not include the domain extension). Example: *aho* |
| domain_tld_wildcard | Only the domain name extension (without the domain keyword). Example: *uk |
| registrar_name_wildcard | Searches the domain's exact Registrar Name. Example: *godaddy* |
| registrar_website_wildcard | Searches the domain's exact Registrar Website URL. Example: *godaddy.* |
| registrant_name_wildcard | The person who has registered the domain name. Example: mark* |
| registrant_company_wildcard | The company/business who has registered the domain name. Example: meta* |
| registrant_address_wildcard | The mailing address of the domain owner. Example: *willow* |
| registrant_city_wildcard | The city name in which the domain owner is located. Example: ?enlo* |
| registrant_state_wildcard | The state name in which the domain owner is located. Example: ca* |
| registrant_zip_wildcard | The ZIP code (postal code) of the domain owner's mailing address. Example: 9*0?? |
| registrant_email_wildcard | The domain owner's email address listed in the WHOIS record. Example: *@fb.com |
| registrant_phone_wildcard | The domain owner's phone number listed in the WHOIS record. Example: +1.* |
| registrant_fax_wildcard | The domain owner's fax number listed in the WHOIS record. Example: *65054348?? |
| name_servers_wildcard | Searches the domain's name servers. Example: *facebook.com |
| domain_status_wildcard | Searches the domain name's status. Example: *delete* |
| dns_sec_wildcard | Checks the domain name's DNSSEC (Domain Name System Security Extensions). Example: *signed |
Reverse WHOIS - Multiple Queries
You may query multiple search fields through the Reverse WHOIS API.
Cost for Single Query = (Varies based on Complexity of the Search Query, Use Cost Estimate API to find the Cost)
{
"success": true,
"query": {
"database": "current",
"domain_keyword_wildcard": "yahoo*",
"domain_tld": "com",
"create_year": "2000",
"sort_by": "query_time",
"sort_order": "asc",
"page_size": 100
},
"count": {
"total": 30,
"relation": "eq",
"current": 30
},
"unique_domains": "yahoone.com, yahoo2.com, yahooalerts.com", // remaining domains truncated...
"results": [
{
"num": 1,
"domain_name": "yahoone.com",
"domain_keyword": "yahoone",
"domain_tld": "com",
"query_time": "2023-05-12 13:00:45",
"create_date": "2000-01-29",
"update_date": "2022-01-26",
"expiry_date": "2025-01-29",
"registrar_iana": 87,
"registrar_name": "HANGANG Systems, Inc. dba Doregi.com",
"registrar_website": "http://www.doregi.com",
"name_servers": [
"ns.interpia98.net",
"ns.piahost.net"
],
"domain_status": [
"clientTransferProhibited"
],
"dns_sec": [
"unsigned"
]
},
{
"num": 2,
"domain_name": "yahoo2.com",
"domain_keyword": "yahoo2",
"domain_tld": "com",
"query_time": "2023-05-17 07:18:21",
"create_date": "2000-08-09",
"update_date": "2022-11-21",
"expiry_date": "2023-08-09",
"registrar_iana": 292,
"registrar_name": "MarkMonitor, Inc.",
"registrar_website": "http://www.markmonitor.com",
"registrant_company": "Yahoo Assets LLC",
"registrant_state": "VA",
"registrant_country": "US",
"registrant_email": "select request email form at https://domains.markmonitor.com/whois/yahoo2.com",
"name_servers": [
"1ns.yahoo.com",
"2ns.yahoo.com"
],
"domain_status": [
"clientDeleteProhibited",
"clientTransferProhibited",
"clientUpdateProhibited"
],
"dns_sec": [
"unsigned"
]
},
{
"num": 3,
"domain_name": "yahooalerts.com",
"domain_keyword": "yahooalerts",
"domain_tld": "com",
"query_time": "2023-05-17 07:18:22",
"create_date": "2000-09-30",
"update_date": "2022-11-21",
"expiry_date": "2023-09-30",
"registrar_iana": 292,
"registrar_name": "MarkMonitor, Inc.",
"registrar_website": "http://www.markmonitor.com",
"registrant_company": "Yahoo Assets LLC",
"registrant_state": "VA",
"registrant_country": "US",
"registrant_email": "select request email form at https://domains.markmonitor.com/whois/yahooalerts.com",
"name_servers": [
"1ns.yahoo.com",
"2ns.yahoo.com"
],
"domain_status": [
"clientDeleteProhibited",
"clientTransferProhibited",
"clientUpdateProhibited"
],
"dns_sec": [
"unsigned"
]
},
// remaining results truncated for easy viewing...
],
"search_after": "1684566065000_649417",
"stats": {
"total_time": 0.98,
"api_credits_used": 4,
"cost_calculation": "2 (search_fields[domain_tld,create_year]) + 2 (wildcard_searches[domain_keyword_wildcard]) = 4"
}
}Cost Estimate
To get an estimate the cost of your API query, simply add "&estimate" to your query.
Cost for Single Query = (0 API Credits)
{
"success": true,
"query": {
"current_whois": "yahoo.com"
},
"estimate": {
"api_credits_required": 1,
"cost_calculation": "current_whois [1 domain]"
}
}Count Total Results
The total count of results for your query will be provided in the following format:
Generally the total results count can't be computed accurately without visiting all matches, which is costly for queries that match lots of documents. So, the API will count the total accurately up to 10,000 results. It is a good trade-off to speed up searches if you don't need the accurate number of results after a certain threshold. The "relation" determines how the "total" should be interpreted. A value of "gte" means that there might be more than the "total" results. When the relation has value of "eq", it indicates that "total" is the exact count. The value of "current" is the total number of results in current page.
Count Exact Number of Total Results
If you still want to see the exact number of total results, simply add "&count" to your query.
/?key=XXXXX&database=historical&name_servers_wildcard=*.yahoo.com&count
Cost for Single Query = (1 API Credit for Current Database | 2 API Credits for Historical Database)
{
"success": true,
"query": {
"database": "historical",
"name_servers_wildcard": "*.yahoo.com"
},
"exact_count": 1788341,
"stats": {
"total_time": 0.926,
"api_credits_used": 2,
"cost_calculation": "Exact Count API"
}
}The exact count feature is available only for Reverse WHOIS API. Please be aware, the count can be slow if there are very large number of results.
Change Page Size
By default, 100 results are returned per query. To get more results, simply add "&page_size=" to your query.
/?key=XXXXX&database=current&domain_keyword=yahoo&page_size=5000
/?key=XXXXX&database=current&domain_keyword=yahoo&page_size=10000
Cost for Single Query = (Additional 1 API Credit for each 100 Results, Max 10000 Results Allowed)
Search Pagination
If the total results are greater than current page size, simply add "&search_after=" to get the next page of results.
Replace "XXXXXXX_XXXXX" with the value you receive for "search_after" at current page.
Change Results Sorting
By default, results are sorted by "query_time" in ascending order. You can change the sorting in the following ways:
/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=domain_name&sort_order=desc
/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=domain_tld&sort_order=asc
/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=domain_tld&sort_order=desc
/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=query_time&sort_order=asc
/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=query_time&sort_order=desc
/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=create_date&sort_order=asc
/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=create_date&sort_order=desc
/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=update_date&sort_order=asc
/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=update_date&sort_order=desc
/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=expiry_date&sort_order=asc
/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=expiry_date&sort_order=desc
/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=registrar_iana&sort_order=asc
/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=registrar_iana&sort_order=desc
Cost for Single Query = (Same as with Default Sorting, No Extra Charges to Change Sorting)
Retrieve Only Domains
To get only domain names and skip the WHOIS data, simply add "&onlydomains" to your query.
Cost for Single Query = (Same as with WHOIS Data)
API Usage Limits
When you sign up with us, your account's initial limit is set to 5,000 credits per hour. This limit increases based on the package that you purchase. When you purchase our 25,000 API Credits package ($100), your account's limit is changed to 25,000 credits per hour. When you purchase the Enterprise package (1 Billion API Credits), your account's limit is permanently set to 250,000 credits per hour. If you exceed the allocated limit, access to API will be blocked for an 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.
Frequently Asked Questions
- Where can I get an API key?
- Which domain extensions (TLDs) are supported?
- Will I get Raw WHOIS in my results?
- Am I charged for empty results or failed queries?
- What are the API usage limits?
Q. Where can I get an API key?
You can generate API keys through the Members Area.
Q. Which domain extensions (TLDs) are supported?
We support all the major Domain Extensions (gTLDs, ccTLDs and new gTLDs). Our Current WHOIS Database contains about 1551 TLDs, while our Historical WHOIS Database contains WHOIS records of about 3738 TLDs.
Q. Will I get Raw WHOIS in my results?
Unfortunately no! We only store parsed WHOIS records in our database, which can be easily searched. RAW WHOIS takes up a lot of space and is not suitable for accurate searches. So we do not store RAW WHOIS, and you will receive only the parsed WHOIS data.
Q. Am I charged for empty results or failed queries?
For failed queries (success=false), you will not be charged any API credits. However, when the query is successful (success=true), you will be charged the necessary API credits irrespective of the results. The cost is for querying the database, and empty results (when there are no matching records in our database for your query) also consume the same processing power as for non-empty results.
Q. What are the API usage limits?
Please check the API Usage Limits section above Frequently Asked Questions.