Datafeed files | Specifications | Website Contacts & Categorization Database | WhoisXML API

Datafeed files

The datasets comes in two forms

The entire website contacts and categorization database is updated every 2-3 days.

  • "Domain names only" — a dataset which contains only domain names according to selected parameters. These files are named in format:
    "contacts_db.%DATE%.%DATASET_ID%.categories.csv.gz"
    "contacts_db.%DATE%.%DATASET_ID%.categories.jsonl.gz", e.g "contacts_db.2019-05-16.sdxXTRdWCx.categories.csv.gz"


  • "Domain names and contact information" — a dataset which contains domain names and related contact information according to selected parameters. These files are named in format:
    "contacts_db.%DATE%.%DATASET_ID%.contacts.csv.gz"
    "contacts_db.%DATE%.%DATASET_ID%.contacts.jsonl.gz", e.g "contacts_db.2019-05-16.RtxtTKdWMx.contacts.csv.gz"

Downloading from the site

  • 1. You must be logged in.
  • 2. Go to the My orders page.
  • 3. Find the desired dataset, make sure that the configuring status is "Completed", select the required dataset format.

Please note that if you use Safari browser, then after clicking on the dataset link you will be asked to open it in Mac OS Finder. In this case, use the username and password from the instruction below ("Downloading via FTP/FTPS").

Downloading via FTP

  • Host: datafeeds.whoisxmlapi.com
  • Port: 21210
  • Username: 'user'
  • Password: equal to your personal API Key which you can obtain from the My Products page.
  • Base path: ftp://datafeeds.whoisxmlapi.com:21210
  • Folder: Website_Contacts_and_Categorisation_Database

Downloading via FTPS

Read more about the FTPS connection: https://en.wikipedia.org/wiki/FTPS.

Our FTP server supports explicit FTP over TLS encryption. You may configure your FTP client to use explicit FTP over TLS encryption for secure communications.

Our FTPS server is accessed using the same paths and API keys as a regular FTP server, the instructions for which are described above. To connect via FTPS, select the "Require explicit FTP over TLS" encryption option in your FTP client, if it supports it. FileZilla configuration example:

explicit FTP over TLS encryption

Configure your dataset