API Documentation

Domain Search

Overview

The DomainTools API is organized into distinct products with queries that follow a
RESTful URL structure wherever possible. Each product offers free, un-authenticated
access for the sample URLs listed with each product. If you haven’t already, you may
want to review the getting started document to learn
about authentication and response formats.

The Domain Search API searches for domain names that match your specific search
string. Unlike Domain Suggestions, 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]
[JSON]
[XML]

General Information
Products