public

POST `/v1/public/domains/suggest`

Alternative domains worth offering alongside a search.

ప్రమాణీకరణ

ఈ ఎండ్‌పాయింట్ పబ్లిక్. దీనికి ఎలాంటి ఆధారాలు మరియు సంస్థ అవసరం లేదు — మన స్వంత మార్కెటింగ్ సైట్ మరియు AI సమాధాన ఇంజిన్‌లు చదివేది ఇదే.

ఈ ఎండ్‌పాయింట్ ఎలాంటి సంస్థ ఐడీని తీసుకోదు. మీ కీ ఇప్పటికే అది ఏ సంస్థకు చెందుతుందో గుర్తిస్తుంది మరియు ప్రతిస్పందన దానికే పరిమితం చేయబడుతుంది.

ప్రయత్నించండి

కోణీయ బ్రాకెట్‌లలో ఉన్న దేన్నైనా మీ స్వంత విలువలతో భర్తీ చేయండి, మరియు కీ ప్లేస్‌హోల్డర్‌ను మీ డాష్‌బోర్డ్ నుండి తీసుకున్న కీతో భర్తీ చేయండి.

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

సైన్ ఇన్ చేశారా? మీ డ్యాష్‌బోర్డ్‌లోని API కాన్సోల్ మీ అసలైన సంస్థ ID మరియు మీ స్వంత కీని నింపుతుంది, అలాగే మీరు అసలైన ప్రతిస్పందనను చూడటానికి లైవ్ API ద్వారా ఆభ్యర్థనను రన్ చేస్తుంది. ఈ ఎండ్‌పాయింట్‌ను API కన్సోల్‌లో తెరిచండి

వివరాలు

The upsell grid (docs/31 §5.3). Ranked in tiers — brand protection (you are buying acme.com; somebody else buying acme.net can pass for you), then the regional extension for the visitor's country, then same-intent alternatives, then popular filler — and each row says which tier it came from, so a surface can make the argument rather than just list names. Every suggestion is priced and tokenised by exactly the same code path as searchPublicDomains: a grid price that came from anywhere else is a price the basket then refuses, at the moment the customer has already decided to buy. Its own endpoint rather than a field on the search response, because each suggestion is a paid registrar availability call: the primary result must not wait for the upsell, and the upsell must be skippable. It shares the search abuse budget — the two together are what one visitor's session costs us at the registrar. The visitor's country comes from Cloudflare's CF-IPCountry, an edge-set header the browser never sends, so no CORS allow-list entry is involved.

అభ్యర్థన బాడీ

పేరు	రకం	కావలసినది	ఇది ఏమిటి
`query`	`string`	అవును	The name the visitor searched — bare (`acme`) or full (`acme.com`).
`country`	`string`	కాదు	ISO-3166 alpha-2 hint, used only when the edge did not state the visitor's country. The `CF-IPCountry` header wins whenever it is present: it is set by the edge and cannot be…
`exclude`	`string[]`	కాదు	Names the primary search already answered. Each suggestion costs a paid registrar call, so re-checking a name already on the visitor's screen is money spent to tell them what they…
`limit`	`integer`	కాదు	Grid size. The maximum is the hard cap on anonymous vendor spend per request.

స్పందన

పేరు	రకం	కావలసినది	ఇది ఏమిటి
`results`	`DomainSearchResult[]`	అవును	—

ఈ ఎండ్‌పాయింట్ తిరిగి ఇవ్వగల లోపాలు

422 · 429

POST /v1/public/domains/suggest