Density Lookup

GET /explore/padns/lookup/density/{qtype}/{query}

Query Parameters:

qtype (string) (required) –
- the following qypes are supported:
  - nssrv
  - mxsrv
  - nshash
  - mxhash
  - ipv4
  - ipv6
  - asn
query (string) (required) –
- specify a value to lookup
  - name of NS or MX server
  - hash of NS or MX server
  - IPv4 or IPv6 address
  - AS number
scope (string) (optional) –
- exact or near match results by qtype
  - for qtype = ipv4
    - ip - exact match (default when qtype=ipv4)
    - subnet - summary of subnet for ipv4
    - subnet_ips - density for all ips in subnet
    - asn - summary of asn for ipv4
    - asn_subnets - summary for all subnets in asn
  - for qtype = asn
    - asn - summary of asn (default when qtype=asn)
    - asn_subnets - summary for all subnets in asn
  - for qtype = nssrv or qtype = mxsrv
    - host - exact match (default when qtype=nssrv or qtype=mxsrv)
    - domain - match all hosts in this domain (domain extracted from {query})
    - subdomain - match all hosts at this subdomain level (i.e., *.{query})

Request headers:

X-API-KEY - api-key

Example request

https://api.silentpush.com/api/v1/merge-api/explore/padns/lookup/density/nssrv/vida.ns.cloudflare.com

Example response

{
    "status_code": 200,
    "error": null,
    "response": {
        "records": [
            {
                "density": 64082,
                "nssrv": "vida.ns.cloudflare.com"
            }
        ]
    }
}

Example

Subnet scope from ipv4 address.

https://api.silentpush.com/api/v1/merge-api/explore/padns/lookup/density/ipv4/1.1.1.1?scope=subnet

{
    "status_code": 200,
    "error": null,
    "response": {
        "records": [
            {
                "asn": 13335,
                "density_avg": 187.9,
                "density_max": 37852,
                "density_stddev": 2630.6,
                "ips_active": 206,
                "subnet": "1.1.1.0/24",
                "subnet_size": 256
            }
        ]
    }
}