public
POST /v1/public/domains/search
Search domain availability without an account.
Authentication
This endpoint is public. It takes no credential and no organisation — it is what our own marketing site and AI answer engines read.
This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.
Try it
Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.
curl -X POST https://api.zinndigital.com/v1/public/domains/search \
-H "Content-Type: application/json" \
-d '{ "query": <string> }'Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console
Details
The guest half of `searchDomains`. Applies the **same selling rules** as the authenticated endpoint — a name is only tokenised when it is available, in a TLD we offer, registrable as a bare `SLD.TLD`, and priced (a premium name is priced from the registrar's live quote plus margin) — but checks at most **5** candidate extensions per request rather than 64, because every miss is a call to a paid registrar API made on behalf of an anonymous visitor. That limit bounds what the **caller asks for**; a bare name with no `tlds` expands to the curated default set (see `PublicDomainSearchRequest.tlds`) and is always inside it. Prices are returned in the currency requested by `X-Zinn-Currency` where one is available. The `token` on an available result is what `addPublicCartItem` requires.
Request body
| Name | Type | Required | What it is |
|---|---|---|---|
query | string | Yes | A base name (`acme`) checked across `tlds`, or one full FQDN (`acme.com`). |
tlds | string[] | No | Extensions to check the base name against. **At most 5** — each miss is a paid registrar lookup made for an anonymous visitor, and asking for more is a `422`, not a truncated an… |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
results | DomainSearchResult[] | Yes | — |
Errors this endpoint can return
422 · 429