Domain Search¶

Domain Search finds currently registered or previously registered domain names that are either currently registered or have been registered in the past under one of the major gTLD's (.com, .net, .org, .info, .us, or .biz), many country code TLDs, or the new gTLDs. You have the option to control whether the results include domain names with hyphens and/or numbers, to limit the length of domain names, and to filter for only active or deleted domains.

https://api.domaintools.com/v2/domain-search/?query=domain%20tools

Domain Search Parameters¶

Parameters	Allowed Value	Description
`query`	letters, numbers and spaces	Required. Query string — each term in the query string must be at least three characters long. Use spaces to separate multiple terms, but be sure to URL encode the values before passing them to the API.
`exclude_query`	letters, numbers and spaces	Terms to exclude from matching — each term in the query string must be at least three characters long. Use spaces to separate multiple terms, but be sure to URL encode the values before passing them to the API. Default: none
`max_length`	2 … 65	Limit the maximum domain character count. Default: 25
`min_length`	> 1	Limit the minimum domain character count. Default: 2
has_hyphen	true false	Return results with hyphens in the domain name. Default: true
`has_number`	true false	Return results with numbers in the domain name. Default: true
`active_only`	true false	Return only domains currently registered. Default: false
`deleted_only`	true false	Return only domains previously registered but not currently registered. Default: false
`anchor_left`	true false	Return only domains that start with the query term. Default: false
`anchor_right`	true false	Return only domains that end with the query term. Default: false
`page`	> 0	Sets the page of results to retrieve from the server. Each page is limited to 100 results. Default: 1

Search results will include the list of domain names that match the query. The currently registered TLDs are held in the tlds response element, while those TLDs that the have ever been registered are held in the hashad_tlds element.

Sample Response¶

{
   "response":{
      "query_info":{
         "active_only":false,
         "min_length":0,
         "total_results":477,
         "exclude_query":"",
         "has_hyphen":true,
         "max_length":25,
         "anchor_right":false,
         "anchor_left":false,
         "page":1,
         "limit":1000,
         "has_number":true,
         "deleted_only":false
      },
      "results":[
         {
            "sld":"domaintools",
            "tlds":["asia","at","be","biz","ca","cc","ch","cl","cm","cn","co","co.il","co.in","co.kr","co.nz","co.uk","co.za","com","com.ar","com.au","com.cn","com.ua","cz","de","dk","es","eu","fr","gr","hu","in","info","ir","it","jp","kr","lu","me","mobi","net","net.au","nl","no","nu","org","pk","pl","pt","pw","ro","se","sx","tel","tk","tv","tw","us","ws","xxx"],
            "hashad_tlds":["asia","at","be","biz","ca","cc","ch","cl","cm","cn","co","co.il","co.in","co.kr","co.nz","co.uk","co.za","com","com.ar","com.au","com.br","com.cn","com.ua","cz","de","dk","es","eu","fr","gr","hu","in","info","ir","it","jp","kr","lu","me","mobi","mx","name","net","net.au","nl","no","nu","org","org.uk","pk","pl","pro","pt","pw","ro","se","sk","su","sx","tel","tk","tv","tw","us","wdc","ws","xxx"],
            "char_count":11,
            "has_hyphen":0,
            "has_deleted":1,
            "has_number":0,
            "tlds_count":59,
            "has_active":1
         },
         {
            "sld":"domain-tools",
            "tlds":["com","com.au","de","eu","it","net","org","ru","tk"],
            "hashad_tlds":["asia","biz","cn","co.uk","com","com.au","com.cn","de","eu","info","it","net","org","ru","sk","tk","us"],
            "char_count":12,
            "has_hyphen":1,
            "has_deleted":1,
            "has_number":0,
            "tlds_count":9,
            "has_active":1
         },
         ...
      ]
   }
}

You must provide your API credentials to use this API.

Sample Queries¶

HTML: https://api.domaintools.com/v2/domain-search/?query=domain%20tools&limit=1000&format=html
JSON: https://api.domaintools.com/v2/domain-search/?query=domain%20tools&limit=1000&format=json
XML: https://api.domaintools.com/v2/domain-search/?query=domain%20tools&limit=1000&format=xml