dropdown

Overview

  • Newly Registered Domain's Whois API
    Newly Registered Domains list API helps you to download newly domainer files. You can download newly registered domains database files through our billing dashboard manually or through API.

Authorization

You can make authorized requests to our API by passing API key as a query parameter. To get your API key, login to our billing dashboard and get your API key! If your API key has been compromised, you can change it by clicking on reset button in billing dashboard.

Newly Registered Domain's Whois API

API

GET https://files.whoisfreaks.com/v2/2021-01-12?apiKey=API_KEY&fileType=gtld
Copied
GET https://files.whoisfreaks.com/v2/2021-01-12?apiKey=API_KEY&fileType=cctlddaily
Copied
GET https://files.whoisfreaks.com/v2/2021-01-12?apiKey=API_KEY&fileType=cctldmonthly
Copied

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 fileType for Domainer subscription like gtld|cctlddaily|cctldmonthly.


Code Snippets


curl --location --request GET 'https://files.whoisfreaks.com/v2/2021-01-02?apiKey=API_KEY&fileType=gtld'



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




<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://files.whoisfreaks.com/v2/2021-01-02?apiKey=API_KEY&fileType=gtld',
  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/2021-01-02?apiKey=API_KEY&fileType=gtld")

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/2021-01-02?apiKey=API_KEY&fileType=gtld", 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/2021-01-02?apiKey=API_KEY&fileType=gtld");
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/2021-01-02?apiKey=API_KEY&fileType=gtld"
  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/2021-01-02?apiKey=API_KEY&fileType=gtld");
  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/2021-01-02?apiKey=API_KEY&fileType=gtld")!,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()



Response

Download sample of newly registered whois files from here gtld_sample.csv.gz
Download sample of newly registered whois files from here cctld_sample.csv.gz

Downloaded File is of following 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,reseller_name,reseller_email,reseller_phone
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

Below mentioned possible type of error and desc.

HTTP Code
Error Message
400 Please pass apiKey param value 400 Please pass date param value (date format:yyyy-MM-dd) 400 Please pass fileType param value 404 fileType is not found. Please visit documentation 401 Api record not found. [For Technical Support: support@whoisfreaks.com] 401 Provided API key is inactive. [For Technical Support: support@whoisfreaks.com] 401 Please Buy Domainer package. [For Technical Support: support@whoisfreaks.com] 401 Your Domainer package plan is inactive. [For Technical Support: support@whoisfreaks.com] 413 Please upgrade your plans.This Plan does not have to access to download file. [For Technical Support: support@whoisfreaks.com] 404 File is not available of this date. Please contact at support@whoisfreaks.com 401 You cannot download file, as requested file for date(2022-09-10) is older than your subscription start date(2022-09-15). [For Technical Support: support@whoisfreaks.com] 401 You have exceeded the download limit of 20000 [For Technical Support: support@whoisfreaks.com]

Whois Files Status API

API

GET https://files.whoisfreaks.com/v2/status
Copied

Response

                    
{
    "expired": {
        "lastUpdate": "2022-11-11",
        "availableFrom": "2022-04-01"
    },
    "gtld": {
        "lastUpdate": "2022-10-12",
        "availableFrom": "2022-04-01"
    },
    "dropped": {
        "lastUpdate": "2022-10-12",
        "availableFrom": "2022-04-01"
    },
    "database_updates": [
        {
            "dailyBaseAvailable_From": "2022-06-22",
            "dailyBaseLastUpdate": "2022-10-12"
        },
        {
            "weeklyBaseAvailable_From": "2022-07-04",
            "weeklyBaseLastUpdate": "2022-10-10"
        },
        {
            "monthlyBaseAvailable_From": "2022-07-01",
            "monthlyBaseLastUpdate": "2022-10-01"
        }
    ],
    "cctld": [
        {
            "monthlyBaseAvailableFrom": "2022-06-08",
            "monthlyBaseLastUpdate": "2022-09-20"
        },
        {
            "dailyBaseLastUpdate": "2022-10-12",
            "dailyBaseAvailableFrom": "2022-04-01"
        }
    ]
}
                    
            


FAQs

What Are Newly Registered Domains And their Use?

Newly registered domains are domain names that were just registered, are brand new and have never been registered by any previous owners. By our broad and upto-date database you can get the list of recently registered domains and their complete WHOIS information daily.



Which TLDs Whois are included in Daily Registered domains whois files?

Visit our 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 recently registered domains whois files?

Newly registered files are of three types which are ready at different times for download.
1. cctld daily newly files(23:30 UTC everyday)
2. gtld newly files (12:00 UTC everyday)
3. cctld monthly files (Once in a month)
We also notify you via email when each file is ready to download. Further, you can check file status through API



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

Our country-code (ccTLD) domains whois files are updated at 23:30 UTC on daily basis and 1 time after 3 months on monthly basis. Visit update schedule TLDs list distributed according to their update perios.



Can I check programmatically any file type of generated domains whois file status?

Yes, you can check details of whois files through Domainer Files status API



Why don't you provide daily updates for some 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. You can check update schedule TLDs here



Do you have notification service after generating whois files?

Yes, we inform you via an email when any file type is generated.



Is there any download limit to download files?

Yes, there is a limit to download whois files. but it can be extended. Download limit will be shown in billing dashboard with usage.