Skip to main content

suggest_domains

Derives domain names from a piece of text, mostly domain hacks — names where the TLD completes the word, such as ke.tt for "kett". It is the same generator the NameBeta search page uses for its suggestions.

Schema​

Input

FieldTypeRequiredConstraints
querystringYes1–64 characters

Output

Returned as structuredContent, and repeated as JSON in a text content block.

FieldTypeRequiredConstraints
querystringYes
resultsstring[]Yes

Behaviour​

  • query is text of up to 64 characters, usually a word or brand name. Leading and trailing spaces are trimmed.
  • The results are names only. They say nothing about whether a name is available: pass them to check_availability, in batches of up to 20.
  • A query can yield no results; results is then an empty array.

Example​

Arguments:

{ "query": "kettlory" }

Result:

{
"query": "kettlory",
"results": ["ket.tl", "ktt.lr", "ke.tt", "kt.tl", "k.et", "k.tt"]
}

Quota​

suggest_domains does not count against your quota, just like the suggestions on the website.

Errors​

SituationResult
query is empty or over 64 charactersTool error Input validation error: …
query cannot be read as a domain labelTool error Invalid domain format