public

GET `/v1/public/domains/tld-pricing`

The public, searchable TLD price table.

प्रमाणीकरण

यो इन्डपइन्ट सार्वजनिक हो। यसले कुनै पनि प्रमाण पत्र र संस्था लिँदैन — यो हाम्रो आफ्नै मार्केटिङ साइट र AI उत्तर इन्जिनहरूले पढ्ने कुरा हो।

यो इन्डपोइन्टले कुनै संस्थाको आइडी लिँदैन। तपाईंको कुञ्जीले यस अन्तर्गत पर्ने संस्थालाई पहिल्यै पहिचान गर्छ, र प्रतिक्रिया त्यसैमा सीमित हुन्छ।

प्रयास गर्नुहोस्

कोणीय कोष्ठकभित्र भएका जुनसुकै कुरालाई आफ्नो मानहरूद्वारा बदल्नुहोस्, र मुख्य स्थानहोल्डरलाई तपाईंको ड्यासबोर्डको कुञ्जीद्वारा बदल्नुहोस्।

curl -X GET https://api.zinndigital.com/v1/public/domains/tld-pricing

लगइन गर्नुभएको छ? तपाईंको ड्यासबोर्डमा रहेको API कन्सोलले तपाईंको वास्तविक संस्थाको आईडी र आफ्नै कुञ्जी भरिदिन्छ, र लाइभ API विरुद्ध अनुरोध चलाउँछ ताकि तपाईंले वास्तविक प्रतिक्रिया हेर्न सक्नुहोस्। यो एन्डपोइन्टलाई API कन्सोलमा खोल्नुहोस्

विवरणहरू

The crawlable price surface docs/31 §5.1 specifies and nothing served: what every extension we sell costs to register, renew and transfer, plus the registry policy a buyer needs (min/max years, WHOIS privacy, IDN, restore, whether a transfer grants a year, and any residency restriction). No account, no cart, no registrar call — a cached read of platform-global reference data. Cursor-paged and searched server-side, which is now the only public shape: the older listTldPricing (GET /v1/domains/pricing) returned the whole catalogue in one uncursored body and was retired in wave 8 (issue #845). That was fine at fifteen TLDs and was issue #466 all over again at the ~1,500 the registrar sync imports — on an unauthenticated endpoint, which is the worst place to have one. q is a substring match on the label and tolerates a leading dot (.shop and shop find the same row). Ordered most popular first by default, because a visitor who has decided nothing wants .com before .zuerich; order=tld gives the alphabetical reference view. Inactive offers are never returned. summary appears on the first page only and carries active — how many extensions we sell, counted. Any surface stating "search across N extensions" must read it: a hardcoded number is a public claim that goes stale the first time the sync deactivates a registry. matched is the same count under the current filter, so a page can say both without either being wrong. related appears when q names an extension we actually sell, and carries the neighbours worth offering beside it — .shop returns .store and .online with their real prices — each row stamped with related_kind so the surface can make the argument rather than list names. Ranked by the same code as the domain-search upsell grid, and unlike that grid it costs no registrar call: a price table is a browse, not an availability check. Prices are USD, the catalogue's authored currency (docs/29); a public surface converts for display. Cacheable — strong ETag + Cache-Control: public, max-age=60.

प्यारामिटरहरू

नाम	प्रकार	आवश्यक	यो के हो
`q (query)`	`string`	हैन	Substring match on the TLD label. A leading dot is ignored.
`category (query)`	`string<gtld, new_gtld, cctld, sponsored>`	हैन	Restrict to one registry family.
`order (query)`	`string<popularity, tld>`	हैन	`popularity` (default) ranks the extensions a visitor is most likely to want first; `tld` is the alphabetical reference order.
`cursor (query)`	`string`	हैन	Opaque cursor from a previous page's `page.next_cursor`.
`limit (query)`	`integer`	हैन	Maximum items to return (page size).
`If-None-Match (header)`	`string`	हैन	A previously returned `ETag`; a match responds `304`.

प्रतिक्रिया

नाम	प्रकार	आवश्यक	यो के हो
`data`	`PublicTldPriceRow[]`	हुन्छ	—
`page`	`PageMeta`	हुन्छ	—
`summary`	`PublicTldPricingSummary`	हैन	Whole-collection facts, counted rather than derived from the page in hand. First page only.
`related`	`PublicTldPriceRow[]`	हैन	Neighbour extensions worth offering beside an exact-TLD `q`. Absent when `q` is empty, is not an extension we sell, or on any page but the first.

यो इन्डपोइन्टले फर्काउन सक्ने त्रुटिहरू

422 · 429

GET /v1/public/domains/tld-pricing