Loading…
Real-time search of Name.ai Domain Syndication Network inventory. Surface premium aftermarket domains inside your own search box. Authenticate every call with HMAC headers. Results are scoped to your credential's sandbox or live environment, and only include inventory sellers have opted into the DSN.
GET /api/partner/v1/domains/search?q=wallet&limit=20&sort=price_asc
Scope: search. A query term is required — there is no "return everything" mode.
| Param | Required | Notes |
|---|---|---|
| q | Yes | Search term, min 2 characters. There is no bulk-export mode. |
| limit | No | Default 20, max 50. |
| tld | No | Filter by TLD, e.g. com, ai. |
| minPrice / maxPrice | No | Price bounds in USD. |
| sort | No | price_asc (default), price_desc, name_asc. |
{
"query": "wallet",
"count": 1,
"limit": 20,
"results": [
{
"domain": "neonwallet.io",
"tld": "io",
"bin_price": 125000,
"currency": "USD",
"offers_accepted": true
}
]
}Seller identity and internal fields are never returned. Names a seller has not opted into the DSN are not searchable.
| HTTP | code | When |
|---|---|---|
| 400 | invalid_query | q missing or fewer than 2 characters. |
| 401 | invalid_signature / missing_signature_headers / invalid_timestamp / replay_detected | HMAC signing problem. |
| 403 | forbidden / credential_not_active / partner_not_active | Scope, credential, or account state. |
| 429 | rate_limited | Rate limit exceeded (Retry-After header). |