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

Search domain names with the operator in a conversation

Find domain names with the dashboard’s search workflow. A single keyword returns exact domain matches and domain hacks. A naming brief generates suggestions. Each search checks availability and Jev scores. The workflow replaces unavailable generated names. Refine the search with messages, likes, dislikes and selections. Carry the returned session unchanged into the next call. Use stable suggestion IDs for feedback. Display prices include the same fees as the dashboard. If complete is false, inspect problems. To resume, send the returned session without a new message. Confirm availability again before registration.

POST/v1/domains/search
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.

Request body
requiredapplication/json
analyticsobject
Show properties
sessionIdstring<uuid>required
matches ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
traceIdstring<uuid>required
matches ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
anonymousIdstringrequired
min length 1 · max length 128 · matches ^[A-Za-z0-9_-]+$
pathstringrequired
min length 1 · max length 2048 · matches ^\/(?:[^/?#]+\/){0,2}domains(?:\/[^?#]*)?$
teamIdstring
min length 1
messagestring

The operator's naming brief or follow-up. Omit to apply feedback or resume incomplete work.

min length 1 · max length 12000
sessionobject

Carry the complete returned session unchanged between turns.

Show properties
versionnumberrequired
teamIdstring
min length 1
intentstring
Allowed:conversationgenerateregister
messagesobject[]required
max items 80
Show properties
Array of object
rolestringrequired
Allowed:userassistant
contentstringrequired
min length 1 · max length 12000
localboolean
kindstring
suggestionsobject[]required
max items 200
Show properties
Array of object
domainstringrequired
max length 253
reasonstringrequired
min length 1 · max length 2000
scorenumberrequired
min 0 · max 100
idstringrequired
min length 1 · max length 253
numberintegerrequired
min 1 · max 100000
selectedbooleanrequired
tastestringrequired
Allowed:neutrallikeddisliked
availabilitystringrequired
Allowed:uncheckedcheckingunregisteredregisteredunknown
sellableboolean
jevobject
Show properties
scorenumberrequired
min 0 · max 4
confidencenumberrequired
min 0 · max 1
retiredboolean
sourcestring
hideDescriptionboolean
checkedAtstring<date-time>
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
availabilitySourcestring
Allowed:dsapirdaplocal
availabilityModestring
Allowed:zonelive
priceobject | null
Show properties
Any of:
object
amountnumberrequired
min 0
formattedstringrequired
max length 40
currencystringrequired
min length 1 · max length 8
null
null
rankingstringrequired
Allowed:pendingscoringscorederror
pendingobject
Show properties
bodyobjectrequired

The unchanged input for a generation pass that has not completed.

Show properties
teamIdstring
min length 1
phasestringrequired
Allowed:initialenrichmentrefinementreplacementconversation
automaticboolean
poolPolicystring

Request ranked available pools. Omit this field to keep neutral replacement limits.

messagesobject[]required
min items 1 · max items 80
Show properties
Array of object
rolestringrequired
Allowed:userassistant
contentstringrequired
min length 1 · max length 12000
suggestionsobject[]required
max items 200
Show properties
Array of object
domainstringrequired
max length 253
reasonstringrequired
min length 1 · max length 2000
scorenumberrequired
min 0 · max 100
idstringrequired
min length 1 · max length 253
numberintegerrequired
min 1 · max 100000
selectedbooleanrequired
tastestringrequired
Allowed:neutrallikeddisliked
availabilitystringrequired
Allowed:uncheckedcheckingunregisteredregisteredunknown
sellableboolean
jevobject
Show properties
scorenumberrequired
min 0 · max 4
confidencenumberrequired
min 0 · max 1
retiredboolean
sourcestring
hideDescriptionboolean
acceptedIdsstring[]

Suggestion IDs that this pass added. Other concurrent passes do not use its budget.

max items 200
baselineIdsstring[]required

Suggestion IDs present before this pass, used to preserve its generation budget after retry.

max items 200
slotsstring[]required

The original unavailable suggestion IDs that replacement may retire.

max items 200
replacementobject
Show properties
bodyobjectrequired

The unchanged input for a generation pass that has not completed.

Show properties
teamIdstring
min length 1
phasestringrequired
Allowed:initialenrichmentrefinementreplacementconversation
automaticboolean
poolPolicystring

Request ranked available pools. Omit this field to keep neutral replacement limits.

messagesobject[]required
min items 1 · max items 80
Show properties
Array of object
rolestringrequired
Allowed:userassistant
contentstringrequired
min length 1 · max length 12000
suggestionsobject[]required
max items 200
Show properties
Array of object
domainstringrequired
max length 253
reasonstringrequired
min length 1 · max length 2000
scorenumberrequired
min 0 · max 100
idstringrequired
min length 1 · max length 253
numberintegerrequired
min 1 · max 100000
selectedbooleanrequired
tastestringrequired
Allowed:neutrallikeddisliked
availabilitystringrequired
Allowed:uncheckedcheckingunregisteredregisteredunknown
sellableboolean
jevobject
Show properties
scorenumberrequired
min 0 · max 4
confidencenumberrequired
min 0 · max 1
retiredboolean
sourcestring
hideDescriptionboolean
acceptedIdsstring[]

Suggestion IDs that this pass added. Other concurrent passes do not use its budget.

max items 200
baselineIdsstring[]required

Suggestion IDs present before this pass, used to preserve its generation budget after retry.

max items 200
slotsstring[]required

The original unavailable suggestion IDs that replacement may retire.

max items 200
feedbackobject[]
min items 1 · max items 200
Show properties
Array of object
idstringrequired

Stable suggestion ID from the returned session; display reference numbers are only for people.

min length 1 · max length 253
tastestring
Allowed:neutrallikeddisliked
selectedboolean
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
intentstring
Allowed:conversationgenerateregister
messagestringrequired
min length 1 · max length 12000
sessionobjectrequired
Show properties
versionnumberrequired
teamIdstring
min length 1
intentstring
Allowed:conversationgenerateregister
messagesobject[]required
max items 80
Show properties
Array of object
rolestringrequired
Allowed:userassistant
contentstringrequired
min length 1 · max length 12000
localboolean
kindstring
suggestionsobject[]required
max items 200
Show properties
Array of object
domainstringrequired
max length 253
reasonstringrequired
min length 1 · max length 2000
scorenumberrequired
min 0 · max 100
idstringrequired
min length 1 · max length 253
numberintegerrequired
min 1 · max 100000
selectedbooleanrequired
tastestringrequired
Allowed:neutrallikeddisliked
availabilitystringrequired
Allowed:uncheckedcheckingunregisteredregisteredunknown
sellableboolean
jevobject
Show properties
scorenumberrequired
min 0 · max 4
confidencenumberrequired
min 0 · max 1
retiredboolean
sourcestring
hideDescriptionboolean
checkedAtstring<date-time>
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
availabilitySourcestring
Allowed:dsapirdaplocal
availabilityModestring
Allowed:zonelive
priceobject | null
Show properties
Any of:
object
amountnumberrequired
min 0
formattedstringrequired
max length 40
currencystringrequired
min length 1 · max length 8
null
null
rankingstringrequired
Allowed:pendingscoringscorederror
pendingobject
Show properties
bodyobjectrequired

The unchanged input for a generation pass that has not completed.

Show properties
teamIdstring
min length 1
phasestringrequired
Allowed:initialenrichmentrefinementreplacementconversation
automaticboolean
poolPolicystring

Request ranked available pools. Omit this field to keep neutral replacement limits.

messagesobject[]required
min items 1 · max items 80
Show properties
Array of object
rolestringrequired
Allowed:userassistant
contentstringrequired
min length 1 · max length 12000
suggestionsobject[]required
max items 200
Show properties
Array of object
domainstringrequired
max length 253
reasonstringrequired
min length 1 · max length 2000
scorenumberrequired
min 0 · max 100
idstringrequired
min length 1 · max length 253
numberintegerrequired
min 1 · max 100000
selectedbooleanrequired
tastestringrequired
Allowed:neutrallikeddisliked
availabilitystringrequired
Allowed:uncheckedcheckingunregisteredregisteredunknown
sellableboolean
jevobject
Show properties
scorenumberrequired
min 0 · max 4
confidencenumberrequired
min 0 · max 1
retiredboolean
sourcestring
hideDescriptionboolean
acceptedIdsstring[]

Suggestion IDs that this pass added. Other concurrent passes do not use its budget.

max items 200
baselineIdsstring[]required

Suggestion IDs present before this pass, used to preserve its generation budget after retry.

max items 200
slotsstring[]required

The original unavailable suggestion IDs that replacement may retire.

max items 200
replacementobject
Show properties
bodyobjectrequired

The unchanged input for a generation pass that has not completed.

Show properties
teamIdstring
min length 1
phasestringrequired
Allowed:initialenrichmentrefinementreplacementconversation
automaticboolean
poolPolicystring

Request ranked available pools. Omit this field to keep neutral replacement limits.

messagesobject[]required
min items 1 · max items 80
Show properties
Array of object
rolestringrequired
Allowed:userassistant
contentstringrequired
min length 1 · max length 12000
suggestionsobject[]required
max items 200
Show properties
Array of object
domainstringrequired
max length 253
reasonstringrequired
min length 1 · max length 2000
scorenumberrequired
min 0 · max 100
idstringrequired
min length 1 · max length 253
numberintegerrequired
min 1 · max 100000
selectedbooleanrequired
tastestringrequired
Allowed:neutrallikeddisliked
availabilitystringrequired
Allowed:uncheckedcheckingunregisteredregisteredunknown
sellableboolean
jevobject
Show properties
scorenumberrequired
min 0 · max 4
confidencenumberrequired
min 0 · max 1
retiredboolean
sourcestring
hideDescriptionboolean
acceptedIdsstring[]

Suggestion IDs that this pass added. Other concurrent passes do not use its budget.

max items 200
baselineIdsstring[]required

Suggestion IDs present before this pass, used to preserve its generation budget after retry.

max items 200
slotsstring[]required

The original unavailable suggestion IDs that replacement may retire.

max items 200
suggestionsobject[]required
max items 200
Show properties
Array of object
domainstringrequired
max length 253
reasonstringrequired
min length 1 · max length 2000
scorenumberrequired
min 0 · max 100
idstringrequired
min length 1 · max length 253
numberintegerrequired
min 1 · max 100000
selectedbooleanrequired
tastestringrequired
Allowed:neutrallikeddisliked
availabilitystringrequired
Allowed:uncheckedcheckingunregisteredregisteredunknown
sellableboolean
jevobject
Show properties
scorenumberrequired
min 0 · max 4
confidencenumberrequired
min 0 · max 1
retiredboolean
sourcestring
hideDescriptionboolean
checkedAtstring<date-time>
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
availabilitySourcestring
Allowed:dsapirdaplocal
availabilityModestring
Allowed:zonelive
priceobject | null
Show properties
Any of:
object
amountnumberrequired
min 0
formattedstringrequired
max length 40
currencystringrequired
min length 1 · max length 8
null
null
rankingstringrequired
Allowed:pendingscoringscorederror
referenceintegerrequired

Current displayed row number. Use id for durable feedback.

min 1 · max 9007199254740991
displayPriceobject | nullrequired

First-year price including fees, matching the dashboard; null when no quote exists.

Show properties
Any of:
object
amountnumberrequired
min 0
formattedstringrequired
max length 40
currencystringrequired
min length 1 · max length 8
null
null
topPickstring | nullrequired
completebooleanrequired

False when a stage needs retry. Keep this session and inspect problems.

problemsobject[]required
Show properties
Array of object
stagestringrequired
Allowed:intentgenerationrankingavailabilityreplacement
codestringrequired
min length 1
messagestringrequired
min length 1
retryAfterSecondsnumber
min 0
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)
Bodyapplication/json
Request
curl -X POST 'https://api.spacefast.com/v1/domains/search' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "analytics": {
    "sessionId": "f6567dd8-e069-418e-8893-7d22fcf12459",
    "traceId": "729bb1bf-882d-483b-89d3-5855dc5af3aa",
    "anonymousId": "string",
    "path": "string"
  },
  "teamId": "string",
  "message": "string",
  "session": {
    "version": 1,
    "teamId": "string",
    "intent": "conversation",
    "messages": [
      {
        "role": "user",
        "content": "string",
        "local": true,
        "kind": "feedback"
      }
    ],
    "suggestions": [
      {
        "domain": "string",
        "reason": "string",
        "score": 0,
        "id": "string",
        "number": 1,
        "selected": true,
        "taste": "neutral",
        "availability": "unchecked",
        "sellable": true,
        "jev": {
          "score": 0,
          "confidence": 0
        },
        "retired": true,
        "source": "instant",
        "hideDescription": true,
        "checkedAt": "2019-08-24T14:15:22Z",
        "availabilitySource": "dsapi",
        "availabilityMode": "zone",
        "price": {
          "amount": 0,
          "formatted": "string",
          "currency": "string"
        },
        "ranking": "pending"
      }
    ],
    "pending": {
      "body": {
        "teamId": "string",
        "phase": "initial",
        "automatic": true,
        "poolPolicy": "ranked-available",
        "messages": [
          {
            "role": "user",
            "content": "string"
          }
        ],
        "suggestions": [
          {
            "domain": "string",
            "reason": "string",
            "score": 0,
            "id": "string",
            "number": 1,
            "selected": true,
            "taste": "neutral",
            "availability": "unchecked",
            "sellable": true,
            "jev": {
              "score": 0,
              "confidence": 0
            },
            "retired": true,
            "source": "instant",
            "hideDescription": true
          }
        ]
      },
      "acceptedIds": [
        "string"
      ],
      "baselineIds": [
        "string"
      ],
      "slots": [
        "string"
      ]
    },
    "replacement": {
      "body": {
        "teamId": "string",
        "phase": "initial",
        "automatic": true,
        "poolPolicy": "ranked-available",
        "messages": [
          {
            "role": "user",
            "content": "string"
          }
        ],
        "suggestions": [
          {
            "domain": "string",
            "reason": "string",
            "score": 0,
            "id": "string",
            "number": 1,
            "selected": true,
            "taste": "neutral",
            "availability": "unchecked",
            "sellable": true,
            "jev": {
              "score": 0,
              "confidence": 0
            },
            "retired": true,
            "source": "instant",
            "hideDescription": true
          }
        ]
      },
      "acceptedIds": [
        "string"
      ],
      "baselineIds": [
        "string"
      ],
      "slots": [
        "string"
      ]
    }
  },
  "feedback": [
    {
      "id": "string",
      "taste": "neutral",
      "selected": true
    }
  ]
}'
Response
{
  "$schema": "http://example.com",
  "data": {
    "intent": "conversation",
    "message": "string",
    "session": {
      "version": 1,
      "teamId": "string",
      "intent": "conversation",
      "messages": [
        {
          "role": "user",
          "content": "string",
          "local": true,
          "kind": "feedback"
        }
      ],
      "suggestions": [
        {
          "domain": "string",
          "reason": "string",
          "score": 0,
          "id": "string",
          "number": 1,
          "selected": true,
          "taste": "neutral",
          "availability": "unchecked",
          "sellable": true,
          "jev": {
            "score": 0,
            "confidence": 0
          },
          "retired": true,
          "source": "instant",
          "hideDescription": true,
          "checkedAt": "2019-08-24T14:15:22Z",
          "availabilitySource": "dsapi",
          "availabilityMode": "zone",
          "price": {
            "amount": 0,
            "formatted": "string",
            "currency": "string"
          },
          "ranking": "pending"
        }
      ],
      "pending": {
        "body": {
          "teamId": "string",
          "phase": "initial",
          "automatic": true,
          "poolPolicy": "ranked-available",
          "messages": [
            {
              "role": "user",
              "content": "string"
            }
          ],
          "suggestions": [
            {
              "domain": "string",
              "reason": "string",
              "score": 0,
              "id": "string",
              "number": 1,
              "selected": true,
              "taste": "neutral",
              "availability": "unchecked",
              "sellable": true,
              "jev": {
                "score": 0,
                "confidence": 0
              },
              "retired": true,
              "source": "instant",
              "hideDescription": true
            }
          ]
        },
        "acceptedIds": [
          "string"
        ],
        "baselineIds": [
          "string"
        ],
        "slots": [
          "string"
        ]
      },
      "replacement": {
        "body": {
          "teamId": "string",
          "phase": "initial",
          "automatic": true,
          "poolPolicy": "ranked-available",
          "messages": [
            {
              "role": "user",
              "content": "string"
            }
          ],
          "suggestions": [
            {
              "domain": "string",
              "reason": "string",
              "score": 0,
              "id": "string",
              "number": 1,
              "selected": true,
              "taste": "neutral",
              "availability": "unchecked",
              "sellable": true,
              "jev": {
                "score": 0,
                "confidence": 0
              },
              "retired": true,
              "source": "instant",
              "hideDescription": true
            }
          ]
        },
        "acceptedIds": [
          "string"
        ],
        "baselineIds": [
          "string"
        ],
        "slots": [
          "string"
        ]
      }
    },
    "suggestions": [
      {
        "domain": "string",
        "reason": "string",
        "score": 0,
        "id": "string",
        "number": 1,
        "selected": true,
        "taste": "neutral",
        "availability": "unchecked",
        "sellable": true,
        "jev": {
          "score": 0,
          "confidence": 0
        },
        "retired": true,
        "source": "instant",
        "hideDescription": true,
        "checkedAt": "2019-08-24T14:15:22Z",
        "availabilitySource": "dsapi",
        "availabilityMode": "zone",
        "price": {
          "amount": 0,
          "formatted": "string",
          "currency": "string"
        },
        "ranking": "pending",
        "reference": 1,
        "displayPrice": {
          "amount": 0,
          "formatted": "string",
          "currency": "string"
        }
      }
    ],
    "topPick": "string",
    "complete": true,
    "problems": [
      {
        "stage": "intent",
        "code": "string",
        "message": "string",
        "retryAfterSeconds": 0
      }
    ]
  }
}

Was this page helpful?