public

POST /v1/public/domains/search

Search domain availability without an account.

Všechny koncové body public

Všechny dokumenty pro vývojáře

Autentizace

Tento koncový bod je veřejný. Nevyžaduje žádná pověření ani organizaci – je to to, co čte náš vlastní marketingový web a naše AI vyhledávače.

Tento koncový bod nevyžaduje žádné ID organizace. Váš klíč již identifikuje organizaci, ke které patří, a odpověď je na ni omezena.

Vyzvednout

Nahraďte cokoli v závorkách vlastními hodnotami a zástupný symbol klíče klíčem z vašeho řídicího panelu.

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

Přihlášeni? Konzole API ve vašem dashboardu automaticky doplní vaše skutečné ID organizace i váš vlastní klíč a odešle požadavek na živé API, abyste viděli reálnou odpověď. Otevřete tento koncový bod v konzoli API

Podrobnosti

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.

Tělo požadavku

NázevTypPožadovánoCo to je
querystringAnoA base name (acme) checked across tlds, or one full FQDN (acme.com).
tldsstring[]NeExtensions 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…

Odpověď

NázevTypPožadovánoCo to je
resultsDomainSearchResult[]Ano

Chyby, které může tento koncový bod vrátit

422 · 429