The Most Powerful Reverse WHOIS API
Search the entire WHOIS database and find domain names owned by a person, company or email address.
Both these databases can be searched through our Reverse WHOIS API.
https://api.bigdomaindata.com/?key=XXXXX&database=historical&search_field=search_keyword
Replace the key "XXXXX" with your own API key, generated through the Members Area.
Cost for Single Query = (Varies based on Complexity of the Search Query, Use Cost Estimate API to find the Cost)
Sample Reverse WHOIS API Query
The following query return all the domain names with keyword "yahoo" that are currently active, sorted by the domain's registration date.
{
"success": true,
"query": {
"database": "current",
"domain_keyword": "yahoo",
"sort_by": "create_date",
"sort_order": "asc",
"page_size": 100
},
"count": {
"total": 544,
"relation": "eq",
"current": 100
},
"unique_domains": "yahoo.com, yahoo.be, yahoo.fr, yahoo.net, yahoo.co.nz, yahoo.pl, yahoo.com.ag, yahoo.it, yahoo.com.cn, yahoo.io, yahoo.sh, yahoo.tc, yahoo.gs, yahoo.vg, yahoo.nl, yahoo.org, yahoo.com.br, yahoo.rw, yahoo.ws, yahoo.com.co, yahoo.net.co, yahoo.tv, yahoo.cc, yahoo.tl, yahoo.ca, yahoo.pt, yahoo.com.pt, yahoo.ie, yahoo.jp, yahoo.info, yahoo.in.th, yahoo.cx, yahoo.biz, yahoo.us, yahoo.com.bz, yahoo.org.bz, yahoo.ac, yahoo.by, yahoo.bi, yahoo.vc, yahoo.gl, yahoo.net.cn, yahoo.org.cn, yahoo.cn, yahoo.co.th, yahoo.com.pr, yahoo.com.af, yahoo.co.in, yahoo.ly, yahoo.la, yahoo.dm, yahoo.ht, yahoo.pro, yahoo.com.ps, yahoo.ps, yahoo.net.in, yahoo.firm.in, yahoo.gen.in, yahoo.org.in, yahoo.hi.cn, yahoo.jobs, yahoo.pr, yahoo.travel, yahoo.cat, yahoo.net.vc, yahoo.com.vc, yahoo.net.pl, yahoo.md, yahoo.in, yahoo.af, yahoo.mobi, yahoo.net.nz, yahoo.gd, yahoo.lc, yahoo.nf, yahoo.net.sb, yahoo.com.sb, yahoo.sa.com, yahoo.gy, yahoo.me, yahoo.com.cm, yahoo.tel, yahoo.co.nl, yahoo.com.mg, yahoo.cm, yahoo.hn, yahoo.co, yahoo.com.ng, yahoo.mg, yahoo.gr.com, yahoo.so, yahoo.kn, yahoo.us.org, yahoo.ag, yahoo.sx, yahoo.miyazaki.jp, yahoo.niigata.jp, yahoo.kumamoto.jp, yahoo.hyogo.jp, yahoo.aichi.jp",
"results": [
{
"num": 1,
"domain_name": "yahoo.com",
"domain_keyword": "yahoo",
"domain_tld": "com",
"query_time": "2023-07-22 14:58:58",
"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"
]
},
{
"num": 2,
"domain_name": "yahoo.be",
"domain_keyword": "yahoo",
"domain_tld": "be",
"query_time": "2023-07-16 02:15:12",
"create_date": "1996-07-19",
"registrar_name": "MarkMonitor Inc.",
"registrar_website": "https://www.markmonitor.com",
"name_servers": [
"ns1.yahoo.com",
"ns2.yahoo.com",
"ns3.yahoo.com",
"ns4.yahoo.com",
"ns5.yahoo.com"
],
"domain_status": [
"Not Available",
"clientTransferProhibited"
]
},
{
"num": 3,
"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"
]
},
// remaining results truncated for easy viewing...
],
"search_after": "1353283200000_969732",
"stats": {
"total_time": 1.394,
"api_credits_used": 1,
"cost_calculation": "1 (search_fields[domain_keyword])"
}
}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)
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.
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.
https://api.bigdomaindata.com/?key=XXXXX&database=current&domain_name_wildcard=*aho*
https://api.bigdomaindata.com/?key=XXXXX&database=current&domain_name_wildcard=*hoo.com
https://api.bigdomaindata.com/?key=XXXXX&database=current&domain_name_wildcard=?ahoo.com
https://api.bigdomaindata.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 |
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": "yahoo2.com, yahooalerts.com, yahoobytel.com, yahooenjoy.com, yahoofantasyfootball.com, yahooforecast.com, yahoopatent.com, yahoopublishing.com, yahoo-ka.com, yahoo-finance.com, yahooes.com, yahoosg.com, yahootw.com, yahoo-email.com, yahooauction.com, yahoofs.com, yahookids.com, yahoowallet.com, yahoob.com, yahoog.com, yahooi.com, yahoox.com, yahooy.com, yahooyahoo.com, yahooinc.com, yahoooooo.com, yahoo-webring.com, yahoogroups.com, yahoomesenger.com, yahoone.com",
"results": [
{
"num": 1,
"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": 2,
"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"
]
},
{
"num": 3,
"domain_name": "yahoobytel.com",
"domain_keyword": "yahoobytel",
"domain_tld": "com",
"query_time": "2023-05-17 07:18:23",
"create_date": "2000-09-28",
"update_date": "2022-11-21",
"expiry_date": "2023-09-28",
"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/yahoobytel.com",
"name_servers": [
"1ns.yahoo.com",
"2ns.yahoo.com"
],
"domain_status": [
"clientDeleteProhibited",
"clientTransferProhibited",
"clientUpdateProhibited"
],
"dns_sec": [
"unsigned"
]
},
// remaining results truncated for easy viewing...
],
"stats": {
"total_time": 1.626,
"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": {
"database": "current",
"domain_keyword_wildcard": "yahoo*",
"domain_tld": "com",
"create_year": "2000",
"sort_by": "query_time",
"sort_order": "asc",
"page_size": 100
},
"estimate": {
"api_credits_required": 4,
"cost_calculation": "2 (search_fields[domain_tld, create_year]) + 2 (wildcard_searches[domain_keyword_wildcard]) = 4"
}
}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"
}
}Please be aware, the count can be slow if there are very large number of results. Kindly use this feature judiciously, reserving it for situations where the precise result count is necessary.
Change Page Size
By default, 100 results are returned per query. To get more results, simply add "&page_size=" to your query.
https://api.bigdomaindata.com/?key=XXXXX&database=current&domain_keyword=yahoo&page_size=5000
https://api.bigdomaindata.com/?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:
https://api.bigdomaindata.com/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=domain_name&sort_order=desc
https://api.bigdomaindata.com/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=domain_tld&sort_order=asc
https://api.bigdomaindata.com/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=domain_tld&sort_order=desc
https://api.bigdomaindata.com/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=query_time&sort_order=asc
https://api.bigdomaindata.com/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=query_time&sort_order=desc
https://api.bigdomaindata.com/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=create_date&sort_order=asc
https://api.bigdomaindata.com/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=create_date&sort_order=desc
https://api.bigdomaindata.com/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=update_date&sort_order=asc
https://api.bigdomaindata.com/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=update_date&sort_order=desc
https://api.bigdomaindata.com/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=expiry_date&sort_order=asc
https://api.bigdomaindata.com/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=expiry_date&sort_order=desc
https://api.bigdomaindata.com/?key=XXXXX&database=current&domain_keyword=yahoo&sort_by=registrar_iana&sort_order=asc
https://api.bigdomaindata.com/?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)
Sample Queries
Find all active domains that contain the keyword "amazon" anywhere in the domain name:
Find all active UK domain names (.UK, .CO.UK, .ME.UK etc) that were registered in current year:
Find all historical WHOIS records that were fetched today:
Find all domain names that were registered yesterday from France:
Find all domain names that were registered at GoDaddy and last updated in the year 2021:
Find all active .COM domain names are going to expire today:
Find all domain names currently registered from the United Kingdom at registrar GoDaddy (Registrar IANA ID: 146):
Find all active domain names registered by person with name starting with "Michael":
Find all domain names ever registered having the term "apple inc" in company name:
Find domain names currently registered having the street address exactly as "1601 Willow Rd":
Find active domains registered from the city of "New York" and state of "NY":
Find active domain names registered from the ZIP code of "SW1" in London (United Kingdom):
Find all domain names currently registered with email address "[email protected]":
Find all domain names ever registered in history, and having an email domain as "yahoo-inc.com":
Find all current domain names using the phone number "+1.4152229670" in their WHOIS contact:
Find all domain names in history to ever use the fax number "+1.4152220922" in their WHOIS contact:
Find all domain names that are currently parked at DAN Marketplace, sorted by their registration date (earliest first):
Find all active domain names that are about to get dropped:
Find all active domain names that have a "signed" DNSSEC:
If you are still unable to create your API query, please contact us and we will be happy to assist you create your desired API query.