Revision as of 22:29, 17 February 2013

GET /domains/{domainName}/namespinner

Get domain suggestions with multiple TLDs based on a single domain name.

The NameSpinner command returns suggestions in multiple TLDs, similar to the domain name supplied.
Currently, supported TLDs are com, net, cc and tv. This is a limitation of the back end. Additional
names availability for other TLDs can be checked using the standard domain availability check command.
The NameSpinner command can take parameters - currently maxResults, which specifies the number of results
for all supported TLDs, e.g. maxResults=3 will yield a total of 12 suggestions (for the 4 available TLDs).

Request

GET /domains/{domainName}/namespinner

Parameters

domainName

The domain name for which to get suggestions.

URI Parameters

maxResults - int

If specified controls the maximum number of suggestions per TLD.

useHyphens - boolean

If specified controls whether to use hyphens when generating suggestions.

useNumbers - boolean

If specified controls whether to use numbers when generating suggestions.

Request Headers

Accept

Allows the client to specify the preferred response content type. Currently supported values:

application/json

text/json

application/xml

Response

Status Code

200 OK

Success.

Response Body

{
  "suggestions": [
    {
      "name": "SomeCall",
      "tld": "com",
      "available": "false",
      "score": "785"
    },
    {
      "name": "SomeCall",
      "tld": "net",
      "available": "true",
      "score": "812"
    }
  ]
}
 

See also

• Domain Name Registration API
• Common Features