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

Rank domain candidates with Jev

Returns independent domain-name fit scores from 0 to 4 and confidence from 0 to 1. Scores do not establish availability, pricing or trademark clearance.

POST/v1/domains/research/rank
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
querystringrequired
min length 1 · max length 12000
domainsstring[]required
min items 1 · max items 100
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
scoresobject[]required
max items 100
Show properties
Array of object
scorenumberrequired
min 0 · max 4
confidencenumberrequired
min 0 · max 1
domainstringrequired
max length 253
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/research/rank' \
  -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",
  "query": "string",
  "domains": [
    "string"
  ]
}'
Response
{
  "$schema": "http://example.com",
  "data": {
    "scores": [
      {
        "score": 0,
        "confidence": 0,
        "domain": "string"
      }
    ]
  }
}

Was this page helpful?