API: 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 here (https://dnslytics.com/api).

API request and parameters

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.
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).
minlength:Minimal length of the domain name. Minlength value can be between 3 and 256 (default, minlength=3).
maxlength:Maximum length of the domain name. Maxlength value can be between 3 and 256 (default, maxlength=256).
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 25,000 domains. Page value can be between 1 and 10.

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 25,000 domain names.

Example

$ https://api.dnslytics.net/v1/domainsearch/dns|lytics?apikey=<apikey>&tld=com&active=1
{
        "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
                        },
                        {"..."}
                ]
        }
}