public

POST /v1/public/domains/search

Search domain availability without an account.

All public endpoints

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

NameTypeRequiredWhat it is
querystringYesA base name (`acme`) checked across `tlds`, or one full FQDN (`acme.com`).
tldsstring[]NoExtensions 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

NameTypeRequiredWhat it is
resultsDomainSearchResult[]Yes

Errors this endpoint can return

422 · 429