{"openapi":"3.1.0","info":{"title":"TLD (Top-Level Domain) API","version":"1.0.0","description":"Every top-level domain in the IANA root zone as an API — the authoritative list a registrar, domain validator or analytics tool needs. For each TLD: whether it is a country-code TLD (ccTLD), a generic TLD (gTLD) or an internationalized (IDN) domain, its A-label, its Unicode form (e.g. xn--p1ai resolves to .рф) and, for ccTLDs, the country it belongs to. Validate a TLD or whole domain, find a country's ccTLD, filter by type, search, or list the entire root zone. Sourced from IANA's official tlds-alpha-by-domain.txt and served from memory — always fast.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/tld-api","description":"oanor gateway"}],"tags":[{"name":"Lookup"},{"name":"List"},{"name":"Search"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/country":{"get":{"operationId":"get_v1_country","tags":["Lookup"],"summary":"ccTLD for a country","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"Country name or ISO 3166-1 alpha-2 code","schema":{"type":"string"},"example":"de"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"tlds":[{"idn":false,"tld":"de","type":"cctld","country":"Germany","unicode":"de"}],"count":1,"country":"Germany"},"meta":{"timestamp":"2026-06-08T18:25:11.849Z","request_id":"baa3b79c-9838-435d-a8ea-343fae02c371"},"status":"ok","message":"Country ccTLD retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/tld":{"get":{"operationId":"get_v1_tld","tags":["Lookup"],"summary":"Look up / validate a TLD","description":"","parameters":[{"name":"tld","in":"query","required":true,"description":"A TLD or full domain","schema":{"type":"string"},"example":"com"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"tld":{"idn":false,"tld":"com","type":"gtld","unicode":"com"}},"meta":{"timestamp":"2026-06-08T18:25:11.967Z","request_id":"f2bf4649-d0a2-4701-9519-4e8b9a22a9f2"},"status":"ok","message":"TLD retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/list":{"get":{"operationId":"get_v1_list","tags":["List"],"summary":"List TLDs (optionally by type)","description":"","parameters":[{"name":"type","in":"query","required":false,"description":"Filter: cctld, gtld or idn","schema":{"type":"string"},"example":"cctld"},{"name":"limit","in":"query","required":false,"description":"Page size (1-2000)","schema":{"type":"string"},"example":"100"},{"name":"offset","in":"query","required":false,"description":"Offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"tlds":[{"idn":false,"tld":"ac","type":"cctld","country":"Ascension Island","unicode":"ac"},{"idn":false,"tld":"ad","type":"cctld","country":"Andorra","unicode":"ad"},{"idn":false,"tld":"ae","type":"cctld","country":"United Arab Emirates","unicode":"ae"},{"idn":false,"tld":"af","type":"cctld","country":"Afghanistan","unicode":"af"},{"idn":false,"tld":"ag","type":"cctld","country":"Antigua & Barbuda","unicode":"ag"},{"idn":false,"tld":"ai","type":"cctld","country":"Anguilla","unicode":"ai"},{"idn":false,"tld":"al","type":"cctld","country":"Albania","unicode":"al"},{"idn":false,"tld":"am","type":"cctld","country":"Armenia","unicode":"am"},{"idn":false,"tld":"ao","type":"cctld","country":"Angola","unicode":"ao"},{"idn":false,"tld":"aq","type":"cctld","country":"Antarctica","unicode":"aq"},{"idn":false,"tld":"ar","type":"cctld","country":"Argentina","unicode":"ar"},{"idn":false,"tld":"as","type":"cctld","country":"American Samoa","unicode":"as"},{"idn":false,"tld":"at","type":"cctld","country":"Austria","unicode":"at"},{"idn":false,"tld":"au","type":"cctld","country":"Australia","unicode":"au"},{"idn":false,"tld":"aw","type":"cctld","country":"Aruba","unicode":"aw"},{"idn":false,"tld":"ax","type":"cctld","country":"Åland Islands","unicode":"ax"},{"idn":false,"tld":"az","type":"cctld","country":"Azerbaijan","unicode":"az"},{"idn":false,"tld":"ba","type":"cctld","country":"Bosnia","unicode":"ba"},{"idn":false,"tld":"bb","type":"cctld","country":"Barbados","unicode":"bb"},{"idn":false,"tld":"bd","type":"cctld","country":"Bangladesh","unicode":"bd"},{"idn":false,"tld":"be","type":"cctld","country":"Belgium","unicode":"be"},{"idn":false,"tld":"bf","type":"cctld","country":"Burkina Faso","unicode":"bf"},{"idn":false,"tld":"bg","type":"cctld","country":"Bulgaria","unicode":"bg"},{"idn":false,"tld":"bh","type":"cctld","country":"Bahrain","unicode":"bh"},{"idn":false,"tld":"bi","type":"cctld","country":"Burundi","unicode":"bi"},{"idn":false,"tld":"bj","type":"cctld","country":"Benin","unicode":"bj"},{"idn":false,"tld":"bm","type":"cctld","country":"Bermuda","unicode":"bm"},{"idn":false,"tld":"bn","type":"cctld","country":"Brunei","unicode":"bn"},{"idn":false,"tld":"bo","type":"cctld","country":"Bolivia","unicode":"bo"},{"idn":false,"tld":"br","type":"cctld","country":"Brazil","unicode":"br"},{"idn":false,"tld":"bs","type":"cctld","country":"Bahamas","unicode":"bs"},{"idn":false,"tld":"bt","type":"cctld","country":"Bhutan","unicode":"bt"},{"idn":false,"tld":"bv","type":"cctld","country":"Bouvet Island","unicode":"bv"},{"idn":false,"tld":"bw","type":"cctld","country":"Botswana","unicode":"bw"},{"idn":false,"tld":"by","type":"cctld","country":"Belarus","unicode":"by"},{"idn":false,"tld":"bz","type":"cctld","country":"Belize","unicode":"bz"},{"idn":false,"tld":"ca","type":"cctld","country":"Canada","unicode":"ca"},{"idn":false,"tld":"cc","type":"cctld","country":"Cocos Islands","unicode":"cc"},{"idn":false,"tld":"cd","type":"cctld","country":"Congo - Kinshasa","unicode":"cd"},{"idn":false,"tld":"cf","type":"cctld","country":"Central African Republic","unicode":"cf"},{"idn":false,"tld":"cg","type":"cctld","country":"Congo - Brazzaville","unicode":"cg"},{"idn":false,"tld":"ch","type":"cctld","country":"Switzerland","unicode":"ch"},{"idn":false,"tld":"ci","type":"cctld","country":"Côte d’Ivoire","unicode":"ci"},{"idn":false,"tld":"ck","type":"cctld","country":"Cook Islands","unicode":"ck"},{"idn":false,"tld":"cl","type":"cctld","country":"Chile","unicode":"cl"},{"idn":false,"tld":"cm","type":"cctld","country":"Cameroon","unicode":"cm"},{"idn":false,"tld":"cn","type":"cctld","country":"China","unicode":"cn"},{"idn":false,"tld":"co","type":"cctld","country":"Colombia","unicode":"co"},{"idn":false,"tld":"cr","type":"cctld","country":"Costa Rica","unicode":"cr"},{"idn":false,"tld":"cu","type":"cctld","country":"Cuba","unicode":"cu"},{"idn":false,"tld":"cv","type":"cctld","country":"Cape Verde","unicode":"cv"},{"idn":false,"tld":"cw","type":"cctld","country":"Curaçao","unicode":"cw"},{"idn":false,"tld":"cx","type":"cctld","country":"Christmas Island","unicode":"cx"},{"idn":false,"tld":"cy","type":"cctld","country":"Cyprus","unicode":"cy"},{"idn":false,"tld":"cz","type":"cctld","country":"Czechia","unicode":"cz"},{"idn":false,"tld":"de","type":"cctld","country":"Germany","unicode":"de"},{"idn":false,"tld":"dj","type":"cctld","country":"Djibouti","unicode":"dj"},{"idn":false,"tld":"dk","type":"cctld","country":"Denmark","unicode":"dk"},{"idn":false,"tld":"dm","type":"cctld","country":"Dominica","unicode":"dm"},{"idn":false,"tld":"do","type":"cctld","country":"Dominican Republic","unicode":"do"},{"idn":false,"tld":"dz","type":"cctld","country":"Algeria","unicode":"dz"},{"idn":false,"tld":"ec","type":"cctld","country":"Ecuador","unicode":"ec"},{"idn":false,"tld":"ee","type":"cctld","country":"Estonia","unicode":"ee"},{"idn":false,"tld":"eg","type":"cctld","country":"Egypt","unicode":"eg"},{"idn":false,"tld":"er","type":"cctld","country":"Eritrea","unicode":"er"},{"idn":false,"tld":"es","type":"cctld","country":"Spain","unicode":"es"},{"idn":false,"tld":"et","type":"cctld","country":"Ethiopia","unicode":"et"},{"idn":false,"tld":"eu","type":"cctld","country":"European Union","unicode":"eu"},{"idn":false,"tld":"fi","type":"cctld","country":"Finland","unicode":"fi"},{"idn":false,"tld":"fj","type":"cctld","country":"Fiji","unicode":"fj"},{"idn":false,"tld":"fk","type":"cctld","country":"Falkland Islands","unicode":"fk"},{"idn":false,"tld":"fm","type":"cctld","country":"Micronesia","unicode":"fm"},{"idn":false,"tld":"fo","type":"cctld","country":"Faroe Islands","unicode":"fo"},{"idn":false,"tld":"fr","type":"cctld","country":"France","unicode":"fr"},{"idn":false,"tld":"ga","type":"cctld","country":"Gabon","unicode":"ga"},{"idn":false,"tld":"gb","type":"cctld","country":"United Kingdom of Great Britain and Northern Ireland","unicode":"gb"},{"idn":false,"tld":"gd","type":"cctld","country":"Grenada","unicode":"gd"},{"idn":false,"tld":"ge","type":"cctld","country":"Georgia","unicode":"ge"},{"idn":false,"tld":"gf","type":"cctld","country":"French Guiana","unicode":"gf"},{"idn":false,"tld":"gg","type":"cctld","country":"Guernsey","unicode":"gg"},{"idn":false,"tld":"gh","type":"cctld","country":"Ghana","unicode":"gh"},{"idn":false,"tld":"gi","type":"cctld","country":"Gibraltar","unicode":"gi"},{"idn":false,"tld":"gl","type":"cctld","country":"Greenland","unicode":"gl"},{"idn":false,"tld":"gm","type":"cctld","country":"Gambia","unicode":"gm"},{"idn":false,"tld":"gn","type":"cctld","country":"Guinea","unicode":"gn"},{"idn":false,"tld":"gp","type":"cctld","country":"Guadeloupe","unicode":"gp"},{"idn":false,"tld":"gq","type":"cctld","country":"Equatorial Guinea","unicode":"gq"},{"idn":false,"tld":"gr","type":"cctld","country":"Greece","unicode":"gr"},{"idn":false,"tld":"gs","type":"cctld","country":"South Georgia & South Sandwich Islands","unicode":"gs"},{"idn":false,"tld":"gt","type":"cctld","country":"Guatemala","unicode":"gt"},{"idn":false,"tld":"gu","type":"cctld","country":"Guam","unicode":"gu"},{"idn":false,"tld":"gw","type":"cctld","country":"Guinea-Bissau","unicode":"gw"},{"idn":false,"tld":"gy","type":"cctld","country":"Guyana","unicode":"gy"},{"idn":false,"tld":"hk","type":"cctld","country":"Hong Kong","unicode":"hk"},{"idn":false,"tld":"hm","type":"cctld","country":"Heard & McDonald Islands","unicode":"hm"},{"idn":false,"tld":"hn","type":"cctld","country":"Honduras","unicode":"hn"},{"idn":false,"tld":"hr","type":"cctld","country":"Croatia","unicode":"hr"},{"idn":false,"tld":"ht","type":"cctld","country":"Haiti","unicode":"ht"},{"idn":false,"tld":"hu","type":"cctld","country":"Hungary","unicode":"hu"},{"idn":false,"tld":"id","type":"cctld","country":"Indonesia","unicode":"id"}],"type":"cctld","count":100,"total":248},"meta":{"timestamp":"2026-06-08T18:25:12.097Z","request_id":"cc795e13-d371-4c80-9d42-b7877db9a34e"},"status":"ok","message":"TLDs listed successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Search"],"summary":"Search TLDs by label or country","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search query","schema":{"type":"string"},"example":"app"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"tlds":[{"idn":false,"tld":"app","type":"gtld","unicode":"app"},{"idn":false,"tld":"apple","type":"gtld","unicode":"apple"},{"idn":false,"tld":"zappos","type":"gtld","unicode":"zappos"}],"count":3,"query":"app","total":3},"meta":{"timestamp":"2026-06-08T18:25:12.228Z","request_id":"9149a816-06cf-413d-8165-2fd27b674b5b"},"status":"ok","message":"Search results retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"idn":151,"gtld":1038,"cctld":248,"service":"tld-api","endpoints":{"GET /v1/tld":"Look up / validate a TLD (tld=, e.g. com — also accepts a full domain).","GET /v1/list":"List TLDs, optionally by type (type=cctld|gtld|idn, limit, offset).","GET /v1/meta":"This document.","GET /v1/search":"Search TLDs by label or country (q=).","GET /v1/country":"ccTLD for a country (code=, e.g. de or Germany)."},"total_tlds":1437,"description":"IANA root-zone TLD reference: every current top-level domain with its type (ccTLD / gTLD / IDN), A-label, Unicode form and, for ccTLDs, the country. Source: IANA tlds-alpha-by-domain.txt. No key.","iana_version":"2026060800"},"meta":{"timestamp":"2026-06-08T18:25:12.326Z","request_id":"1c7ed8c3-41df-4ba3-9b52-7c019bab1016"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":30000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":400,"monthly_call_quota":300000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1100,"monthly_call_quota":1500000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":2800,"monthly_call_quota":7000000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/tld-api"}