Skip to content
Docs
Esc
↑↓navigate↵open⌘Jpreview

Generate domain name ideas

Returns creative domain name ideas derived from a search query.

GET/v1/domains/research/ideas
Authorization

Optional — this operation also accepts unauthenticated requests.

AuthorizationBearer token · header

Better Auth session, OAuth access token, OAuth client-credentials token, or sfm_ Space machine credential.

or
__Host-better-auth.session_tokenAPI key · cookie

Signed-in browser session, set by the dashboard sign-in flow. An operation that declares only this one needs a person behind the request: an API key or machine credential is refused. The same session token is also accepted as Authorization: Bearer.

Query parameters
teamIdstring

Optional team context. Requires access to the team.

min length 1
qstringrequired

What the domain is for: a word, a brand, or a short phrase.

min length 1 · max length 120
limitinteger

Maximum suggestions to return.

min 1 · max 160 · default: 96
Responses
200

Response for status 200

$schemastring<uri>

Canonical JSON Schema URL for this response body. The server also sends it in the Link: rel="describedby" response header.

dataobjectrequired
Show properties
querystringrequired
suggestionsobject[]required
Show properties
Array of object
domainstringrequired
labelstringrequired
sldstringrequired
tldstringrequired
sourcestringrequired
Allowed:exacttldhackvariantai
categorystringrequired
Allowed:bestfastcreativeideasshortclassicall
scorenumberrequired
supportedForPurchasebooleanrequired
purchasablebooleanrequired
connectablebooleanrequired
reasonstringrequired
default

Problem details (RFC 9457). Any 4xx/5xx response is one application/problem+json document.

$schemastring<uri>

Canonical JSON Schema URL for this response body. The server also sends it in the Link: rel="describedby" response header.

typestringrequired

Problem type URI resolving to the error docs page. The server derives it mechanically from code against the docs origin.

titlestringrequired

Short human-readable summary of the problem type. The server derives it mechanically from code.

statusintegerrequired

HTTP status code of this response, repeated in the body.

min -9007199254740991 · max 9007199254740991
detailstringrequired

Human-readable failure explanation for this occurrence.

codestringrequired

Stable snake_case error code naming the failed public contract.

pointerstring

RFC 6901 JSON Pointer into the failing request field, for example "/files/37/path", on validation failures.

detailsobject

Machine-readable context for the error code.

fixstring

One sentence on what to do about this error code, the same text as the type page. Read it before retrying.

suggestionsstring[]

Actionable recovery steps safe to show in dashboards, SDKs, and CLI output.

nextstring[]

Copy-pasteable commands or API requests an agent can run next.

requestIdstringrequired

The request id to quote when contacting support.

Try it
Server
Authorization (optional)
Parameters
Request
curl -X GET 'https://api.spacefast.com/v1/domains/research/ideas?q=string' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'
Response
{
  "$schema": "http://example.com",
  "data": {
    "query": "string",
    "suggestions": [
      {
        "domain": "string",
        "label": "string",
        "sld": "string",
        "tld": "string",
        "source": "exact",
        "category": "best",
        "score": 0,
        "supportedForPurchase": true,
        "purchasable": true,
        "connectable": true,
        "reason": "string"
      }
    ]
  }
}

Was this page helpful?