DomainSearch

This API call returns registered and previously registered domain names based on one or more keywords. This is a Premium API call, you have to buy API credits.

API request

https://api.dnslytics.net/v1/domainsearch/<keyword>?apikey=<apikey>

• Parameters:

  • keyword

    One or more keywords separated by the pipe symbol (|). Minimal length per keyword is 3 characters. Regex symbols ^ and $ are supported in a keyword.

  • apikey

    Your API key

• Optional parameters:

  • active

    Filter on only registered domains (active=1), only previously registered domains (active=0) or by default all domains (active=all).

  • tld

    Filter on single Top Level Domain name like COM (tld=com) or UK (tld=uk) or return all domains (default, tld=all).

  • maxlength

    Maximum length of the domain name. Maxlength value can be between 3 and 256 (default, maxlength=256).

  • minlength

    Minimal length of the domain name. Minlength value can be between 3 and 256 (default, minlength=3).

  • fromdate

    Only return domain names added to the zone file after this date, example fromdate=20180401 will only return new domains found after 20180401. This date will normally match the registration date of a domain name.

  • page

    A single API call returns a maximum of 2,500 domains. With the page parameter you can step through the results and get results up to 100,000 domains. Page value can be between 1 and 40.

API response

• A JSON object with the following fields:

  • status

    Status of API call: succeed or error.

  • question

    Array of the question data with the following fields: terms, page, tld, active, minlength, maxlength.

  • typeinfo

    Data type returned, always ‘domainsearch’.

  • ndomains

    Total number of domains found.

  • domains

    Domain names found with the following fields (domain, length, active). Maximum of 2,500 domains are returned. Use the page parameter to get up to 100,000 domain names.

Example

URL

$ curl https://api.dnslytics.net/v1/domainsearch/dns|lytics?apikey=<apikey>&tld=com&active=1

Output

{
        "status": "succeed",
        "data":
        {
                "question":
                {
                  "terms": "dns|lytics",
                  "page": 1,
                  "tld": "com",
                  "active": "1",
                  "minlength": 3,
                  "maxlength": 256
                },
                "typeinfo": "domainsearch",
                "ndomains": 11,
                "domains":[
                        {
                          "domain": "dnslytics.com",
                          "length": 9,
                          "active": true
                        },
                        {"..."}
                ]
        }
}