Domain Search API Documentation

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

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

{ "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 }, ... ] } }

API Documentation

Domain Search

Overview

Domain Search Parameters

Sample Response

Sample Queries