WHOIS History API
Get the historical WHOIS records of a domain name.
Get the WHOIS history of any domain name through the following API:
Replace the key "XXXXX" with your own API key, generated through the Members Area.
Cost for Single Query = (2 API Credits for 100 Results)
{
"success": true,
"query": {
"database": "historical",
"domain_name": "youtube.com",
"sort_by": "query_time",
"sort_order": "asc",
"page_size": 100
},
"count": {
"total": 35,
"relation": "eq",
"current": 35
},
"unique_domains": "youtube.com",
"results": [
{
"num": 1,
"domain_name": "youtube.com",
"domain_keyword": "youtube",
"domain_tld": "com",
"query_time": "2012-11-18 08:00:00",
"create_date": "2005-02-15",
"update_date": "2012-01-14",
"expiry_date": "2013-02-15",
"registrar_name": "MARKMONITOR INC.",
"registrant_name": "DNS Admin",
"registrant_company": "Google Inc.",
"registrant_address": "1600 Amphitheatre Parkway",
"registrant_city": "Mountain View",
"registrant_state": "CA",
"registrant_zip": "94043",
"registrant_country": "US",
"registrant_email": "[email protected]",
"registrant_phone": "16502530000",
"registrant_fax": "16502530000",
"name_servers": [
"ns1.google.com",
"ns2.google.com",
"ns3.google.com",
"ns4.google.com"
],
"domain_status": [
"clientDeleteProhibited",
"clientTransferProhibited",
"clientUpdateProhibited",
"serverDeleteProhibited"
]
},
{
"num": 2,
"domain_name": "youtube.com",
"domain_keyword": "youtube",
"domain_tld": "com",
"query_time": "2015-03-26 00:00:00",
"create_date": "2005-02-15",
"update_date": "2015-01-14",
"expiry_date": "2016-02-15",
"registrar_iana": 292,
"registrar_name": "MARKMONITOR INC.",
"registrant_name": "DNS Admin",
"registrant_company": "Google Inc.",
"registrant_address": "1600 Amphitheatre Parkway",
"registrant_city": "Mountain View",
"registrant_state": "CA",
"registrant_zip": "94043",
"registrant_country": "US",
"registrant_email": "[email protected]",
"registrant_phone": "16502530000",
"registrant_fax": "16506188571",
"name_servers": [
"ns1.google.com",
"ns2.google.com",
"ns3.google.com",
"ns4.google.com"
],
"domain_status": [
"clientDeleteProhibited",
"clientTransferProhibited",
"clientUpdateProhibited",
"serverDeleteProhibited"
]
},
{
"num": 3,
"domain_name": "youtube.com",
"domain_keyword": "youtube",
"domain_tld": "com",
"query_time": "2015-06-22 02:56:03",
"create_date": "2005-02-15",
"update_date": "2015-01-14",
"expiry_date": "2016-02-15",
"registrar_iana": 292,
"registrar_name": "MARKMONITOR INC.",
"registrant_name": "DNS Admin",
"registrant_company": "Google Inc.",
"registrant_address": "1600 Amphitheatre Parkway",
"registrant_city": "Mountain View",
"registrant_state": "CA",
"registrant_zip": "94043",
"registrant_country": "US",
"registrant_email": "[email protected]",
"registrant_phone": "16502530000",
"registrant_fax": "16506188571",
"name_servers": [
"ns1.google.com",
"ns2.google.com",
"ns3.google.com",
"ns4.google.com"
],
"domain_status": [
"clientDeleteProhibited",
"clientTransferProhibited",
"clientUpdateProhibited"
]
},
// remaining results truncated for easy viewing...
],
"stats": {
"total_time": 0.712,
"api_credits_used": 2,
"cost_calculation": "1 (database[historical]) + 1 (search_fields[domain_name]) = 2"
}
}
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)
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.
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=historical&domain_name=youtube.com&page_size=5000
https://api.bigdomaindata.com/?key=XXXXX&database=historical&domain_name=youtube.com&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=historical&domain_name=youtube.com&sort_by=query_time&sort_order=desc
https://api.bigdomaindata.com/?key=XXXXX&database=historical&domain_name=youtube.com&sort_by=create_date&sort_order=asc
https://api.bigdomaindata.com/?key=XXXXX&database=historical&domain_name=youtube.com&sort_by=create_date&sort_order=desc
https://api.bigdomaindata.com/?key=XXXXX&database=historical&domain_name=youtube.com&sort_by=update_date&sort_order=asc
https://api.bigdomaindata.com/?key=XXXXX&database=historical&domain_name=youtube.com&sort_by=update_date&sort_order=desc
https://api.bigdomaindata.com/?key=XXXXX&database=historical&domain_name=youtube.com&sort_by=expiry_date&sort_order=asc
https://api.bigdomaindata.com/?key=XXXXX&database=historical&domain_name=youtube.com&sort_by=expiry_date&sort_order=desc
https://api.bigdomaindata.com/?key=XXXXX&database=historical&domain_name=youtube.com&sort_by=registrar_iana&sort_order=asc
https://api.bigdomaindata.com/?key=XXXXX&database=historical&domain_name=youtube.com&sort_by=registrar_iana&sort_order=desc
Cost for Single Query = (Same as with Default Sorting, No Extra Charges to Change Sorting)