pricing background

Newly Registered Domains Documentation

With Whois

ASK AI
Download WHOIS data for newly registered domains via /gtld (gTLDs) or /cctld (ccTLDs) endpoints, using the date parameter to specify the file; version v3.3 also provides extra registrar and registrant IDs along with eligibility details for .au ccTLDs.

Tip: Not sure which date to use? The Database Files Status endpoint returns the last_update and available_from dates for newly registered domain feeds (gTLD, ccTLD, cleaned, and DNS variants), so you can verify freshness before triggering a download.

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.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
  • whois
    Whois is a required and a boolean value parameter. It will retrieve a CSV file containing complete WHOIS information of gTLDs and ccTLDs.
Optional
  • date

    Date parameter is optional. The most recent data will be fetched if the link doesn't have a date specified. If you choose to provide a date, use the format (yyyy-MM-dd). To find out the latest available file date and the earliest snapshot still hosted, use the Database Files Status endpoint.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

File Extension: The API returns the result as a gzip-compressed CSV file (.csv.gz) for efficient download and storage. To extract the file, follow this tutorial.

Response

Loading response...

Fields Description

Fields
Details
Data Type
Example
num
Row number / record index in the dataset
number
1
domain_name
Registered domain name
string
airport-jobs-28863.bond
query_time
Timestamp when WHOIS data was retrieved
string (YYYY-MM-DD HH:mm:ss)
2023-10-12 09:19:52
create_date
Domain creation date
string (YYYY-MM-DD)
2023-10-11
update_date
Last update date of domain record
string (YYYY-MM-DD)
2023-10-11
expiry_date
Domain expiration date
string (YYYY-MM-DD)
2024-10-11
domain_registrar
Registrar information block
id
Registrar ID
string
1345
name
Registrar name
string
Key-Systems LLC
whois_server
Registrar WHOIS server
string
whois.rrpproxy.net
url
Registrar website URL
string
http://www.key-systems.net
registrant
Registrant contact information
name
Registrant name
string
Privacy Protect, LLC
company
Registrant company
string
Super Privacy Service LTD
address
Street address
string
city
City
string
state
State/region
string
MA
zip
Postal code
string
country_code
Country code
string
US
country
Country name
string
United States
email
Contact email
string
Please query the RDDS service of the Registrar of Record identified in this output
phone
Contact phone
string
fax
Contact fax
string
administrative
Administrative contact information
name
Admin contact name
string
Please query the RDDS service of the Registrar of Record identified in this output
company
Admin company
string
address
Admin address
string
city
Admin city
string
state
Admin state
string
zip
Admin zip code
string
country_code
Admin country code
string
country
Admin country
string
email
Admin email
string
Please query the RDDS service of the Registrar of Record identified in this output
phone
Admin phone
string
fax
Admin fax
string
technical
Technical contact information
name
Technical contact name
string
Please query the RDDS service of the Registrar of Record identified in this output
company
Technical company
string
address
Technical address
string
city
Technical city
string
state
Technical state
string
zip
Technical zip code
string
country_code
Technical country code
string
country
Technical country
string
email
Technical email
string
Please query the RDDS service of the Registrar of Record identified in this output
phone
Technical phone
string
fax
Technical fax
string
billing
Billing contact information
name
Billing contact name
string
company
Billing company
string
address
Billing address
string
city
Billing city
string
state
Billing state
string
zip
Billing zip code
string
country_code
Billing country code
string
country
Billing country
string
email
Billing email
string
phone
Billing phone
string
fax
Billing fax
string
name_servers
List of DNS name servers
array
NS1.NIC53.NET, NS2.NIC53.DE
domain_status
List of domain status flags
array
clientTransferProhibited, addPeriod
reseller
Reseller information (if available)
name
Reseller name
string
email
Reseller email
string
phone
Reseller phone
string

With Cleaned Whois

Download cleaned WHOIS data for newly registered domains, without masked details such as Redacted for Privacy or Contact Privacy via /gtld (gTLDs) or /cctld (ccTLDs) endpoints. Version v3.3 adds extra registrar and registrant IDs for connected insights, along with eligibility information for .au ccTLDs.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
Optional
  • date

    Date parameter is optional. The most recent data will be fetched if the link doesn't have a date specified. If you choose to provide a date, use the format (yyyy-MM-dd). To find out the latest available file date and the earliest snapshot still hosted, use the Database Files Status endpoint.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

