{"openapi":"3.0.3","info":{"title":"World Domain Stats Public API","version":"1.0.0","description":"Free, read-only REST API for registered-domain counts across every ICANN gTLD and the major country-code TLDs — full monthly history, flows, registrar breakdown and registry activity, from primary sources. Responses use a { meta, data } envelope. Licensed CC BY 4.0. Rate limit 120 req/min/IP.","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"/api/v1"}],"paths":{"/stats":{"get":{"summary":"Global totals + coverage","parameters":[],"responses":{"200":{"description":"OK"}}}},"/tlds":{"get":{"summary":"List all TLDs","parameters":[{"name":"type","in":"query","schema":{"type":"string","enum":["gtld","cctld"]}},{"name":"sort","in":"query","schema":{"type":"string","enum":["total","yoy","mom","tld"]}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"]}},{"name":"q","in":"query","schema":{"type":"string"},"description":"filter by TLD or operator"},{"name":"limit","in":"query","schema":{"type":"integer"}},{"name":"offset","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"}}}},"/tlds/{tld}":{"get":{"summary":"Full history + flows + activity + zone for one TLD","parameters":[{"name":"tld","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/tlds/{tld}/registrars":{"get":{"summary":"Per-registrar breakdown for a gTLD","parameters":[{"name":"tld","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"}}}},"/registrars":{"get":{"summary":"Registrar families + top individual registrars","parameters":[],"responses":{"200":{"description":"OK"}}}},"/registrars/{iana_id}":{"get":{"summary":"One registrar's history + top TLDs","parameters":[{"name":"iana_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/rankings":{"get":{"summary":"Biggest, fastest-growing, fastest-shrinking","parameters":[{"name":"min_base","in":"query","schema":{"type":"integer"}},{"name":"limit","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"}}}},"/sources":{"get":{"summary":"Primary-source catalog","parameters":[],"responses":{"200":{"description":"OK"}}}},"/export/tlds.csv":{"get":{"summary":"Latest snapshot, all TLDs (CSV)","parameters":[],"responses":{"200":{"description":"OK"}}}},"/export/tlds.xlsx":{"get":{"summary":"Latest snapshot, all TLDs (Excel)","parameters":[],"responses":{"200":{"description":"OK"}}}},"/export/tlds/{tld}.csv":{"get":{"summary":"Full monthly history for a TLD (CSV)","parameters":[{"name":"tld","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/export/tlds/{tld}.xlsx":{"get":{"summary":"Full monthly history for a TLD (Excel)","parameters":[{"name":"tld","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/export/history.csv":{"get":{"summary":"Bulk — every TLD × every month (CSV)","parameters":[],"responses":{"200":{"description":"OK"}}}}}}