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.gzDownload 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.