Note:

You can download newly registered whois files from our billing dashboard manually. Please Sign in and download whois files after buying domainer subscription or you can use our API for downloading whois files.

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/2021-01-12?apiKey=API_KEY&fileType=gtld
GET https://files.whoisfreaks.com/v1.0/2021-01-12?apiKey=API_KEY&fileType=cctld

Input parameters: required

apiKey Get your API key from our billing dashboard.

date Required date of newly registered whois file. Date format should be (yyyy-MM-dd).

fileType Required whois file like newly|cctld|expired|dropped.


Sample

Download sample of newly registered whois files from here gtld_sample.csv
Download sample of newly registered whois files from here cctld_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

            
{
    "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 newly|dropped|expired",
    "path": "/v1.0/2021-01-12/fileType=&apikey=6363653972fe4df89638c45db1acf016"
}
            
            
            
{
    "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/2021-01-12/fileType=newly&apikey=6363653972fe4df89638c45db1acf016"
}
            
            
            
{
    "timestamp": "2021-02-02T11:35:17.475+00:00",
    "status": 400,
    "error": "Api Access Exception",
    "message": "Please Buy Domainer package. [For Technical Support: support@whoisfreaks.com]",
    "path": "/v1.0/2021-01-12/fileType=newly&apikey=6363653972fe4df89638c45db1acf016"
}
            
            
            
{
    "timestamp": "2021-02-02T11:35:17.475+00:00",
    "status": 400,
    "error": "Api Access Exception",
    "message": "Your Domainer package plan is inactive. [For Technical Support: support@whoisfreaks.com]",
    "path": "/v1.0/2021-01-12/fileType=newly&apikey=6363653972fe4df89638c45db1acf016"
}
            
            
            
{
    "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/2021-01-12/fileType=newly&apikey=6363653972fe4df89638c45db1acf016"
}
            
            
            
{
    "timestamp": "2021-02-02T11:35:17.475+00:00",
    "status": 400,
    "error": "Api Access Exception",
    "message": "You have exceeded the download limit of 10000 [For Technical Support: support@whoisfreaks.com]",
    "path": "/v1.0/2021-01-12/fileType=newly&apikey=6363653972fe4df89638c45db1acf016"
}
            
            

Code Snippet

Wide-variety of industries against any domain name, such as domain registration details, domain IP address, domain owner email address and many more such as domain registration details.


    curl --location --request GET 'https://files.whoisfreaks.com/v1.0/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&fileType=newly'



var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://files.whoisfreaks.com/v1.0/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&fileType=newly',
  '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/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&fileType=newly")
  .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/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&fileType=newly", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))




     'https://files.whoisfreaks.com/v1.0/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&fileType=newly',
  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/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&fileType=newly")

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/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&fileType=newly", 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/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&fileType=newly");
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/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&fileType=newly"
  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/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&fileType=newly");
  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/2021-01-02?apikey=6363653972fe4df89638c45db1acf016&fileType=newly")!,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 information do Newly Registered domains whois files provide?

Our Crawlers find out newly registered domains or updated information of domains and build whois file of these domains



How many TLDs Whois are included in Newly Registered domains whois files?

You can check here current supported TLD's List



Can I Download file manually?

Yes, you can download any type of whois files after sign in from our billing.



At what time do you generate your newly registered domains whois files?

02:00 UTC time. You can compare your time zone with UTC here



How often are your country-code (ccTLD) domains whois files generated?

1 time per 2 months.



Can I check programmatically any type(newly|cctld|expired|dropped) of generated domains whois file status?

Yes, with our API endpoint https://files.whoisfreaks.com/v1.0/status you can check details of whois files.



Why don't you provide daily updates for country-code (ccTLD) domains whois file?

Country-code zones registrars do not publish the list of newly registered domain names. That means, no one can provide complete lists of country-code domains. Nevertheless, we have crawler which crawls hundreds of millions of known websites. After getting terabytes of data, we scan this content and then collect and sort lists of found country-code domains.



Do you have notification service after generating whois files?

Yes, we inform you via an email when any type(newly|cctld|expired|dropped) of file is generated.