API Documentation

Iris Pivot

Overview

NOTICE: This API is deprecated and will not be supported in the near future. Please consider the Iris Investigate API instead.

The DomainTools API is organized into distinct products with queries that follow a RESTful URL structure wherever possible. Each product offers free, un-authenticated access for the sample URLs listed with each product. If you haven’t already, you may
want to review the getting started document to learn about authentication and response formats.

The Iris Pivot API enables bulk enrichment of a list of domains with parsed domain and infrastructure profiles sourced from the Iris database. It also provides a multivariate search across several of the most commonly-used Iris data fields. Queries to the Iris Pivot API deduct from the same Iris Investigation query allocation assigned to a user’s Enterprise Membership for qualified Iris customers.

The response format is the same in both use cases: a list of JSON documents for each matched domain name, complete with everything we know across the Iris dataset, including parsed Whois data, reputation score, IP and NS details, IP location, website response profiles, and more.

To use the Iris Pivot API for enrichment, submit a list of up to 100 domain names in the “domain” parameter, each separated by a comma. For example:

https://api.domaintools.com/v1/iris/?domain=domaintools.com,domaintools.net,dailychanges.com

Or, perform a search on the Iris database by submitting one or more parameters from the list below. Multiple parameters are combined into a logical AND query that will narrow the search results to only those domains which match all the parameters.

If a search matches more than 500 domains, only the first 500 results will be returned. The “limit_exceeded” response field will return boolean true if your search is too broad.

https://api.domaintools.com/v1/iris/?registrant=fred&nameserver_domain=domainparkingserver.net

Iris Pivot API Parameters

Parameters	Description
domain	One or more domains separated by a comma ( , ). Limited to 100 domains per request.
ip	A single full IP Address ( i.e. 65.55.53.233 ) that will be matched to the A record response for a domain name.
email	A single email address. The results will match email addresses in the Admin, Billing, Registrant, and Technical Contacts, along with SSL, Whois Records, and DNS/SOA records.
nameserver_host	The exact hostname of the Name Server you wish to query ( i.e. ns1.dynect.net ).
nameserver_domain	The exact domain of the Name Server you wish to query ( i.e. dynect.net ).
registrar	Word search on the domain registrar.
registrant	Word search on the Whois registrant field
registrant_org	Word search on the Whois registrant organization field

Sample Response

{
  "response": {
    "limit_exceeded": false,
    "message": "Enjoy your data.",
    "results_count": 1,
    "results": [
      {
        "domain": "domaintools.com",
        "whois_url": "https://whois.domaintools.com/domaintools.com",
        "adsense": "",
        "alexa": 2346,
        "google_analytics": 76641,
        "admin_contact": {
          "name": "DOMAIN ADMINISTRATOR",
          "org": "DOMAINTOOLS, LLC",
          "street": "2101 4TH AVE,SUITE 1150",
          "city": "SEATTLE",
          "state": "WA",
          "postal": "98121",
          "country": "us",
          "phone": "12068389035",
          "fax": "12068389056",
          "email": [
            "[email protected]"
          ]
        },
        "billing_contact": {
          "name": "",
          "org": "",
          "street": "",
          "city": "",
          "state": "",
          "postal": "",
          "country": "",
          "phone": "",
          "fax": "",
          "email": []
        },
        "registrant_contact": {
          "name": "DOMAIN ADMINISTRATOR",
          "org": "DOMAINTOOLS, LLC",
          "street": "2101 4TH AVE,SUITE 1150",
          "city": "SEATTLE",
          "state": "WA",
          "postal": "98121",
          "country": "us",
          "phone": "12068389035",
          "fax": "12068389056",
          "email": [
            "[email protected]"
          ]
        },
        "technical_contact": {
          "name": "DOMAIN ADMINISTRATOR",
          "org": "DOMAINTOOLS, LLC",
          "street": "2101 4TH AVE,SUITE 1150",
          "city": "SEATTLE",
          "state": "WA",
          "postal": "98121",
          "country": "us",
          "phone": "12068389035",
          "fax": "12068389056",
          "email": [
            "[email protected]"
          ]
        },
        "create_date": "1998-08-02",
        "expiration_date": "2017-08-01",
        "email_domain": [
          "domaintools.com",
          "enom.com"
        ],
        "soa_email": [
          "[email protected]"
        ],
        "ssl_email": [],
        "additional_whois_email": [
          "[email protected]"
        ],
        "ip": [
          {
            "address": "199.30.228.112",
            "asn": [
              17318
            ],
            "country_code": "us",
            "isp": "Domaintools LLC"
          }
        ],
        "mx": [
          {
            "host": "aspmx3.googlemail.com",
            "domain": "googlemail.com",
            "ip": [
              "64.233.185.26"
            ],
            "priority": 10
          },
          {
            "host": "aspmx2.googlemail.com",
            "domain": "googlemail.com",
            "ip": [
              "74.125.142.27"
            ],
            "priority": 10
          },
          {
            "host": "alt1.aspmx.l.google.com",
            "domain": "google.com",
            "ip": [
              "74.125.142.27"
            ],
            "priority": 5
          },
          {
            "host": "aspmx.l.google.com",
            "domain": "google.com",
            "ip": [
              "74.125.28.27"
            ],
            "priority": 1
          },
          {
            "host": "alt2.aspmx.l.google.com",
            "domain": "google.com",
            "ip": [
              "64.233.185.27"
            ],
            "priority": 5
          },
          {
            "host": "aspmx4.googlemail.com",
            "domain": "googlemail.com",
            "ip": [
              "173.194.205.27"
            ],
            "priority": 10
          }
        ],
        "name_server": [
          {
            "host": "ns1.p09.dynect.net",
            "domain": "dynect.net",
            "ip": [
              "208.78.70.9"
            ]
          },
          {
            "host": "ns2.p09.dynect.net",
            "domain": "dynect.net",
            "ip": [
              "204.13.250.9"
            ]
          },
          {
            "host": "ns3.p09.dynect.net",
            "domain": "dynect.net",
            "ip": [
              "208.78.71.9"
            ]
          },
          {
            "host": "ns4.p09.dynect.net",
            "domain": "dynect.net",
            "ip": [
              "204.13.251.9"
            ]
          }
        ],
        "redirect": "",
        "redirect_domain": "",
        "registrant_name": "DOMAIN ADMINISTRATOR",
        "registrant_org": "DOMAINTOOLS, LLC",
        "registrar": "ENOM, INC",
        "registrar_status": [
          "clientTransferProhibited"
        ],
        "risk_score": 0,
        "spf_info": "v=spf1 ip4:199.30.228.70 mx a:relay.nameintel.com include:mail.zendesk.com include:_spf.google.com include:mktomail.com ~all",
        "ssl_country": "",
        "ssl_hash": "",
        "ssl_org": "",
        "tld": "com",
        "website_response": 200
      },
      ...
    ]
  }
}

You must provide your
API credentials to use this API.

NOTE: We are unable to provide a functioning test URL for this product because queries must be linked to an active Enterprise Membership. See below for a sample response.