{"openapi":"3.1.0","info":{"title":"ConnectDomain public API","version":"1.0.0","description":"Read-only figures about domain registrars and TLDs. Responses are cached for an hour and limited per IP address. No open licence has been chosen for this dataset yet. Credit ConnectDomain (connectdomain.app) and the named sources when you reuse it, and check each source's own terms. Figures can be late or wrong; unknown values are left empty, never guessed."},"servers":[{"url":"https://connectdomain-app.vercel.app"}],"paths":{"/api/v1/registrars":{"get":{"summary":"List registrars","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"A page of registrars.","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"type":"object","properties":{"source":{"type":"string","description":"Where the figures come from."},"as_of":{"type":["string","null"],"description":"The date of the data: the report month, or the date the directory last copied the records."},"licence":{"type":"string"},"site":{"type":"string"},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}}},"data":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"429":{"description":"Too many requests from this IP address. Retry after the number of seconds in the Retry-After header."}}}},"/api/v1/registrars/{slug}":{"get":{"summary":"One registrar with its history, features and prices","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]{1,80}$"}}],"responses":{"200":{"description":"A registrar.","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"type":"object","properties":{"source":{"type":"string","description":"Where the figures come from."},"as_of":{"type":["string","null"],"description":"The date of the data: the report month, or the date the directory last copied the records."},"licence":{"type":"string"},"site":{"type":"string"},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}}},"data":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"The slug or label is not valid."},"404":{"description":"Not found."},"429":{"description":"Too many requests from this IP address. Retry after the number of seconds in the Retry-After header."}}}},"/api/v1/tlds":{"get":{"summary":"List TLDs","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"A page of TLDs.","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"type":"object","properties":{"source":{"type":"string","description":"Where the figures come from."},"as_of":{"type":["string","null"],"description":"The date of the data: the report month, or the date the directory last copied the records."},"licence":{"type":"string"},"site":{"type":"string"},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}}},"data":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"429":{"description":"Too many requests from this IP address. Retry after the number of seconds in the Retry-After header."}}}},"/api/v1/tlds/{label}":{"get":{"summary":"One TLD with its top registrars and history","parameters":[{"name":"label","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]{1,63}$"},"description":"The TLD without the dot, for example com."}],"responses":{"200":{"description":"A TLD.","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"type":"object","properties":{"source":{"type":"string","description":"Where the figures come from."},"as_of":{"type":["string","null"],"description":"The date of the data: the report month, or the date the directory last copied the records."},"licence":{"type":"string"},"site":{"type":"string"},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}}},"data":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"The slug or label is not valid."},"404":{"description":"Not found."},"429":{"description":"Too many requests from this IP address. Retry after the number of seconds in the Retry-After header."}}}},"/api/v1/market":{"get":{"summary":"Monthly market totals, registrar group shares and history","responses":{"200":{"description":"The market figures.","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"type":"object","properties":{"source":{"type":"string","description":"Where the figures come from."},"as_of":{"type":["string","null"],"description":"The date of the data: the report month, or the date the directory last copied the records."},"licence":{"type":"string"},"site":{"type":"string"},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}}},"data":{"type":"object","additionalProperties":true}}}}}},"429":{"description":"Too many requests from this IP address. Retry after the number of seconds in the Retry-After header."}}}}}}