Note:
- After purchasing database subscription you can download database files using API or from billing dashboard according to your subscription package.
- Database update file will contain change log consisting of domains data which are updated in our database
- Newly, Dropped and Database update files will be available in one compressed (.zip) file.
Calling API
For getting the API key, you need to get started with our developer account. When you sign up then you can copy the API key from our billing dashboard. Here is the API endpoint:



Input parameters: required
apiKey Get your API key from our billing dashboard
date Required date for database file. Date format should be (yyyy-MM-dd)
fileType Required whois fileType for Database Subscription like dailydbupdate - weeklydbupdate - monthlydbupdate
Sample
CSV file Format
num,domain_name,query_time,create_date,update_date,expiry_date,domain_registrar_id,domain_registrar_name, domain_registrar_whois, domain_registrar_url,registrant_name,registrant_company,registrant_address,registrant_city,registrant_state,registrant_zip,registrant_country_code,registrant_country,registrant_email,registrant_phone,registrant_fax, administrative_name, administrative_company, administrative_address, administrative_city,administrative_state,administrative_zip,administrative_country_code,administrative_country,administrative_email,administrative_phone,administrative_fax, technical_name,technical_company,technical_address,technical_city,technical_state,technical_zip,technical_country_code,technical_country,technical_email,technical_phone,technical_fax, billing_name,billing_company,billing_address,billing_city,billing_state,billing_zip,billing_country_code,billing_country,billing_email,billing_phone,billing_fax, name_server_1,name_server_2,name_server_3,name_server_4,domain_status_1,domain_status_2,domain_status_3,domain_status_4
1,"fangbang.top","2021-01-20 00:57:33","2021-01-18","","2022-01-18","1915","west263 International Limited","whois.west263.com","http://www.hkdns.hk","REDACTED FOR PRIVACY","Li Hui Chen",,"REDACTED FOR PRIVACY","Tian Jin Shi","REDACTED FOR PRIVACY","CN","China","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.","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY",,"REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","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.","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY",,"REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","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.","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","","","","","","","","","","","","ns3.myhostadmin.net","ns4.myhostadmin.net","","","addPeriod","ok","",""
2,"fd99.top","2021-01-20 00:57:33","2021-01-18","2021-01-18","2022-01-18","1469","JIANGSU BANGNING SCIENCE & TECHNOLOGY CO. LTD","Whois.55hl.com","www.55hl.com","REDACTED FOR PRIVACY","åæ°¸ä¸º",,"REDACTED FOR PRIVACY","guangdong","REDACTED FOR PRIVACY","CN","China","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.","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY",,"REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","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.","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY",,"REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","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.","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","","","","","","","","","","","","jm2.dns.com","jm1.dns.com","","","addPeriod","ok","",""
3,"fengtiaoyushun.top","2021-01-20 00:57:33","2021-01-15","2021-01-18","2022-01-15","1599","Alibaba Cloud Computing Ltd. d/b/a HiChina (www.net.cn)","whois.hichina.com/","http://www.net.cn","REDACTED FOR PRIVACY","bei jing cheng ge xin xi ke ji you xian gong si",,"REDACTED FOR PRIVACY","bei jing","REDACTED FOR PRIVACY","CN","China","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.","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY",,"REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","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.","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY",,"REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","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.","REDACTED FOR PRIVACY","REDACTED FOR PRIVACY","","","","","","","","","","","","dns25.hichina.com","dns26.hichina.com","","","addPeriod","ok","",""
HTTP Error Codes
{
"timestamp": "2021-02-02T11:35:17.475+00:00",
"status": 400,
"error": "Api Access Exception",
"message": "FileType type did not found. You can pass param dailydbupdate - weeklydbupdate - monthlydbupdate",
"path": "/v2/2021-01-12/fileType=dailydbupdate&apikey=API_KEY"
}
{
"timestamp": "2021-02-02T11:35:17.475+00:00",
"status": 400,
"error": "Api Access Exception",
"message": "Api record not found. [For Technical Support: support@whoisfreaks.com]",
"path": "/v2/2022-06-16?fileType=dailydbupdate&apiKey=API_KEY
}
{
"timestamp": "2021-02-02T11:35:17.475+00:00",
"status": 400,
"error": "Api Access Exception",
"message": "Please Buy Database subscription. [For Technical Support: support@whoisfreaks.com]",
"path": "/v2/2022-06-16?fileType=dailydbupdate&apiKey=API_KEY
}
{
"timestamp": "2021-02-02T11:35:17.475+00:00",
"status": 400,
"error": "Api Access Exception",
"message": "Your Database subscription plan is inactive. [For Technical Support: support@whoisfreaks.com]",
"path": "/v2/2022-06-16?fileType=dailydbupdate&apiKey=API_KEY
}
{
"timestamp": "2021-02-02T11:35:17.475+00:00",
"status": 400,
"error": "Api Access Exception",
"message": "Please upgrade your plans. This Plan does not have to access to download file. [For Technical Support: support@whoisfreaks.com]",
"path": "/v2/2022-06-16?fileType=dailydbupdate&apiKey=API_KEY
}
{
"timestamp": "2021-02-02T11:35:17.475+00:00",
"status": 400,
"error": "Api Access Exception",
"message": "You have exceeded the download limit of 30000 [For Technical Support: support@whoisfreaks.com]",
"path": "/v2/2022-06-16?fileType=dailydbupdate&apiKey=API_KEY
}
Code Snippet
curl --location --request GET 'https://files.whoisfreaks.com/v2/2022-06-16?fileType=dailydbupdate&apiKey=API_KEY'
var request = require('request');
var options = {
'method': 'GET',
'url': 'https://files.whoisfreaks.com/v2/2022-06-16?fileType=dailydbupdate&apiKey=API_KEY',
'headers': {
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
Request request = new Request.Builder()
.url("https://files.whoisfreaks.com/v2/2022-06-16?fileType=dailydbupdate&apiKey=API_KEY")
.method("GET", null)
.build();
Response response = client.newCall(request).execute();
import http.client
conn = http.client.HTTPSConnection("files.whoisfreaks.com")
payload = ''
headers = {}
conn.request("GET", "/v2/2022-06-16?fileType=dailydbupdate&apiKey=API_KEY", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
'https://files.whoisfreaks.com/v2/2022-06-16?fileType=dailydbupdate&apiKey=API_KEY',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
require "uri"
require "net/http"
url = URI("https://files.whoisfreaks.com/v2/2022-06-16?fileType=dailydbupdate&apiKey=API_KEY")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Get.new(url)
response = https.request(request)
puts response.read_body
var requestOptions = {
method: 'GET',
redirect: 'follow'
};
fetch("https://files.whoisfreaks.com/v2/2022-06-16?fileType=dailydbupdate&apiKey=API_KEY", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
var client = new RestClient("https://files.whoisfreaks.com/v2/2022-06-16?fileType=dailydbupdate&apiKey=API_KEY");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://files.whoisfreaks.com/v2/2022-06-16?fileType=dailydbupdate&apiKey=API_KEY"
method := "GET"
client := &http.Client {
}
req, err := http.NewRequest(method, url, nil)
if err != nil {
fmt.Println(err)
return
}
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
CURL *curl;
CURLcode res;
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(curl, CURLOPT_URL, "https://files.whoisfreaks.com/v2/2022-06-16?fileType=dailydbupdate&apiKey=API_KEY");
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
curl_easy_setopt(curl, CURLOPT_DEFAULT_PROTOCOL, "https");
struct curl_slist *headers = NULL;
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
res = curl_easy_perform(curl);
}
curl_easy_cleanup(curl);
import Foundation
#if canImport(FoundationNetworking)
import FoundationNetworking
#endif
var semaphore = DispatchSemaphore (value: 0)
var request = URLRequest(url: URL(string: "https://files.whoisfreaks.com/v2/2022-06-16?fileType=dailydbupdate&apiKey=API_KEY")!,timeoutInterval: Double.infinity)
request.httpMethod = "GET"
let task = URLSession.shared.dataTask(with: request) { data, response, error in
guard let data = data else {
print(String(describing: error))
semaphore.signal()
return
}
print(String(data: data, encoding: .utf8)!)
semaphore.signal()
}
task.resume()
semaphore.wait()
FAQs
What is update schedule for daily, weekly and monthly database subscription?
- Daily Database Subscription file is updated daily on 4:00 AM UTC
- Weekly Database Subscription file is updated every Monday at 3:00 AM UTC
- Monthly Database Subscription file is updated on 1st of every month on 3:00 AM UTC
Which TLDs included in Database update files?
You can check current supported TLD's here
Can I check programmatically any type (newly - cctld - expired - dropped | dailydbUpdate | weeklydbupdate | monthlydbupdate) of generated file status?
Yes, with our api endpoint https://files.whoisfreaks.com/v2/status you can check details of whois files.
Do you have notification service after generating whois files?
Yes, we inform you via an email when any type (newly | cctld | expired | dropped | dailydbUpdate | weeklydbupdate | monthlydbupdate) of file is generated.
Can I Download the files manually?
Yes, you can download database files after sign in from our billing dashboard