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:

https://api.bigdomaindata.com/status.php 
{
    "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.

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

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.

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

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.

https://api.bigdomaindata.com/?key=XXXXX&current_whois=yahoo.com

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]"
    }
}
For more details, kindly see our Current WHOIS API usage guide.

Bulk WHOIS Lookup

Get the current WHOIS record of multiple domain names (max 10,000).

/?key=XXXXX&bulk_whois=yahoo.com,google.com,facebook.com,twitter.com,amazon.com

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]"
    }
}
For more details, kindly see our Bulk WHOIS API usage guide.

WHOIS History Lookup

Get the historical WHOIS records of a domain name.

https://api.bigdomaindata.com/?key=XXXXX&database=historical&domain_name=yahoo.com

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"
    }
}
For more details, kindly see our WHOIS History API usage guide.

Fuzzy Domains Finder

Find active domain names that look and sound exactly like your brand name.

https://api.bigdomaindata.com/?key=XXXXX&fuzzy_domains=facebook.com

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])"
    }
}
For more details, kindly see our Fuzzy Domains API usage guide.

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 254 Million), that are currently registered. While the Historical WHOIS Database contains WHOIS history (over 1.46 Billion records) of every domain name (over 540 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=current&search_field=search_keyword
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])"
    }
}
For more details, kindly see our Reverse WHOIS API usage guide.

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_name The entire domain name (includes the domain extension). Example: yahoo.com
domain_keyword Only the domain keyword (does not include the domain extension). Example: yahoo
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=yahoo*
/?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.
Warning! Avoid beginning searches with * or ?. This can increase the iterations needed to find matching terms and slow search performance. Wildcard searches that begin with ? have a 5x cost, while searches that begin with * have a 10x cost. Each additional ? and * that are present in the search query will add up the total cost. The total cost can be high if you are making wildcard searches with multiple * or ?. It is recommended to use the Cost Estimate API before running wildcard searches.
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.

/?key=XXXXX&database=current&domain_keyword_wildcard=yahoo*&domain_tld=com&create_year=2000

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.

https://api.bigdomaindata.com/?key=XXXXX&current_whois=yahoo.com&estimate

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:

"count": { "total": 430, "relation": "eq", "current": 100 }

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=current&domain_keyword_wildcard=*yahoo*&count
/?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=1000
/?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.

/?key=XXXXX&database=current&domain_keyword=yahoo&search_after=XXXXXXX_XXXXX

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=asc
/?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.

/?key=XXXXX&database=current&domain_keyword=yahoo&onlydomains

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

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.

Still have questions? Contact Us »