dropdown

Comprehensive Whois Database Download Guide

Overview

Download WHOIS Database

We offer a comprehensive Whois database that can be downloaded in compressed CSV format. Choose from a variety of options including country-wise, TLD-wise, and registrar-wise databases. Upon purchase, we will email you a link to download the database file.

WHOIS Database Updates Subscription

Stay ahead of the competition and make informed decisions about domains with WhoisFreaks' regularly updated Whois Database. Our Database Update Subscription offers daily, weekly, or monthly updates to ensure you have the most up-to-date information available. After subscribing, easily download database files via our API or billing dashboard. Our update file contains a change log of updated domains, and includes newly added, dropped, and updated domains data in one compressed (.zip) file for easy access.


Download WHOIS Database


Response

sample part Downloaded file is of following format.

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,reseller_name,reseller_email,reseller_phone
1,"kemlid.co.uk","2023-07-01 23:17:25","2023-06-28","2023-06-28","2024-06-28","","Namesco Limited [Tag = NAMESCO]","","https://www.names.co.uk","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","ns2.phase8.net","ns0.phase8.net","ns1.phase8.net","","","","","","","",""
2,"nightver.se","2023-07-01 23:17:26","2023-06-30","2023-06-30","2024-06-30","","","","1 Api GmbH","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","ns20.domaincontrol.com","ns19.domaincontrol.com","","","ok","","","","","",""
3,"xn----8sbfkbqad3csacdmece1v.xn--p1ai","2023-07-01 23:17:26","2023-06-30","","2024-06-30","","BEGET-RF","","whois.beget.com","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","ns2.beget.pro.","ns1.beget.pro.","ns2.beget.com.","ns1.beget.com.","","","","","","",""
4,"eveshamnationals.co.uk","2023-07-01 23:17:26","2023-06-28","2023-06-28","2024-06-28","","Ionos SE [Tag = 1AND1]","","https://ionos.com","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","ns1019.ui-dns.org","ns1020.ui-dns.de","ns1085.ui-dns.com","ns1099.ui-dns.biz","","","","","","",""
        
        

WHOIS Database Updates Subscription


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:

GET https://files.whoisfreaks.com/v3.1/download/dbupdate/daily?apiKey=API_KEY&date=2023-10-12 Copy
Copied
GET https://files.whoisfreaks.com/v3.1/download/dbupdate/weekly?apiKey=API_KEY&date=2023-10-12 Copy
Copied
GET https://files.whoisfreaks.com/v3.1/download/dbupdate/monthly?apiKey=API_KEY&date=2023-10-12 Copy
Copied


Input parameters: required

apiKey Get your API key from our billing dashboard

Input parameters: optional

date Date parameter is optional. The most recent file will be downloaded if the link doesn't have a date specified. If you choose to provide a date, use the format (yyyy-MM-dd).


Code Snippets


curl --location --request GET 'https://files.whoisfreaks.com/v3.1/download/dbupdate/daily?apiKey=API_KEY&date=2023-10-12'
Copy


var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://files.whoisfreaks.com/v3.1/download/dbupdate/daily?apiKey=API_KEY&date=2023-10-12',
  'headers': {
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});


Copy


OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://files.whoisfreaks.com/v3.1/download/dbupdate/daily?apiKey=API_KEY&date=2023-10-12")
  .method("GET", null)
  .build();
Response response = client.newCall(request).execute();

Copy


import http.client
conn = http.client.HTTPSConnection("files.whoisfreaks.com")
payload = ''
headers = {}
conn.request("GET", "/v3.1/download?apiKey=API_KEY&date=2023-08-24&fileType=dailydbupdate", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Copy


<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL =>
    'https://files.whoisfreaks.com/v3.1/download/dbupdate/daily?apiKey=API_KEY&date=2023-10-12',
  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;

Copy


require "uri"
require "net/http"

url = URI("https://files.whoisfreaks.com/v3.1/download/dbupdate/daily?apiKey=API_KEY&date=2023-10-12")

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




Copy


var requestOptions = {
    method: 'GET',
    redirect: 'follow'
  };

  fetch("https://files.whoisfreaks.com/v3.1/download/dbupdate/daily?apiKey=API_KEY&date=2023-10-12", requestOptions)
    .then(response => response.text())
    .then(result => console.log(result))
    .catch(error => console.log('error', error));

Copy


var client = new RestClient("https://files.whoisfreaks.com/v3.1/download/dbupdate/daily?apiKey=API_KEY&date=2023-10-12");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

Copy


package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://files.whoisfreaks.com/v3.1/download/dbupdate/daily?apiKey=API_KEY&date=2023-10-12"
  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))
}

