Search & pricing

Four endpoints let you search inventory, look up a single domain, check availability, and fetch the exact buy-now price. All require the search scope.

GET

/api/partner/v1/domains/search

Hybrid semantic + keyword search over DSN inventory. Returns up to 5 genuinely-relevant results — no bulk export. A query term is required.

Parameter	Required	Description
q	Yes	Search term, minimum 2 characters.
limit	No	Max results to return (1–5, default 5).
tld	No	Filter by TLD e.g. com, ai, io.
min_price / max_price	No	Price bounds in USD cents.

Example request

GET /api/partner/v1/domains/search?q=crypto&limit=3
X-NameAI-Key-Id: pk_live_xxx
X-NameAI-Timestamp: 1714309200
X-NameAI-Nonce: <uuid>
X-NameAI-Signature: v1=<hmac>

Response 200

{
  "query": "crypto",
  "count": 2,
  "results": [
    {
      "domain": "cryptovault.io",
      "tld": "io",
      "bin_price": 850000,
      "currency": "USD",
      "available": true
    },
    {
      "domain": "cryptolend.ai",
      "tld": "ai",
      "bin_price": 1200000,
      "currency": "USD",
      "available": true
    }
  ]
}

GET

/api/partner/v1/domains/{name}

Single-domain detail: price, availability, and listing metadata.

Example

GET /api/partner/v1/domains/custodylawyer.com

// 200 — available
{
  "domain": "custodylawyer.com",
  "available": true,
  "bin_price": 2500000,
  "currency": "USD"
}

// 200 — not available
{ "domain": "taken.com", "available": false }

GET

/api/partner/v1/availability

Fast yes/no availability check with price. Returns 200 with available: false rather than 404 for unlisted domains.

Example

GET /api/partner/v1/availability?domain=custodylawyer.com

{
  "domain": "custodylawyer.com",
  "available": true,
  "bin_price": 2500000,
  "currency": "USD"
}

GET

/api/partner/v1/pricing

Buy-now price for a specific domain. Returns 404 if the domain is not listed. Use this before quoting a buyer.

Example

GET /api/partner/v1/pricing?domain=custodylawyer.com

{
  "domain": "custodylawyer.com",
  "bin_price": 2500000,
  "currency": "USD"
}

Common errors

HTTP	Code	Cause
400	invalid_query	q missing or fewer than 2 characters.
401	invalid_signature	HMAC signing problem — see Authentication.
403	forbidden	Credential missing search scope.
404	not_found	Domain not listed (pricing endpoint only).
429	rate_limited	Rate limit exceeded. Check Retry-After header.

Next: MoR order flow or Pay with name.ai.