Density Lookup

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

Parameter

Type

Required/Optional

Description

qtype

string

Required

Specifies the query type. Supported types: nssrv, mxsrv, nshash, mhash, ipv4, ipv6, asn

query

string

Required

The value to look up, based on qtype: nssrv or mxsrv, nshash or mxhash, ipv4 or ipv6, asn

scope

string

Optional

Controls exact or summarized/near-match results, depending on qtype. Defaults to exact match for most types. See details for options by qtype.

Scope Options by qtype

Scope varies by lookup type to provide exact matches or aggregated summaries (e.g., subnets, domains).

  • qtype=ipv4:

    • ip (default)

    • subnet

    • subnet_ips

    • asn

    • asn_subnets

  • qtype=asn:

    • asn (default)

    • asn_subnets

  • qtype=nssrv or qtype=mxsrv

    • host

    • domain

    • subdomain

Request headers

Header

Description

X-API-KEY

API key for authentication.

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
            }
        ]
    }
}