Live DNS Lookup API

The Live DNS Checker API offers real-time access to DNS records, enabling swift and accurate resolution of domain names to IP addresses and vice versa. This powerful tool is essential for network administrators and developers, providing instant network diagnostics, verifying DNS configurations, and troubleshooting connectivity issues. By using the Live DNS API, users can ensure the correctness and availability of their DNS records, streamlining the process of maintaining a reliable and resilient online presence. Whether it's for confirming recent DNS changes, detecting misconfigurations, or ensuring uptime, this API is indispensable for anyone responsible for the integrity and performance of their network infrastructure.

Historical DNS Lookup API

With the Historical DNS Lookup API, you gain a valuable resource to delve into the past and track changes in domain configurations over time. Researchers, cyber-security experts, and businesses can utilise this API to explore domain history, ownership changes, and record modifications. By accessing historical DNS data, organizations can conduct in-depth analyses, identify security threats, and make informed decisions based on the evolution of their domain's infrastructure.

Reverse DNS API

Our Reverse DNS Lookup API provides an extensive range of DNS records, including A, AAAA, SOA, MX, NS, CNAME, TXT, and SPF. With this comprehensive API, effortlessly retrieve associated domain names for various record types and enable yourself to gain valuable insights into domain configurations and ownership. Utilise our Reverse DNS API for email verification, spam prevention, and robust network security. Uncover the true potential of reverse DNS lookups to optimise user experiences, enhance cyber-security measures, and ensure the authenticity of incoming emails.

Bulk DNS Lookup API

The Bulk DNS Lookup Tool allows you to efficiently query multiple domains in a single request, retrieving the latest DNS records such as A, AAAA, MX, NS, CNAME, and more. This tool streamlines the process by enabling you to query up to 100 domain names at a time, providing results in JSON or XML format for easy integration and analysis. Whether you're managing a large number of domains or need to verify email addresses, the Bulk DNS Lookup Tool saves time and offers valuable insights into domain configurations and ownership. This capability is highly beneficial for network administrators, domain registrars, and business operators. It enables them to manage multiple domains simultaneously.

Features

live-schedule
Real-time data

Access real-time data for any domain name by using live DNS lookup, NS lookup or MX lookup, ensuring you receive the most current information about domain configurations and server addresses.

Domain's past dns records

Retrieve historical DNS records for a domain, for anyone from A, AAAA, TXT, NS, MX, SOA, SPF, CNAME record or for all of them, providing a comprehensive view of past configurations and changes.

Record based lookup

Perform reverse dns lookup to find specific DNS records, for anyone from A, AAAA, TXT, NS, MX, SOA, SPF, CNAME record, and conduct reverse DNS lookups for detailed information.

Multiple domains lookup

Conduct bulk DNS lookups for multiple domains simultaneously, saving time and effort by retrieving DNS records for numerous domains in one request.

xml-document
Supported formats

Our service supports data retrieval in JSON and XML formats, offering flexibility and compatibility with various applications for seamless data integration and processing.

Consistent and Compressed data

We ensure data consistency and compression, providing accurate information while optimizing storage and bandwidth usage for faster access and reduced costs.

Up-to-date

Stay up to date with the latest DNS information, ensuring that you always have access to the most current and accurate domain data available.

Common Use Cases

Network Diagnostics DNS APIs are used for troubleshooting network issues by performing live DNS lookups, helping to identify DNS misconfigurations and resolve connectivity problems.
Threat Intelligence DNS APIs help track malware creators, DDoS attacks, and unusual traffic. Use detailed results to find the originator's IP address, aiding in pinpointing issues like spam campaigns, phishing schemes, and hacking attempts.
Penetration Testing Our DNS APIs are a great way to gain a more in-depth understanding of an organisation's online presence. This information can be used by pen testers and researchers to discover more about an organisation's network infrastructure, gaining insights into potential attack surfaces.
Email Verification Reverse DNS lookup APIs are used to validate email sender addresses, preventing spam and ensuring the authenticity of incoming emails.
Domain Research DNS APIs provide historical DNS records, allowing researchers to track changes in domain configurations, ownership, and infrastructure over time.
Competitive Analysis Our simple & fast DNS Lookup API is a great way to lookup and compare DNS entries. Use this API to determine the companies that your competitors are currently working with, ensuring you're reaching out to the right companies for your business development efforts.
Response
DNS Documentation

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.

