인증
이 엔드포인트는 공개되어 있습니다. 자격 증명이나 조직 정보가 필요하지 않으며, 당사의 마케팅 사이트와 AI 답변 엔진이 읽는 것과 동일합니다.
이 엔드포인트는 조직 ID를 받지 않습니다. 사용자의 키가 이미 속한 조직을 식별하며, 응답은 해당 조직으로 한정됩니다.
무료 체험하기
대괄호 안에 있는 모든 내용을 사용자 지정 값으로 바꾸고, 키 플레이스홀더는 대시보드의 키로 바꾸세요.
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