Copy


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/v3.1/download/dbupdate/daily?apiKey=API_KEY&date=2023-10-12");
  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);


Copy


import Foundation
#if canImport(FoundationNetworking)
import FoundationNetworking
#endif

var semaphore = DispatchSemaphore (value: 0)

var request = URLRequest(url: URL(string: "https://files.whoisfreaks.com/v3.1/download/dbupdate/daily?apiKey=API_KEY&date=2023-10-12")!,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()



Copy

Response

Download sample of database updates whois files from here dailydbupdate_sample.zip

            
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
6,"energyroom.co.uk","2023-07-01 23:17:26","2023-06-28","2023-06-28","2024-06-28","","123-Reg Limited t/a 123-reg [Tag = 123-REG]","","https://www.123-reg.co.uk","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","ns38.domaincontrol.com","ns37.domaincontrol.com","","","","","","","","",""
7,"opros-gos-us.ru","2023-07-01 23:17:26","2023-06-30","","2024-07-31","","","","","","","","","","","","","","","","Private Person","","","","","","","","","","","Private Person","","","","","","","","","","","","","","","","","","","","","","ns2.timeweb.ru.","ns3.timeweb.org.","ns1.timeweb.ru.","ns4.timeweb.org.","","","","","","",""
8,"footballshirts.me.uk","2023-07-01 23:17:26","2023-06-29","2023-06-29","2024-06-29","","Porkbun LLC [Tag = PORKBUN]","","https://porkbun.com","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","fortaleza.ns.porkbun.com","maceio.ns.porkbun.com","curitiba.ns.porkbun.com","salvador.ns.porkbun.com","","","","","","",""
9,"andrescolombia.me.uk","2023-07-01 23:17:26","2023-06-28","2023-06-28","2024-06-28","","Gandi [Tag = GANDI]","","https://www.gandi.net","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","","ns-1198.awsdns-21.org","ns-1579.awsdns-05.co.uk 205.251.198.43","ns-200.awsdns-25.com","ns-736.awsdns-28.net","","","","","","",""
            
            

HTTP Error Codes

Below mentioned possible type of error and desc.

HTTP Code
Error Message
400 Please pass apiKey param value 400 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 database subscription. [For Technical Support: support@whoisfreaks.com] 401 Your Database subscription 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/v3.1/status Copy
Copied

Response

                    
{
    "expired": {
        "lastUpdate": "2023-08-24",
        "availableFrom": "2023-07-01"
    },
    "gtld": {
        "lastUpdate": "2023-08-24",
        "availableFrom": "2023-07-01"
    },
    "dropped": {
        "lastUpdate": "2023-08-24",
        "availableFrom": "2023-07-01"
    },
    "database_updates": [
        {
            "dailyBaseAvailable_From": "2023-07-01",
            "dailyBaseLastUpdate": "2023-08-24"
        },
        {
            "weeklyBaseAvailable_From": "2023-06-05",
            "weeklyBaseLastUpdate": "2023-08-21"
        },
        {
            "monthlyBaseAvailable_From": "2023-03-01",
            "monthlyBaseLastUpdate": "2023-08-01"
        }
    ],
    "cctld": {
        "lastUpdate": "2023-08-24",
        "availableFrom": "2023-08-09"
}
                    
                    

FAQs

From which time period does the Whois Database have records?

The Whois database has been accumulating data since 1986, providing a vast repository of domain information that continues to expand with each passing day.



When can I expect updates for the Whois database if I have a daily, weekly, or monthly subscription?

  • Daily Database update Subscription file is updated daily on 2:15 AM UTC
  • Weekly Database update Subscription file is updated every Monday at 1:00 AM UTC
  • Monthly Database update Subscription file is updated on 1st of every month on 2:00 AM UTC You can check