API GET
https://api.whoisfreaks.com/v2.0/dns/live?apiKey=API_KEY&domainName=whoisfreaks.com&ipAddress=8.8.8.8&type=all
API GET
https://api.whoisfreaks.com/v2.0/dns/live?apiKey=API_KEY&domainName=whoisfreaks.com&type=all
API GET
https://api.whoisfreaks.com/v2.0/dns/live?apiKey=API_KEY&ipAddress=8.8.8.8&type=all

Query Parameters

  • Required
    apiKeyGet your API key from our billing dashboard.
    domainNameThe domainName for requested dns data.
    OR
    ipAddressThe ipAddress for requested DNS's PTR record.
    OR

    You can pass both domainName & ipAddress. At least one is required.

    typeType of DNS record like all/comma separated list (A, AAAA, TXT, NS, MX, SOA, SPF)
  • Optional
    formatTwo formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.
Responses

200 OK
400 Unable to process request.
401 Provided API key is invalid.
401 Provided API key is inactive.
401 Please buy a subscription plan or add api credits.
401 Your subscription is deactivated.
401 Repeated payment failures.
401 Your account is deactivated.
401 Suspicious Activity.
404 Entered Domain does not exist.
408 Unable to fetch dns data.
412 Exceeded the limit of api plan requests.
413 Exceeded the limit of api credits requests.
413 Exceeded the limit of surcharge requests.
429 Maximum request limit reached.
500 Internal Server error.
503 Service is unavailable.
504 Request is timed-out.

Request
Shell Node.js Java Python PHP Ruby JS C# Go C Swift
GET
Copy
Response
200 400 401 404 408 412 413 429 500 503 504
Copy
OK

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 the reset button in the billing dashboard.

API GET
https://api.whoisfreaks.com/v2.0/dns/historical?apiKey=API_KEY&domainName=whoisfreaks.com&type=all&page=1

Query Parameters

  • Required
    apiKeyGet your API key from our billing dashboard.
    domainNameThe domainName for requested dns data.
    typeType of DNS record like all/comma separated list (A, MX, CNAME, NS, AAAA, TXT, SOA)
  • Optional
    pageSpecify Page number to access specific page's data. If you don't pass 'page' parameter, default page is 1.
    formatTwo formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.
Responses

200 OK
400 Unable to process request.
401 Provided API key is invalid.
401 Provided API key is inactive.
401 Please buy a subscription plan or add api credits.
401 Your subscription is deactivated.
401 Repeated payment failures.
401 Your account is deactivated.
401 Suspicious Activity.
404 No Record Found.
408 Unable to fetch dns records.
412 Exceeded the limit of api plan requests.
413 Exceeded the limit of api credits requests.
413 Exceeded the limit of surcharge requests.
429 Maximum request limit reached.
500 Internal Server error.
503 Service is unavailable.
504 Request is timed-out.

Request
Shell Node.js Java Python PHP Ruby JS C# Go C Swift
GET
Copy
Response
200 400 401 404 408 412 413 429 500 503 504
Copy
OK

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 the reset button in the billing dashboard.

API GET
https://api.whoisfreaks.com/v2.1/dns/reverse?apiKey=API_KEY&format=json&value=8.8.8.8&type=a
API GET
https://api.whoisfreaks.com/v2.1/dns/reverse?apiKey=API_KEY&format=json&value=2001:db8::1&type=aaaa
API GET
https://api.whoisfreaks.com/v2.1/dns/reverse?apiKey=API_KEY&format=json&value=ns1.clouddns.com&type=ns
API GET
https://api.whoisfreaks.com/v2.1/dns/reverse?apiKey=API_KEY&format=json&value=mail.zoho.com&type=mx
API GET
https://api.whoisfreaks.com/v2.1/dns/reverse?apiKey=API_KEY&format=json&value=zoho.com&type=cname

