Search Name Server Changes

Prev Next
GET /explore/query/nstransfer

Query for name server changes from/to name servers within a time window for domains registered within a time window, optionally for domains registered with the registrar.

Query Parameters:

  • from_ns = (string) (required) –

    • name of previous name server, wildcard supported

      • use ‘self’ to search for self-hosted name servers

  • to_ns = (string) (required) –

    • name of new name server, wildcard supported

      • use ‘self’ to search for self-hosted name servers

  • domain_regex = (string) (optional) –

    • domain pattern to match

    • pattern must be a valid re2 regular expression

  • days = (int) (optional) –

    • sets window for change_date_after and whois_date_after, if not explicitly set

      • default = 30

  • change_date_after = (string) (optional) –

    • only changes on or after this date, or last 30 days if not set

  • change_date_before = (string) (optional) –

    • only changes on or before this date

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

    • ignore whois data unless specific whois options are set

      • default = 0

  • whois_date_after = (string) (optional) –

    • only domains registered on or after this date, or last 30 days if not set

  • whois_date_before = (string) (optional) –

    • only domains registered on or before this date

  • registrar = (string) (optional) –

    • only domains registered using this registrar

    • partial string match, or any if not set

  • email = (string) (optional) –

    • only domains using this registrant email address

    • exact match only, or any if not set

  • order = (string) (optional) –

    • sort change dates in desc/asc order

      • default = desc

  • limit = (int) (optional) –

    • number of results to return

      • default = 100

  • skip = (int) (optional) –

    • number of results to skip

Request headers:

  • X-API-KEY - api-key

Warning

Using any of the whois-specific options limits the search to domains for which we have pre-collected whois data

  • whois_data_after

  • whois_date_before

  • registrar

  • email

Example Request

https://api.silentpush.com/api/v1/merge-api/explore/query/nstransfer \
    ?from_ns=*.ipage.com \
    &to_ns=*.registrar-servers.com \
    &registrar=namecheap \
    &change_date_after=2021-05-01 \
    &whois_date_after=2021-05-01 \
    &limit=3

Example Response

{
    "status_code": 200,
    "error": null,
    "response": {
        "nstransfer": [
            {
                "change_date": "2021-06-17",
                "domain": "ajitfhm.com",
                "newnsrecs": [
                    "dns1.registrar-servers.com",
                    "dns2.registrar-servers.com"
                ],
                "oldnsrecs": [
                    "ns1.ipage.com",
                    "ns2.ipage.com"
                ]
            },
            {
                "change_date": "2021-06-12",
                "domain": "mxnet.email",
                "newnsrecs": [
                    "dns1.registrar-servers.com",
                    "dns2.registrar-servers.com"
                ],
                "oldnsrecs": [
                    "ns1.ipage.com",
                    "ns2.ipage.com"
                ]
            },
            {
                "change_date": "2021-06-03",
                "domain": "picindex.info",
                "newnsrecs": [
                    "dns1.registrar-servers.com",
                    "dns2.registrar-servers.com"
                ],
                "oldnsrecs": [
                    "ns1.ipage.com",
                    "ns2.ipage.com"
                ]
            }
        ]
    }
}

Domains Matching Regular Expression

https://api.silentpush.com/api/v1/merge-api/explore/query/nstransfer \
    ?from_ns=*.ipage.com \
    &to_ns=*.registrar-servers.com \
    &domain_regex=^[[:alnum:]]{3,7}\.[[:alpha:]]{2,}$ \
    &change_date_after=2021-03-01 \
    &limit=3
{
    "status_code": 200,
    "error": null,
    "response": {
        "nstransfer": [
            {
                "change_date": "2021-04-03",
                "domain": "opti.red",
                "newnsrecs": [
                    "dns101.registrar-servers.com",
                    "dns102.registrar-servers.com"
                ],
                "oldnsrecs": [
                    "ns1.ipage.com",
                    "ns2.ipage.com"
                ]
            },
            {
                "change_date": "2021-04-01",
                "domain": "giftme.xyz",
                "newnsrecs": [
                    "dns101.registrar-servers.com",
                    "dns102.registrar-servers.com"
                ],
                "oldnsrecs": [
                    "ns1.ipage.com",
                    "ns2.ipage.com"
                ]
            },
            {
                "change_date": "2021-04-01",
                "domain": "noco.today",
                "newnsrecs": [
                    "dns101.registrar-servers.com",
                    "dns102.registrar-servers.com"
                ],
                "oldnsrecs": [
                    "ns1.ipage.com",
                    "ns2.ipage.com"
                ]
            }
        ]
    }
}