Specifications

The datasets comes in two forms

  • "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").

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.
  • Folder: Website_Contacts_and_Categorisation_Database

Files structure and output fields’ descriptions

Note that CSV files are multi-line. This means that the first line contains domainName and all of the following lines contain contact data until a new domain name occurs.

"Domain names only" form

Field name Type Description
domainName string Website's URL.
countryCode string Website's country code.
categories string[] The list of possible website's categories. Every website may belong to up to 3 categories.

Categories available:
  • Arts and Entertainment
  • Autos and Vehicles
  • Beauty and Fitness
  • Books and Literature
  • Business and Industry
  • Career and Education
  • Computer and electronics
  • Finance
  • Food and Drink
  • Gambling
  • Games
  • Health
  • Home and Garden
  • Internet and Telecom
  • Law and Government
  • News and Media
  • People and Society
  • Pets and Animals
  • Recreation and Hobbies
  • Reference
  • Science
  • Shopping
  • Sports
  • Travel
  • Adult

"Domain names and contact information" form

Field name Type Description
domainName string Website's URL.
meta.title string Website title provided in the title tag.
meta.description string Website description defined in the description meta tag on the main page.
socialLinks.facebook string Facebook URL found on the main website's page.
socialLinks.instagram string Instagram URL found on the main website's page.
socialLinks.twitter string Twitter URL found on the main website's page.
socialLinks.linkedIn string LinkedIn URL found on the main website's page.
emails[0].description string Email address description. (e.g. department, person, etc.).
emails[0].email string Email address itself.
phones[0].description string Phone number description (e.g. department, person, etc.).
phones[0].phoneNumber string Phone number itself.
phones[0].callHours string Hours during which the phone number is available. (e.g. 11 am to 4 pm PST).
postalAddresses string[] The list of postal addresses. Every address is presented in the format of: street, city, state, zip code, country. Some positions may be missing.
companyNames string[] The list of possible company names.
countryCode string Website's country code.
categories string[] The list of possible website's categories. Every website may belong to up to 3 categories.

Categories available:
  • Arts and Entertainment
  • Autos and Vehicles
  • Beauty and Fitness
  • Books and Literature
  • Business and Industry
  • Career and Education
  • Computer and electronics
  • Finance
  • Food and Drink
  • Gambling
  • Games
  • Health
  • Home and Garden
  • Internet and Telecom
  • Law and Government
  • News and Media
  • People and Society
  • Pets and Animals
  • Recreation and Hobbies
  • Reference
  • Science
  • Shopping
  • Sports
  • Travel
  • Adult

Configure your dataset

Have questions?

We work hard to improve our services for you. As part of that, we welcome your feedback, questions and suggestions. Please let us know your thoughts and feelings, and any way in which you think we can improve our product.

For a quick response, please select the request type that best suits your needs. For more info regarding the request types, see the Contact us page.

By submitting, you agree to the Terms of Service and Privacy Policy.

Or shoot us an email to