Query Parameters

  • Required
    apiKeyGet your API key from our billing dashboard.
    value
    Click
    Value of DNS record like IP Address, MX or NS Server.
    type
    Click
    You can use different types of DNS record, such as A or any one from the following list (MX, CNAME, NS, AAAA, TXT, SOA).
  • Optional
    exact
    Click
    The 'exact' parameter can be either 'true' or 'false'.
    pageSpecify Page number to access specific page's data. If you don't pass 'page' parameter, default page is 1.
    formatTwo formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.
Responses

200 OK
400 Unable to process request.
401 Provided API key is invalid.
401 Provided API key is inactive.
401 Please buy a subscription plan or add api credits.
401 Your subscription is deactivated.
401 Repeated payment failures.
401 Your account is deactivated.
401 Suspicious Activity.
404 No Record Found.
408 Unable to fetch dns records.
412 Exceeded the limit of api plan requests.
413 Exceeded the limit of api credits requests.
413 Exceeded the limit of surcharge requests.
429 Maximum request limit reached.
500 Internal Server error.
503 Service is unavailable.
504 Request is timed-out.

Request
Shell Node.js Java Python PHP Ruby JS C# Go C Swift
GET
Copy
Response
200 400 401 404 408 412 413 429 500 503 504
Copy
OK

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.

Key Points:

  • The request body is mandatory. Click here to see an example.
  • Both domain names and IP addresses can have a maximum limit of 100 each.
API POST
{
    "domainNames":[
        "whoisfreaks.com",
        "jfreaks.com"
    ],
    "ipAddresses":[
        "1.1.1.1",
        "8.8.8.8"
    ]
}
Copy

Query Parameters

  • Required
    apiKeyGet your API key from our billing dashboard.
    typeType of DNS record like all/comma separated list (A,AAAA,TXT,NS,MX,SOA,SPF).
  • Optional
    formatTwo formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.
Request Body

    In the request body, add domainNames, ipAddresses, or both. At least one is required. Click here to see an example.
Responses

200 OK
400 Unable to process request.
401 Provided API key is invalid.
401 Provided API key is inactive.
401 Please buy a subscription plan or add api credits.
401 Your subscription is deactivated.
401 Repeated payment failures.
401 Your account is deactivated.
401 Suspicious Activity.
408 Unable to fetch dns records.
412 Exceeded the limit of api plan requests.
413 Exceeded the limit of api credits requests.
413 Exceeded the limit of surcharge requests.
429 Maximum request limit reached.
500 Internal Server error.
503 Service is unavailable.
504 Request is timed-out.

Request
Shell Node.js Java Python PHP Ruby JS C# Go C Swift
POST
Copy
Response
200 400 401 408 412 413 429 500 503 504
Copy
OK

Credit Usage API

You need credits to use DNS API. Below is the credit usage for each lookup API.

  • DNS Lookup service will charge 1 credit per successful domain query.
  • Historical DNS service will charge 2 credits per page.
    • It displays upto 100 records per page.
  • Reverse DNS service will charge 5 credits per page.
    • Displays a maximum of 100 records per page.
  • Bulk Dns lookup service charges 1 credit per successful query for each domain.

Surcharge requests are only allowed to credit subscribers. You can fetch credits usage and remaining credits information through this API.

Request
GET
Copy
Response
XML JSON
Copy



FAQs

What is the DNS?

The Domain Name System, or DNS, is a system that translates domain names to Internet Protocol (IP) addresses so browsers can load resources from the Internet.

Which DNS record types are supported?

A (IP address), AAAA (IPv6 address), MX (mail server), NS (name server), SOA (start of authority), SPF, TXT, and CNAME records are supported by DNS checker API.

