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 కాన్సోల్ మీ అసలైన సంస్థ ID మరియు మీ స్వంత కీని నింపుతుంది, అలాగే మీరు అసలైన ప్రతిస్పందనను చూడటానికి లైవ్ 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