About this endpoint
What it does
Returns a filtered, sorted list of TLDs together with pricing and registrar information for the cheapest available register, renew, transfer, and three-year options. You can narrow the result set with query parameters such as search text, type, category, limit, and offset.
Query Parameter(s)
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| q | String | No | Search query string. |
| sort | ENUM | No | Sort order. - popularity- price_asc- price_desc- tldDefault: popularity |
| type | String | No | TLD type filter. |
| limit | Integer | No | Number of results to return. Minimum: 1, maximum: 500. |
| offset | Integer | No | Number of results to skip. Minimum: 0. Default: 0. |
| category | String | No | Category filter. |
Response
Returns a JSON object with a data array of TLD objects and a meta object with pagination fields. Each item in data includes TLD metadata, popularity and registrar counts, and nullable cheapest-price objects; meta includes limit, total, and offset.
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| data | Object Array | Yes | List of TLD records. Each record contains: - id (String)- tld (String)- type (String)- category (String Array)- isRestricted (Boolean)- cheapestRenew (Object or null)- popularityRank (Integer)- registrarCount (Integer)- cheapestRegister (Object or null)- cheapestTransfer (Object or null)- cheapestThreeYear (Object or null)For the nested price objects, the schema defines price and registrar; registrar contains name and slug. |
| meta | Object | Yes | Pagination metadata containing limit (Integer), total (Integer), and offset (Integer). |



