---
title: "IP Diversity Lookup"
slug: "ip-diversity-lookup"
updated: 2026-01-07T21:55:05Z
published: 2026-01-07T21:55:05Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.silentpush.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IP Diversity Lookup

```plaintext
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

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

## Example Response

```python

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

## Example

Timeline.

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

```python
{
    "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"
                    }
                ]
            }
        ]
    }
}
```