File Extension: The API returns the result as a gzip-compressed CSV file (.csv.gz) for efficient download and storage. To extract the file, follow this tutorial.

Response

Loading response...

Fields Description

Fields
Details
Data Type
Example
with_cleaned_whois_response
This list includes fields similar to those returned in a With Whois
array

Without Whois (CSV)

Download a list of newly registered domains using /gtld for gTLDs, /cctld for ccTLDs, or both combined by specifying the date parameter. Results are available in CSV or JSON format, and you can use the tlds parameter to filter for specific TLDs.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
  • whois
    Whois is a required and a boolean value parameter. It will retrieve a CSV file containing newly registered domains for gTLDs and ccTLDs.
Optional
  • date

    Date parameter is optional. The most recent data will be fetched if the link doesn't have a date specified. If you choose to provide a date, use the format (yyyy-MM-dd). To find out the latest available file date and the earliest snapshot still hosted, use the Database Files Status endpoint.

  • tlds
    TLDs parameter is optional. All domains will be fetched if you don't specify any tld.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

File Extension: The API returns the result as a gzip-compressed CSV file (.csv.gz) for efficient download and storage. To extract the file, follow this tutorial.

Response

Loading response...

Without Whois (JSON)

Download a list of newly registered domains using /gtld for gTLDs, /cctld for ccTLDs, or both combined by specifying the date parameter. Results are available in CSV or JSON format, and you can use the tlds parameter to filter for specific TLDs.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
Optional
  • date

    Date parameter is optional. The most recent data will be fetched if the link doesn't have a date specified. If you choose to provide a date, use the format (yyyy-MM-dd). To find out the latest available file date and the earliest snapshot still hosted, use the Database Files Status endpoint.

  • tlds
    TLDs parameter is optional. All domains will be fetched if you don't specify any tld.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

With DNS

Download newly registered domains along with their DNS records using the /dns endpoint.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
Optional
  • date

    Date parameter is optional. The most recent data will be fetched if the link doesn't have a date specified. If you choose to provide a date, use the format (yyyy-MM-dd). To find out the latest available file date and the earliest snapshot still hosted, use the Database Files Status endpoint.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

File Extension: The API returns the result as a gzip-compressed JSONL file (.jsonl.gz) for efficient download and storage. To extract the file, follow this tutorial.

Response

Loading response...

Fields Description

Fields
Details
Data Type
Example
queryTime
Timestamp when DNS query was executed
string (YYYY-MM-DD HH:mm:ss)
2024-10-03 13:24:09
domainName
Domain name being queried
string
whoisfreaks.com
ipAddress
IP address associated with the domain lookup
string
8.8.8.8
dnsTypes
Count of DNS record types available for the domain
string
A: 1, MX: 15, NS: 2, TXT: 16,
dnsRecords
List of DNS records for the domain across all types
array
name
Fully qualified domain or reverse lookup name
string
whoisfreaks.com
type
Numeric DNS record type identifier
number
1
dnsType
Human-readable DNS record type
string
A
ttl
Time to live in seconds
number
3600
rawText
Raw DNS response string
string
whoisfreaks.com. 3600 IN A 172.233.38.245
rRsetType
Numeric DNS record type identifier for the RRset
number
1
a_record_columns
Fields specific to A records
address
IPv4 address for A record
string
172.233.38.245
aaaa_record_columns
Fields specific to AAAA records
address
IPv6 address for AAAA record
string
2606:4700:3033::6815:1234
cname_record_columns
Fields specific to CNAME records
singleName
Canonical target hostname for CNAME record
string
whoisfreaks.com.
mx_record_columns
Fields specific to MX records
target
Target hostname for MX record
string
mx.zoho.com
priority
Priority for MX records
number
10
ns_record_columns
Fields specific to NS records
singleName
Name server hostname for NS record
string
dns7.cloudns.net.
soa_record_columns
Fields specific to SOA records
admin
SOA administrative contact
string
support.cloudns.net
host
Primary DNS server in SOA
string
dns3.cloudns.net
serial
SOA version serial number
number
2024091202
refresh
SOA refresh interval
number
7200
retry
SOA retry interval
number
1800
expire
SOA expiry time
number
1209600
minimum
Minimum TTL for negative caching
number
3600
spf_record_columns
Fields specific to SPF records
strings
SPF record value
string
v=spf1 mx include:spf.mtasv.net -all
txt_record_columns
Fields specific to TXT records
strings
TXT record value
string
paddle-verification=ba8cd073