Open a FREE Account| Log in | Help

DomainTools API Guide: Domain Suggestions

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 Suggestions API provides a list of domain names that are similar to the words in a query string. It has a bias toward available domains and provides suggestions for .com, .net, .org, .info, .biz, and .us top level domain names. 

  http://api.domaintools.com/v1/domain-suggestions/?query=domain%20tools
Domain Suggestion Parameters
Required Parameters
Value
query
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.

The API will always return the top twenty suggestions it can create for a given query string. Results include the suggested domain name and an encoded list of status codes for each top-level domain.

Domain Suggestion Responses
Response Element
Data Description
query: "domain tools"
The interpreted query string.
status_codes: {
w: "registered and active website"
p: "registered and parked or redirected"
x: "registered and no website"
d: "deleted and available again"
q: "never registered before"
g: "on-hold (redemption period)"
e: "on-hold (pending delete)"
h: "on-hold (generic)"
}
Map linking a status code to a status description. Use these descriptions to interpret the status codes that appear for each domain suggestion.
tlds: [
"COM"
"NET"
"ORG"
"INFO"
"BIZ"
"US"
]
List of top level domains (extensions) for which a status code will be provided in the list of domain suggestions.
suggestions: [
{
domain: "DomainToolsSite"
status: "xxdxxh"
}
…
List of domain suggestions, each with an encoded list of six letters in the status field. The letters map to a status code in the status_codes node, and their position maps to the position of a top level domain in the tlds response node.

For this hypothetical suggestion, the data can be interpreted as:
  • Available for registration:
    • DomainToolsSite.com
    • DomainToolsSite.net
    • DomainToolsSite.info
    • DomainToolsSite.biz
  • Deleted and available again:
    • DomainToolsSite.org
  • On-hold:
    • DomainToolsSite.us

You must provide your API credentials to use this API.

DomainTools API Guide