pricing background

Documentation

Live DNS Lookup

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.

Query Parameters

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)
Optional
  • format
    Two formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

Status Codes

Success Codes
  • 200  Request is processed successfully.
Failure Codes
  • 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, then use this api key.
  • 401  Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401  Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401  Your account is deactivated.
  • 401  You are blocked due to suspicious activity.
  • 404  Entered Domain does not exist: ajfafja.com
  • 408  Unable to fetch dns records. Please try after some time.
  • 412  You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413  You have exceeded the limit of api credits requests [allowed_request_no]. Please upgrade your plan.
  • 413  You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 429  Please slow down. Your maximum request limit per minute is reached.
  • 500  Internal Server error occurred.
  • 503  Service is unavailable. Please try after some time.
  • 504  Request is timed-out.

Historical DNS Lookup

The Historical DNS Lookup API queries a database containing billions of records to retrieve all historical DNS records for a specified domain name. Results are returned in a paginated format and can be delivered in either XML or JSON.

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.
  • domainName
    The domainName for requested dns data.
  • type
    Type of DNS record like all/comma separated list (A, MX, CNAME, NS, AAAA, TXT, SOA)
Optional
  • page
    Specify Page number to access specific page's data. If you don't pass 'page' parameter, default page is 1.
  • format
    Two formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

Status Codes

Success Codes
  • 200  Request is processed successfully.
Failure Codes
  • 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, then use this api key.
  • 401  Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401  Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401  Your account is deactivated.
  • 401  You are blocked due to suspicious activity.
  • 404  No Record Found across domainName: whoisfreaks.com.
  • 408  Unable to fetch dns records. Please try after some time.
  • 412  You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413  You have exceeded the limit of api credits requests [allowed_request_no]. Please upgrade your plan.
  • 413  You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 429  Please slow down. Your maximum request limit per minute is reached.
  • 500  Internal Server error occurred.
  • 503  Service is unavailable. Please try after some time.
  • 504  Request is timed-out.

Reverse DNS Lookup

The Reverse DNS API lets you search for IP addresses or CIDR ranges associated with A and AAAA records, as well as specific values for other record types within our DNS database. It also supports pattern matching using an asterisk (*) for records such as MX, NS, CNAME, SPF, TXT, and SOA by setting the exact parameter to false.

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.
  • value
    Value of DNS record like IP Address, MX or NS Server.
  • type
    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
    The 'exact' parameter can be either 'true' or 'false'.
  • page
    Specify Page number to access specific page's data. If you don't pass 'page' parameter, default page is 1.
  • format
    Two formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

Status Codes

Success Codes
  • 200  Request is processed successfully.
Failure Codes
  • 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, then use this api key.
  • 401  Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401  Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401  Your account is deactivated.
  • 401  You are blocked due to suspicious activity.
  • 404  No Record Found across domainName: whoisfreaks.com.
  • 408  Unable to fetch dns records. Please try after some time.
  • 412  You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413  You have exceeded the limit of api credits requests [allowed_request_no]. Please upgrade your plan.
  • 413  You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 429  Please slow down. Your maximum request limit per minute is reached.
  • 500  Internal Server error occurred.
  • 503  Service is unavailable. Please try after some time.
  • 504  Request is timed-out.

Bulk DNS Lookup

The Bulk DNS API offers two methods for large-scale lookups: you can send an API request with a body containing up to 100 domains and 100 IP addresses, with results returned directly in the response, or upload a file with up to 3 million entries, where each line contains either a domain or an IP address, and the records will be delivered to you via email.

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.
  • type
    Type of DNS record like all/comma separated list (A,AAAA,TXT,NS,MX,SOA,SPF).
Optional
  • format
    Two formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

Status Codes

Success Codes
  • 200  Request is processed successfully.
Failure Codes
  • 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, then use this api key.
  • 401  Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401  Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401  Your account is deactivated.
  • 401  You are blocked due to suspicious activity.
  • 408  Unable to fetch dns records. Please try after some time.
  • 412  You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413  You have exceeded the limit of api credits requests [allowed_request_no]. Please upgrade your plan.
  • 413  You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 429  Please slow down. Your maximum request limit per minute is reached.
  • 500  Internal Server error occurred.
  • 503  Service is unavailable. Please try after some time.
  • 504  Request is timed-out.