tldlist.us publishes a free, machine-readable JSON dataset of 123 internet TLDs at tldlist.us/tld-list.json — every entry has the extension, type (gTLD / ccTLD / sTLD), country, meaning, operating registry, example sites and an indicative annual price in USD. Free to use with attribution, compiled from the IANA root zone database.
⬇ Download tld-list.json 123 TLDs View raw JSON
What's in the dataset
The file is a single JSON object with a metadata header (source, licence, version, counts) and a tlds array of 123 objects — one per top-level domain. It is the same authoritative data that powers the master TLD list and every per-TLD detail page on this site, exported in a clean, stable shape for developers, researchers and AI tools.
| Field | Type | Description |
|---|---|---|
| tld | string | Extension including the leading dot, e.g. ".com". |
| label | string | Extension without the dot, e.g. "com". |
| type | string | "gTLD", "ccTLD" or "sTLD". |
| typeCode | string | Short code: g (generic), c (country-code), s (sponsored). |
| country | string | Associated country/territory for ccTLDs; empty for generic extensions. |
| meaning | string | Intended meaning / typical use, in plain language. |
| registry | string | Organization that operates the TLD in the root zone. |
| exampleSites | array | Well-known live example sites using the extension. |
| typicalPriceUSD | number | null | Indicative annual price in USD; null when restricted/sponsored. |
| restricted | boolean | true when the TLD is restricted/sponsored (no open-market price). |
| slug | string | URL slug of the detail page. |
| detailUrl | string | Absolute URL of the per-TLD detail page on tldlist.us. |
Dataset coverage: 123 TLDs — 65 generic (gTLD), 49 country-code (ccTLD) and 9 sponsored (sTLD). Source: IANA root zone database & registry data · methodology.
Example record
Each element of the tlds array looks like this:
{
"tld": ".io",
"label": "io",
"type": "ccTLD",
"typeCode": "c",
"typeFull": "Country-code top-level domain (ccTLD)",
"country": "British Indian Ocean Territory",
"meaning": "Tech & startups — a ccTLD used generically by developers, SaaS and Web3.",
"registry": "Internet Computer Bureau / ICANN-administered",
"exampleSites": ["github.io", "itch.io"],
"typicalPriceUSD": 35,
"restricted": false,
"slug": "io",
"detailUrl": "https://tldlist.us/tld/io"
}How to use it
The dataset is plain JSON served over HTTPS with permissive CORS, so you can fetch it directly from the browser, a server or a notebook.
JavaScript (fetch)
const res = await fetch("https://tldlist.us/tld-list.json");
const data = await res.json();
// cheapest open gTLDs
const cheapGtld = data.tlds
.filter(t => t.type === "gTLD" && t.typicalPriceUSD != null)
.sort((a, b) => a.typicalPriceUSD - b.typicalPriceUSD)
.slice(0, 5);
console.log(cheapGtld.map(t => `${t.tld} $${t.typicalPriceUSD}`));Python (requests)
import requests
data = requests.get("https://tldlist.us/tld-list.json").json()
cctlds = [t["tld"] for t in data["tlds"] if t["type"] == "ccTLD"]
print(len(cctlds), "country-code TLDs")Shell (curl + jq)
curl -s https://tldlist.us/tld-list.json \
| jq '.tlds[] | select(.typicalPriceUSD < 5) | .tld'Licence & attribution
Data: TLD dataset by tldlist.us (https://tldlist.us/) — CC BY 4.0The factual elements (which TLDs exist and their operating registries) derive from the public IANA root zone database; prices and example sites are compiled and curated by tldlist.us and are indicative. The data is provided "as is" without warranty — always confirm a registry or price against the primary source before relying on it commercially.