Skip to content

Quick Start

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

API Endpoint

https://api.domaintools.com/v1/iris-investigate/

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

Note

Test and configure with no-charge test queries.

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

Submit a HTTP GET request:

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

curl -X GET \
  'https://api.domaintools.com/v1/iris-investigate/?domain=domaintools.com' \
  -H 'X-Api-Key: YOUR_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

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:

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

curl -X GET 'https://api.domaintools.com/v1/iris-investigate/?domain=domaintools.com,domaintools.net,example.com' \
-H 'X-Api-Key: YOUR_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: YOUR_API_KEY' \
-d 'domain=domaintools.com,domaintools.net,example.com'

Next Steps