pricing background

DNS Database Documentation

DNS Database

ASK AI
Download daily, weekly, or monthly DNS database updates by providing the date parameter to the /daily, /weekly, or /monthly endpoints.

Tip: Not sure which date to use? The Database Files Status endpoint returns the last_update and available_from dates for daily, weekly, and monthly DNS database snapshots, so you can verify freshness before triggering a download.

Choosing a Cadence

Daily
Premium
DNS records for every domain and subdomain whose DNS changed during the previous day.
Weekly
Most Popular
Every daily file from the previous week, combined into a single download.
Monthly
Base Unit
Every daily file from the previous month, combined into a single 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.
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...
Full DNS database updates
A full update plan covers all eight record types in one subscription. Each download returns a single archive named after the snapshot date, holding one CSV per record type.
DNS database update archive illustration
Files inside the archive
a_records.csv
aaaa_records.csv
cname_records.csv
mx_records.csv
ns_records.csv
soa_records.csv
spf_records.csv
txt_records.csv
Individual record type plans
You can subscribe to a single record type, or to several types separately, instead of taking the whole database. Each subscribed type is delivered as its own archive containing exactly one CSV.
MX only subscription archive illustration
Example, an MX only subscription
2025-09-23_mx_records.zip
mx_records.csv

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

Response

Loading response...

Archive and CSV conventions

COMPRESSIONZIP (deflate)
DELIMITERCOMMA
FILE FORMATCSV
HEADER ROWROW 1
ENCODINGUTF-8
EMPTY VALUESN/A
  • Fields containing commas, quotes, or newlines are wrapped in double quotes.
  • Download requests redirect to a signed URL, so follow redirects with curl --location.
  • Archive names use the snapshot date, not the download date.

Fields Description

Fields
Details
Data Type
Example
a_record_columns
Column layout returned when the dnsType is A.
num
Internal database ID for this specific A record row.
number
3143424
domain_name
The hostname whose traffic is routed to the listed IPv4 address.
string
interfaithdialog.com
date_created
The date this A mapping first appeared in the index.
string (YYYY-MM-DD)
2024-09-18
last_seen
The date this A mapping was last confirmed resolvable.
string (YYYY-MM-DD)
2024-09-18
address
The IPv4 address the hostname currently resolves to.
string
172.233.38.245
ttl
Seconds a resolver may cache this IPv4 mapping before re-checking it.
number
3600
aaaa_record_columns
Column layout returned when the dnsType is AAAA.
num
Internal database ID for this specific AAAA record row.
number
393408
domain_name
The hostname whose traffic is routed to the listed IPv6 address.
string
sovilok.com
date_created
The date this AAAA mapping first appeared in the index.
string (YYYY-MM-DD)
2024-09-18
last_seen
The date this AAAA mapping was last confirmed resolvable.
string (YYYY-MM-DD)
2024-09-18
address
The IPv6 address the hostname currently resolves to.
string
2606:4700:3033::6815:1234
ttl
Seconds a resolver may cache this IPv6 mapping before re-checking it.
number
60
cname_record_columns
Column layout returned when the dnsType is CNAME.
num
Internal database ID for this specific CNAME record row.
number
493457
domain_name
The alias hostname that forwards lookups to another domain.
string
americanbitch.com
date_created
The date this alias forwarding rule first appeared in the index.
string (YYYY-MM-DD)
2024-09-18
last_seen
The date this alias forwarding rule was last confirmed still active.
string (YYYY-MM-DD)
2024-09-18
singleName
The canonical hostname the alias ultimately points to.
string
whoisfreaks.com.
ttl
Seconds a resolver may cache this alias forwarding before re-checking it.
number
10800
mx_record_columns
Column layout returned when the dnsType is MX.
num
Internal database ID for this specific MX record row.
number
593434
domain_name
The domain whose incoming email is delivered via the listed mail server.
string
cheachea.com
date_created
The date this mail-routing rule first appeared in the index.
string (YYYY-MM-DD)
2024-09-18
last_seen
The date this mail-routing rule was last confirmed still active.
string (YYYY-MM-DD)
2024-09-18
target
The hostname of the mail server that accepts messages on the domain's behalf.
string
mx.zoho.com
priority
Delivery preference number lower values are attempted before higher ones.
number
10
ttl
Seconds a resolver may cache this mail-routing entry before re-checking it.
number
21600
ns_record_columns
Column layout returned when the dnsType is NS.
num
Internal database ID for this specific NS record row.
number
2066580
domain_name
The zone that has delegated authority to the listed name server.
string
chinatouring.com
date_created
The date this delegation first appeared in the index.
string (YYYY-MM-DD)
2024-09-18
last_seen
The date this delegation was last confirmed still in place.
string (YYYY-MM-DD)
2024-09-18
singleName
The hostname of the server delegated to answer queries for the zone.
string
dns7.cloudns.net.
ttl
Seconds a resolver may cache this delegation before re-checking it.
number
3600
soa_record_columns
Column layout returned when the dnsType is SOA.
num
Internal database ID for this specific SOA record row.
number
829153
domain_name
The zone that this SOA entry administers.
string
americankilts.com
date_created
The date this SOA entry first appeared in the index.
string (YYYY-MM-DD)
2024-09-18
last_seen
The date this SOA entry was last confirmed current.
string (YYYY-MM-DD)
2024-09-18
admin
Contact address for the zone's administrator, written in DNS-name form instead of an @ symbol.
string
support.cloudns.net
host
The primary server holding the master copy of the zone.
string
dns3.cloudns.net
serial
A version counter that increases each time the zone file is edited.
number
2024091202
refresh
How often, in seconds, secondary servers are told to pull updates from the primary.
number
7200
retry
How long, in seconds, a secondary waits before retrying after a failed refresh attempt.
number
1800
expire
How long, in seconds, a secondary may keep answering with stale data before giving up entirely.
number
1209600
minimum
TTL applied when caching a 'record does not exist' response for the zone.
number
3600
spf_record_columns
Column layout returned when the dnsType is SPF.
num
Internal database ID for this specific SPF record row.
number
454812
domain_name
The domain whose approved outbound mail senders are declared in this policy.
string
cheachea.com
date_created
The date this sender policy first appeared in the index.
string (YYYY-MM-DD)
2024-09-18
last_seen
The date this sender policy was last confirmed still published.
string (YYYY-MM-DD)
2024-09-18
strings
The raw SPF mechanism string listing authorized senders and the enforcement rule.
string
v=spf1 mx include:spf.mtasv.net -all
ttl
Seconds a resolver may cache this sender policy before re-checking it.
number
3600
txt_record_columns
Column layout returned when the dnsType is TXT.
num
Internal database ID for this specific TXT record row.
number
195545
domain_name
The hostname under which this text entry is published.
string
pointe.homes
date_created
The date this text entry first appeared in the index.
string (YYYY-MM-DD)
2024-09-18
last_seen
The date this text entry was last confirmed still published.
string (YYYY-MM-DD)
2024-09-18
strings
The verification token or descriptive text stored in the record.
string
paddle-verification=ba8cd073
ttl
Seconds a resolver may cache this text entry before re-checking it.
number
1800