Are DNS record types case sensitive?

No, DNS record types are not case sensitive.

What is meant by Live Lookup endpoint and how much data latency does it offer?

Our Live Lookup API offers real-time access to various endpoints, including domain whois, SSL and DNS data. By directly connecting to authoritative sources, this API ensures that you receive the most current and up-to-date information, eliminating data latency.

What type of data do you provide in Historical API endpoint and how often is it updated?

Our Historical API offers a blend of up-to-date information and comprehensive unique historical data. We will provide all previous unique records related to that domain along with the latest data. Please note that we update our database on monthly basis, so the maximum data latency in our historical api data can be 1 month.

How to perform Bulk DNS lookup?

To perform Bulk DNS lookup, follow these steps:

  1. Visit Bulk DNS lookup API tool.
  2. Enter the domain names in the provided input box, with each domain on a separate line.
  3. Select the desired DNS records from the available checkboxes (e.g., NS, A, CNAME, MX, etc.). You can also choose 'ALL' to retrieve all available DNS records for each domain.
  4. Click the search button to initiate the lookup process.
  5. Upon successful completion of the request, you will receive the DNS information for the requested domain names.

By following these steps, you can efficiently retrieve DNS records for multiple domains simultaneously using the Bulk DNS lookup tool.

What is the minimum number of domain names needed for bulk DNS lookup?

Bulk DNS API tool allows you to query up to 100 domains at once. You can input any number of domains, from 1 to 100, with each domain on a separate line, to retrieve their respective DNS lookup information.

Which TLDs are supported by your system?

All available TLDs and their sub-domains are supported by DNS lookup API.

Do you have notification service when API credits are near to an end?

Yes, we will inform you via an email. We send notification email on 80%,90%,100% usage. You can get credits/ subscription usage information from our billing portal or through API.

What happened if API credits have been utilized and my system is using whois API?

We provide surcharge requests on all active API credits subscriptions. You can fetch credits and surcharge requests information through our API. Each subscription plan has different surcharge requests limit.

Do you charge credit on 4xx error status codes in response?

No, We do not charge credits on 4xx status codes in response. All Whois APIs follow same rule for 4xx status codes in response.

What is the number of free API credits available for new users, and are these credits rate-limited?

We will provide 500 API credits to new users and yes, those credits have a rate-limiting of 10 requests per minute for Live APIs, 5 requests per minute for Bulk Domain Lookup, and 1 request per minute for Reverse/Historical Endpoints.

Do you have rate limiting on number of requests being made on your paid plans?

Yes, we have rate limiting on requests being made on all of our paid plans. The requests limit is shown in the following table.

The Table is divided into three types of plans:

1) API Credits

Credits Live-rpm Bulk-rpm Historical/Reverse-rpm
5000 20 8 3
15000 35 12 5
50000 80 20 10
150000 120 25 15
450000 150 35 20
1000000 200 50 25
3000000 300 70 35

2) API Subscription

Credits Live-rpm Bulk-rpm Historical/Reverse-rpm
5000 20 8 3
15000 35 12 5
50000 80 20 10
150000 120 25 15
450000 150 35 20
1000000 200 50 25
3000000 300 70 35
  • Live-rpm: API requests per minute limit for live Whois lookup API, domain availability API, SSL certificate lookup API, and DNS lookup API endpoints.
  • Bulk-rpm: API requests per minute limit for bulk domain Whois lookup API endpoint.
  • Historical/Reverse-rpm: API requests per minute limit for historical, and reverse Whois API endpoints.

In case, the request per minute exceeds; it'll throw an error with HTTP error code of 429.

Do you provide any headers in API response regarding rate limiting?

Yes, there are following three header parameters in the response:

  • X-RateLimit-Allowed-Requests: Tells the max allowed API requests per minute on a specific plan.
  • X-RateLimit-Remaining-Requests: Tells the remaining API requests per minute for that plan.
  • X-RateLimit-Remaining-Time: Tells after how much time the API requests per minute will be reset.