{"openapi":"3.1.0","info":{"title":"Namegarage public domain catalog","version":"1.0.0","termsOfService":"https://namegarage.com/terms/","description":"Anonymous read-only catalog and search. No account, API key, bearer token, or browser cookie is required."},"security":[],"externalDocs":{"description":"Public API documentation and quickstart","url":"https://namegarage.com/docs/"},"servers":[{"url":"https://namegarage.com"}],"paths":{"/domains.json":{"get":{"summary":"List public domains for sale","operationId":"listPublicDomains","description":"Read the published sales catalog and its current prices. An offer-only name has no fixed purchase price.","responses":{"200":{"description":"Public sales catalog","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","additionalProperties":false,"required":["brand","base_url","count","traffic_max_stale_days","domains"],"properties":{"brand":{"type":"string"},"base_url":{"type":"string"},"count":{"type":"integer","minimum":0},"priced_at":{"type":"integer"},"traffic_max_stale_days":{"type":"integer","minimum":0},"domains":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","sld","tld","path","tier","buy_now","categories","low"],"properties":{"name":{"type":"string"},"sld":{"type":"string"},"tld":{"type":"string"},"display":{"type":"string"},"path":{"type":"string"},"tier":{"type":"string","enum":["","Platinum","Gold","Silver","Bronze","Bargain"]},"buy_now":{"type":["integer","null"]},"regular_price":{"type":["integer","null"]},"promotion":{"type":"object","additionalProperties":false,"required":["price","kind","minimum","ends","next","version"],"properties":{"price":{"type":["integer","null"]},"kind":{"enum":["regular","weekly","price_drop"]},"minimum":{"type":["integer","null"]},"ends":{"type":["string","null"],"format":"date-time"},"next":{"type":["object","null"],"additionalProperties":false,"required":["starts","price"],"properties":{"starts":{"type":"string","format":"date-time"},"price":{"type":"integer"}}},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"categories":{"type":"array","items":{"type":"string"}},"low":{"type":["integer","null"]},"deal":{"type":"object","description":"A current or scheduled weekly offer. Its price applies only while starts <= now < ends; otherwise use buy_now.","additionalProperties":false,"required":["price","starts","ends"],"properties":{"price":{"type":"integer"},"starts":{"type":"string","format":"date-time"},"ends":{"type":"string","format":"date-time"}}},"visits":{"type":"integer"},"visits_through":{"type":"string","format":"date"}}}}}}}}}}}},"/api/search":{"get":{"summary":"Search the public domains by keyword or by meaning","operationId":"searchPublicDomains","description":"Find names by spelling or project description, with optional price, tier, suffix, and length filters. Results include current prices and links to the public domain pages.","parameters":[{"name":"q","in":"query","required":true,"description":"A domain, keyword, or description of the project the name should fit.","schema":{"type":"string","minLength":2,"maxLength":200}},{"name":"max_price","in":"query","description":"Maximum current price in whole USD.","schema":{"type":"integer","minimum":1}},{"name":"tier","in":"query","description":"Limit matches to this pricing tier.","schema":{"enum":["Bargain","Bronze","Silver","Gold","Platinum"]}},{"name":"tld","in":"query","schema":{"type":"string"},"description":"How the name ends: a TLD (com) or a longer suffix (co.uk), in ASCII (xn--p1ai) or Unicode; a leading dot is ignored."},{"name":"max_length","in":"query","description":"Maximum name length.","schema":{"type":"integer","minimum":1,"maximum":63}},{"name":"limit","in":"query","description":"Maximum number of matches to return.","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Ranked matches with current prices","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","additionalProperties":false,"required":["query","priced_at","meaning","count","results"],"properties":{"query":{"type":"string"},"priced_at":{"type":"integer"},"meaning":{"enum":["available","unavailable"]},"count":{"type":"integer","minimum":0},"results":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","url","tier","price_usd","match","fits"],"properties":{"name":{"type":"string"},"display":{"type":"string"},"url":{"type":"string"},"tier":{"type":["string","null"]},"price_usd":{"type":["integer","null"],"description":"Current price in whole USD, a running deal included; null for an offer-only name, which has no fixed price (make an offer on its page)."},"regular_price_usd":{"type":"integer","description":"The usual price, present only while a discount is running."},"match":{"enum":["exact","keyword","meaning"],"description":"exact: the query is the whole name or its first label; keyword: a match by spelling; meaning: a match by what the name is for."},"fits":{"type":["string","null"],"description":"The published use case or description this name matched; null when the match was by spelling only or the name's copy is withheld."}}}}}}}}},"400":{"description":"A parameter is invalid: {\"error\": \"invalid_parameter\", \"parameter\": <name>}"},"404":{"description":"Not this origin or path"},"429":{"description":"Busy; retry after the Retry-After header"},"503":{"description":"Prices cannot be verified right now (\"prices_unverified\") or search is unavailable; retry after the Retry-After header"}}}}}}