Search Self-hosted Domains

Prev Next
GET /explore/padns/search/selfhosted/{qtype}

Search self-hosted domains, i.e., NS servers are in the queried domain and hosted on the same IP as the domain A record (where A records have been seen as active within the last 30 days)

Parameters

Description

Query Parameters

  • qtype = (string) (optional) –

    • record type to search

    • the following qtypes are supported:

      • ns

  • domain = (string) (optional) –

    • name or wildcard pattern of domain names to search for

  • regex = (pattern) (optional) –

    • re2 regular expression

      • pattern must be a valid re2 regular expression

  • domain_asnum = (int) (optional)

    • AS number of domain A records to search, may be repeated times for additional AS numbers

  • nssrv_asnum = (int) (optional) –

    • AS number of name server A records to search, may be repeated multiple times for additional AS numbers

  • asn = (int) (optional) –

    • search for IP addresses in or not in the given AS numbers

      • default = in

  • asname = (string) (optional) –

    • search for domain and name server A records in all AS numbers where the AS Name begins with , may be repeated multiple time for additional AS names

  • asname_starts_with = (string) (optional) –

    • search for domain and name server A records in all AS numbers where the AS Name begins with , may be repeated multiple time for additional AS names

  • asname_contains = (string) (optional) –

    • search for domain and name server A records in all AS numbers where the AS Name contains , may be repeated multiple time for additional AS names

  • asn_match = (string) (optional) –

    • how to match AS numbers

      • any (default) - match on any asnum given or derived from asname

      • all - asn diversity timeline must contain all asnums given as asnum parameter or derived from asname

  • limit = (int) (optional) –

    • number of results to return

      • default = 100

  • skip = (int) (optional) –

    • number of results to skip

  • with_metadata =<0|1> (int) (optional) –

    • include metadata object in response : returned results, total results, job_id

      • 0 (default) = do not include

      • 1 = include metadata

Request Headers

X-API-KEY – api-key

Note

AS numbers derived from asname, asname_starts_with and asname_contains parameters will be appended to the AS numbers given as domain_asnum and nssrv_asnum parameters - i.e., asname, asname_starts_with and asname_contains are appended to both the domain_asnum and nssrv_asnum lists

Example request

https://api.silentpush.com/api/v1/merge-api/explore/padns/search/selfhosted/ns \
     ?asname=uunet \
     &asn=notin \
     &domain=sil* \
     &limit=3

Example response

{
    "status_code": 200,
    "error": null,
    "response": {
        "records": [
        {
            "domain": "sil-core.com",
            "domain_asns": {
                "394695": "PUBLIC-DOMAIN-REGISTRY, US"
            },
            "domain_ips": [
                "199.79.62.211"
            ],
            "nssrv": [
                "ns.sil-core.com"
            ],
            "nssrv_asns": {
                "394695": "PUBLIC-DOMAIN-REGISTRY, US"
            },
            "nssrv_ips": [
                "199.79.62.211"
            ]
        },
        {
            "domain": "sil-more.com",
            "domain_asns": {
                "3462": "HINET Data Communication Business Group, TW"
            },
            "domain_ips": [
                "220.130.141.85"
            ],
            "nssrv": [
                "dns2.sil-more.com",
                "dns1.sil-more.com"
            ],
            "nssrv_asns": {
                "3462": "HINET Data Communication Business Group, TW"
            },
            "nssrv_ips": [
                "220.128.102.156",
                "220.130.141.85"
            ]
        },
        {
            "domain": "sil-tec.gr",
            "domain_asns": {
                "3329": "HOL-GR Athens, Greece, GR"
            },
            "domain_ips": [
                "91.138.180.85"
            ],
            "nssrv": [
                "ns1.sil-tec.gr",
                "ns3.sil-tec.gr"
            ],
            "nssrv_asns": {
                "3329": "HOL-GR Athens, Greece, GR",
                "55405": "EXABYTES-AS-AP Exa Bytes Network Sdn.Bhd., MY"
            },
            "nssrv_ips": [
                "91.138.180.85",
                "202.157.182.142"
            ]
        }
        ]
    }
}