The Live DNS API allows real-time lookups of DNS resource records such as A, AAAA, MX, NS, CNAME, SOA, TXT, and SPF, and also supports reverse IP lookups using PTR records by specifying the ipAddress parameter. The API uses the type parameter to look up specific DNS records, such as NS, or multiple records separated by commas (e.g., mx,ns). To retrieve all record types, simply set the type parameter to all.
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.
Important References
- For details on request limits and handling rate limiting, refer here
- For a complete overview of API credit consumption and usage, refer here
Required
- apiKey
Get your API key from our billing dashboard.
- domainName
The domainName for requested dns data.
- ipAddress
The ipAddress for requested DNS's PTR record.
OR
You can pass both domainName & ipAddress. At least one is required.
- type
Type of DNS record like all/comma separated list (A, AAAA, TXT, NS, MX, SOA, SPF)
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
