public

POST /v1/public/domains/search

Search domain availability without an account.

Alle public-eindpunten

Authenticatie

Dit eindpunt is openbaar. Het vereist geen inloggegevens en geen organisatie; het is wat onze eigen marketingwebsite en AI-antwoordmachines uitlezen.

Dit eindpunt vereist geen organisatie-id. Uw sleutel identificeert al de organisatie waartoe deze behoort, en het antwoord is hierop afgestemd.

Probeer het

Vervang alles tussen punthaakjes door uw eigen waarden en de sleutelplaatsvervanger door een sleutel uit uw dashboard.

curl -X POST https://api.zinndigital.com/v1/public/domains/search \
  -H "Content-Type: application/json" \
  -d '{ "query": <string> }'

Ingelogd? De API-console in je dashboard vult je echte organisatie-id en je eigen sleutel in, en voert het verzoek uit tegen de live API zodat je de daadwerkelijke respons kunt zien. Open dit eindpunt in de 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.

Aanvraaglichaam

NaamTypeVerplichtWat dit is
querystringJaA base name (`acme`) checked across `tlds`, or one full FQDN (`acme.com`).
tldsstring[]NeeExtensions 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…

Reactie

NaamTypeVerplichtWat dit is
resultsDomainSearchResult[]Ja

Fouten die dit eindpunt kan retourneren

422 · 429