IP Diversity Lookup

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

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

Query Parameters:

qtype (string) (required) –
- the following qypes are supported:
  - a
  - aaaa
query (string) (required) –
- specify a value to lookup
  - name of A or AAAA record
window = (int) (optional) –
- use records with a last_seen more recently than days ago
  - default = 30
asn =<0|1> (int) (optional) –
- include asn diversity
  - 0 = do not include
  - 1 (default) = include asn diversity
timeline =<0|1> (int) (optional) –
- include timeline of {ip, first_seen, last_seen} (+asn if asn=1)
  - 0 (default) = do not include
  - 1 = include timeline
verbose =<0|1> (int) (optional) –
- return ips, dates, timeline, (and asns if asn=1)
  - 0 (default) = do not include
  - 1 = include all data
scope (string) (optional) –
- exact or near match results by qtype
- scope=live is automatically set when timeline=1 or verbose=1
  - for 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
  - for qtype = aaaa
    - live - only this mode is supported for qtype=aaaa

Request headers:

X-API-KEY - api-key

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.

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