Loading…
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.
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. |
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>{
"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
}
]
}Single-domain detail: price, availability, and listing metadata.
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 }Fast yes/no availability check with price. Returns 200 with available: false rather than 404 for unlisted domains.
GET /api/partner/v1/availability?domain=custodylawyer.com
{
"domain": "custodylawyer.com",
"available": true,
"bin_price": 2500000,
"currency": "USD"
}Buy-now price for a specific domain. Returns 404 if the domain is not listed. Use this before quoting a buyer.
GET /api/partner/v1/pricing?domain=custodylawyer.com
{
"domain": "custodylawyer.com",
"bin_price": 2500000,
"currency": "USD"
}| 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.