dropdown

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:

Copied
GET https://files.whoisfreaks.com/v1.0/2022-06-16?apiKey=API_KEY&fileType=dailydbupdate
GET https://files.whoisfreaks.com/v1.0/2022-06-16?apiKey=API_KEY&fileType=weeklydbupdate
GET https://files.whoisfreaks.com/v1.0/2022-06-16?apiKey=API_KEY&fileType=monthlydbupdate

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

Download sample of database updates whois files from here sample.csv

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

HTTP Code
Error Message
400 FileType type did not found.you can pass param dailydbupdate - weeklydbupdate - monthlydbupdate 400 Api record not found. [For Technical Support: support@whoisfreaks.com] 400 Please Buy Database subscription. [For Technical Support: support@whoisfreaks.com] 400 Your Database subscription is inactive. [For Technical Support: support@whoisfreaks.com] 400 Please upgrade your plans.This Plan does not have to access to download file. [For Technical Support: support@whoisfreaks.com] 400 You have exceeded the download limit of 30000 [For Technical Support: support@whoisfreaks.com]
            
{
    "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": "/v1.0/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": "/v1.0/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": "/v1.0/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": "/v1.0/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": "/v1.0/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": "/v1.0/2022-06-16?fileType=dailydbupdate&apiKey=API_KEY
}
            
            

Code Snippet


    curl --location --request GET 'https://files.whoisfreaks.com/v1.0/2022-06-16?fileType=dailydbupdate&apiKey=API_KEY'



var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://files.whoisfreaks.com/v1.0/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/v1.0/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", "/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/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