Access to the dnsdumpster.com datasets via API is available to both Free users and those with Plus Access. Response data includes all found DNS records, ASN network owner, netblocks and Banner records found in our databases.

Requirements

To use the API you will need an API key, this can be found on your account dashboard after logging in. Sign up for a Free account now.

Limits

Free accounts are limited to 50 records retrieved, while the Plus account will retrieve up to 200 records for a domain. If you need higher numbers of results take a look at our parent company hackertarget.com for complete data access.

Example Usage

Here’s an example of how to make a request using cURL:

curl -H "X-API-Key: your_api_key_here" https://api.dnsdumpster.com/domain/example.com

The API will return JSON data containing DNS and attack surface information for the specified domain.

{
  "a": [
    {
      "host": "dnsdumpster.com",
      "ips": [
        {
          "asn": "63949",
          "asn_name": "AKAMAI-LINODE-AP Akamai Connected Cloud, SG",
          "asn_range": "172.104.208.0/20",
          "banners": {
            "http": {
              "apps": [
                "Nginx"
              ],
              "server": "nginx",
              "title": "403 Forbidden"
            },
            "https": {
              "alt_n": [
                "dnsdumpster.com"
              ],
              "apps": [
                "Nginx"
              ],
              "cn": "dnsdumpster.com",
              "server": "nginx",
              "title": "403 Forbidden"
            },
            "ip": "172.104.213.248"
          },
          "country": "United States",
          "country_code": "US",
          "ip": "172.104.213.248",
          "ptr": ""
        }
      ]
    }
  ],
  "cname": [],
  "mx": [],
  "ns": [
    {
      "host": "dns1.registrar-servers.com",
      "ips": [
        {
          "asn": "397237",
          "asn_name": "SECURITYSERVICES",
          "asn_range": "156.154.132.0/24",
          "country": "United States",
          "country_code": "US",
          "ip": "156.154.132.200",
          "ptr": ""
        }
      ]
    },
    {
      "host": "dns2.registrar-servers.com",
      "ips": [
        {
          "asn": "397237",
          "asn_name": "SECURITYSERVICES",
          "asn_range": "156.154.133.0/24",
          "country": "United States",
          "country_code": "US",
          "ip": "156.154.133.200",
          "ptr": ""
        }
      ]
    }
  ],
  "total_a_recs": 1,
  "txt": [
    "v=spf1 -all"
  ]
}

Rate Limit

As the domain search is conducted across a significant amount of records the API has a rate limit of 1 request per 2 seconds. If you exceed this limit, you will receive a 429 (Too Many Requests) response in JSON format. For example:

{"error":"Rate limit exceeded"}