public
POST /v1/public/domains/search
Search domain availability without an account.
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
| Naam | Type | Verplicht | Wat dit is |
|---|---|---|---|
query | string | Ja | A base name (`acme`) checked across `tlds`, or one full FQDN (`acme.com`). |
tlds | string[] | Nee | 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… |
Reactie
| Naam | Type | Verplicht | Wat dit is |
|---|---|---|---|
results | DomainSearchResult[] | Ja | — |
Fouten die dit eindpunt kan retourneren
422 · 429