IP Diversity Lookup

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

Get ip diversity (number of ip addresses pointed to over time) for query to qtype.

Parameter	Type	Required	Description
qtype	string	Yes	Specifies the query type. Supported types: a, aaaa
query	string	Yes	The value to look up, based on qtype: a, aaaa
window	int	No	Use records with a last_seen more recently than <n> days ago. Default = 30,
asn	int	No	Include asn diversity 0 = do not include 1 (default) = include asn diversity
timeline	int	No	include timeline of {ip, first_seen, last_seen} (+asn if asn=1) 0 (default) = do not include 1 = include timeline
verbose	int	No	return ips, dates, timeline, (and asns if asn=1) 0 (default) = do not include 1 = include all data
scope	string	No	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=a:
- host - exact match (default when qtype=a)
- domain - match all hosts in this domain (domain extracted from {query})
- subdomain - match all hosts at this subdomain level (i.e., *.{query})
- live - calculate values from live data instead of pre-aggregated values - also switches to exact match only
qtype=aaaa
- live - only this mode is supported for qtype=aaaa

Request headers

Header	Description
X-API-KEY	API key for authentication.

Example request

https://api.silentpush.com/api/v1/merge-api/explore/padns/lookup/ipdiversity/a/elbigiddim.xyz

Example response


    "status_code": 200,
    "error": null,
    "response": {
        "records": [
            {
                "asn_diversity": 2,
                "host": "elbigiddim.xyz",
                "ip_diversity_all": 2,
                "ip_diversity_groups": 2
            }
        ]
    }
}

Example

Timeline.

https://api.silentpush.com/api/v1/merge-api/explore/padns/lookup/ipdiversity/a/elbigiddim?timeline=1

{
    "status_code": 200,
    "error": null,
    "response": {
        "records": [
            {
                "asn_diversity": 2,
                "host": "elbigiddim.xyz",
                "ip_diversity_all": 2,
                "ip_diversity_groups": 2,
                "timeline": [
                    {
                        "asn": "28753",
                        "asname": "LEASEWEB-DE-FRA-10, DE",
                        "first_seen": "2021-07-06 18:06:58",
                        "ip": "5.61.43.191",
                        "last_seen": "2021-07-10 17:58:31"
                    },
                    {
                        "asn": "202015",
                        "asname": "HZ-US-AS, BG",
                        "first_seen": "2021-07-03 14:31:37",
                        "ip": "79.141.163.35",
                        "last_seen": "2021-07-05 14:56:16"
                    }
                ]
            }
        ]
    }
}