Open a FREE Account| Log in | Help

DomainTools API Guide: Domain Search

The DomainTools API is organized into distinct products with queries that follow a REST-ful 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). 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.

  http://api.domaintools.com/v1/domain-search/?query=domain%20tools
	
Domain Search Parameters
Parameters
Allowed Values
Description
query
Up to 65 letters, numbers and spaces
Required.
Query string — must be at least two characters long. Use spaces to separate multiple terms, but be sure to URL encode the values before passing them to the API.
max_length
2 … 65
Limit the maximum domain character count.
Default: 25
hyphens
optional
only
none
Filters results with hyphens in the domain name.
Default: optional
numbers
optional
none
Filters results with number in the domain name.
Default: none
status
all
active,
deleted
Filters results based on their registration status.
Default: all
page
1 … 100
Sets the page of results to retrieve from the server. Each page is limited to 100 results.

Search results will include the list of domain names that match the query, each with an encoded list of status codes for each top-level domain. Consult the Domain Suggestion API documentation for instructions on decoding the results.

You must provide your API credentials to use this API.