Making requests

API endpoint

POST https://reverse-dns.whoisxmlapi.com/api/v1

It takes up to a minute to activate your account after the registration.

Postman collection

Postman is a desktop and web application that allows you to make requests to an API from a graphical user interface. We recommend using Postman with WhoisXML APIs endpoints when exploring the APIs functionality, as well as when you are troubleshooting issues with your application.

The WhoisXML API Postman collection is available at the following links:

The collection includes a preconfigured environment. You will need to set up the api_key variable to fire each request. Get your personal API KEY on the My products page. If you have questions related to the API, contact us.

The API returns DNS records matching the given search criteria. One request to the API returns DNS records of one type, which shall be specified in the recordType input parameter.

Request body example

{
    "apiKey": "YOUR_API_KEY",
    "limit": 1000,
    "includeAdditionalChecks": 1,
    "recordType": "soa",
    "terms": [
        {
            "field": "domain",
            "term": "google.com"
        }
    ]
}

This request returns all SOA records for the "google.com" domain.

You can also use wildcard search. In this case, the term input parameter looks like "google*". Such requests take longer to process, thus try avoiding too wide searches.

Request body example

{
    "apiKey": "YOUR_API_KEY",
    "limit": 1000,
    "includeAdditionalChecks": 1,
    "recordType": "soa",
    "terms": [
        {
            "field": "value",
            "term": "ns1.google*"
        }
    ]
}

This request returns all SOA records matching the search term. On our example it's: starting with "ns1.google".

In most cases, wildcard search terms are used. You can use trailing, leading, and both wildcard searches:
"ns1.google*", "*ns1.google", "*ns1.google*".

Exclude terms request body example

You can add search terms to exclude records from the output.

{
    "apiKey": "YOUR_API_KEY",
    "limit": 1000,
    "includeAdditionalChecks": 1,
    "recordType": "soa",
    "terms": [
        {
            "field": "value",
            "term": "ns1.google*"
        },
        {
            "field": "value",
            "term": "*googledomains.com*",
            "exclude": true
        }
    ]
}

This request returns all SOA records which start with "ns1.google" and do not include "googledomains.com".

Request body example

You can use up to 4 search terms of different types within one request.

{
    "apiKey": "YOUR_API_KEY",
    "limit": 1000,
    "includeAdditionalChecks": 1,
    "recordType": "soa",
    "terms": [
        {
            "field": "value",
            "term": "ns1.google*"
        },
        {
            "field": "domain",
            "term": "1bgo9ev2in.com"
        }
    ]
}

This request returns all SOA records which start with "ns1.google", and are related to the "1bgo9ev2in.com" domain.

Exclude terms request body example

You can add search terms to exclude records from the output.

{
    "apiKey": "YOUR_API_KEY",
    "limit": 1000,
    "includeAdditionalChecks": 1,
    "recordType": "txt",
    "terms": [
        {
            "field": "domain",
            "term": "twitter.com"
        },
        {
            "field": "value",
            "term": "*verification*"
        },
        {
            "field": "value",
            "term": "*domain*",
            "exclude": true
        }
    ]
}

This request returns all TXT records which contain "verification", do not include "domain", and are related to the "twitter.com" domain.

Input parameters

apiKey	Required. Get your personal API key on the My products page.
recordType	Required. Type of DNS records among which the search is performed. Acceptable values: soa \| txt \| cname Default: undefined
terms	Required. Array of search terms. Maximum 4 items.
terms.*.field	Required. The field by which the search is performed among the DNS recordType records. domain – Domain name search. value – DNS record value search. Acceptable values: domain \| value
terms.*.term	Required. The target search term.
terms.*.exclude	Optional. If true, then the matching DNS records will be excluded from the search results. Acceptable values: false \| true Default: false
limit	Optional. Max count of returned records. Acceptable values: 1 - 1000 Default: 1000
includeAdditionalChecks	Optional. By default, no additional checks are performed. 0 – The response is returned as normal. 1 request costs 5 DRS credits. 1 – In this mode, the API performs two additional DNS checks: wildcard check and domain activeness check. Such a query takes a bit longer to execute and 1 request costs 7 DRS credits. wildcard check – The API checks if the DNS record is part of a wildcard entry. domain activeness check – The API checks if the domain's DNS records can be retrieved. Acceptable values: 0 \| 1 Default: 0
outputFormat	Optional. Response output format. Acceptable values: JSON \| XML Default: JSON

Free access

After Sign Up you automatically get a free subscription plan limited to 500 DRS credits.

Usage limits and requests throttling

The maximum number of requests per second is 30. In case that the limit is breached, your subsequent requests will be rejected until the next second.

This API is also available with a dedicated load balancer and premium endpoint to enable faster querying as part of our Premium API Services and Enterprise API Packages.

WHOIS / WHOIS History

DNS / DNS History

IP Geolocation / IP Netblocks

Domain Research Suite (DRS)

Domain/WHOIS

DNS/IP

Intelligence

Other

Domain/WHOIS

DNS/IP

Intelligence

Other

Domain/WHOIS

DNS/IP

Intelligence

Other

Domain Research Suite (DRS)

Research

Monitoring

White-Label

Predictive Threat Intelligence

Internet Infrastructure

Enterprise API Packages

Security Intelligence (SI) Suite

Making requests

API endpoint

Postman collection

Request body example

Request body example

Exclude terms request body example

Request body example

Exclude terms request body example

Input parameters

Free access

Usage limits and requests throttling

Have questions?