Skip to content
DomainTools Technical Documentation

Quick start

This guide will help you make your first API calls to the Iris Investigate API.

API Endpoint

Section titled “API Endpoint”
https://api.domaintools.com/v1/iris-investigate/

API Authentication

Section titled “API Authentication”

The Iris APIs share the same authentication mechanisms as DomainTools Feeds.

Link your credentials to your organization’s DomainTools enterprise account, which must be authorized for Iris Investigate.

Use Header Authentication by passing your API key in the X-Api-Key header field (example below).

Query Limits and Testing

Section titled “Query Limits and Testing”

Use no-charge test queries for configuration without consuming your quota:

  • ?domain=domaintools.com
  • ?domain=dnsdb.info
  • ?domain=example.com
  • ?ip=199.30.228.112

For complete details on free test queries and rate limits, see Iris Rate Limits.

Retrieve Domain Records with a Test Query

Section titled “Retrieve Domain Records with a Test Query”

Submit a HTTP GET request:

Query URL

https://api.domaintools.com/v1/iris-investigate/?domain=domaintools.com

cURL Example

curl -X GET \
  'https://api.domaintools.com/v1/iris-investigate/?domain=domaintools.com' \
  -H "X-Api-Key: $DOMAINTOOLS_API_KEY"

The API returns default records for domaintools.com as objects in the results array.

{
  "response": {
    "limit_exceeded": false,
    "has_more_results": false,
    "message": "Enjoy your data.",
    "results_count": 1,
    "total_count": 1,
    "results": [
      {
        "domain": "domaintools.com",
        "whois_url": "https://whois.domaintools.com/domaintools.com",
        "adsense": {
          "value": "",
          "count": 0
        },
        ...
      }
    ]
  }
}

Search for a Set of Domain Names

Section titled “Search for a Set of Domain Names”

Search for a single domain name:

https://api.domaintools.com/v1/iris-investigate/?domain=domaintools.com

Pass a comma-separated list of up to 100 domain names in a HTTP GET request:

Query URL

https://api.domaintools.com/v1/iris-investigate/?domain=domaintools.com,domaintools.net,example.com

cURL Example

curl -X GET 'https://api.domaintools.com/v1/iris-investigate/?domain=domaintools.com,domaintools.net,example.com' \
-H "X-Api-Key: $DOMAINTOOLS_API_KEY"

Consider using a POST request for multiple domains:

curl -X POST 'https://api.domaintools.com/v1/iris-investigate/' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H "X-Api-Key: $DOMAINTOOLS_API_KEY" \
-d 'domain=domaintools.com,domaintools.net,example.com'

Next Steps

Section titled “Next Steps”