{"openapi":"3.1.0","info":{"title":"GetName.pl Public API","version":"1.0.0","description":"Read-only public API for the getname.pl domain marketplace, auctions, pricing, and NASK .pl availability checks. Supports JSON and `text/markdown` content negotiation.","contact":{"email":"contact@getname.pl","url":"https://getname.pl/contact"},"license":{"name":"Proprietary"}},"servers":[{"url":"https://api.getname.pl/v1","description":"Production"},{"url":"https://getname.pl/api/v1","description":"Production (main domain)"}],"tags":[{"name":"domains"},{"name":"auctions"},{"name":"categories"},{"name":"pricing"},{"name":"stats"},{"name":"hunter"}],"paths":{"/domains":{"get":{"tags":["domains"],"summary":"List marketplace domains","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","schema":{"type":"integer","default":30,"maximum":100}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"minPrice","in":"query","schema":{"type":"number"}},{"name":"maxPrice","in":"query","schema":{"type":"number"}},{"name":"category","in":"query","schema":{"type":"string"},"description":"Comma-separated category IDs or slugs"},{"name":"sort","in":"query","schema":{"type":"string","enum":["name","price","expiry","created","opr","da","pa","dr","cf","tf"]}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"]}}],"responses":{"200":{"description":"List of domains","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainList"}},"text/markdown":{"schema":{"type":"string"}}}}}}},"/domains/{name}":{"get":{"tags":["domains"],"summary":"Domain detail","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Domain"}}}},"/domains/check":{"get":{"tags":["domains"],"summary":"Check domain availability (NASK EPP + marketplace)","parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Availability + registration price"}}}},"/domains/search":{"get":{"tags":["domains"],"summary":"Search domains + auctions","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2}},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":50}}],"responses":{"200":{"description":"Search results"}}}},"/domains/hunter/stream":{"get":{"tags":["hunter"],"summary":"Server-Sent Events: public domains just caught and listed for sale","description":"Text/event-stream. Events: `domain_caught` with JSON payload `{domain, priceGross, currency, caughtAt}`.","responses":{"200":{"description":"SSE stream","content":{"text/event-stream":{}}}}}},"/auctions":{"get":{"tags":["auctions"],"summary":"List auctions","responses":{"200":{"description":"Auctions"}}}},"/auctions/{id}":{"get":{"tags":["auctions"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Auction detail"}}}},"/categories":{"get":{"tags":["categories"],"responses":{"200":{"description":"Categories"}}}},"/categories/{slug}":{"get":{"tags":["categories"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Category + domains"}}}},"/pricing":{"get":{"tags":["pricing"],"responses":{"200":{"description":"TLD pricing"}}}},"/stats":{"get":{"tags":["stats"],"responses":{"200":{"description":"Marketplace stats"}}}},"/recently-sold":{"get":{"tags":["domains"],"responses":{"200":{"description":"Recently sold"}}}}},"components":{"schemas":{"Domain":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"isForSale":{"type":"boolean"},"priceGross":{"type":"number","nullable":true},"currency":{"type":"string"},"expiryDate":{"type":"string","format":"date"},"metrics":{"type":"object","properties":{"mozDa":{"type":"integer","nullable":true},"mozPa":{"type":"integer","nullable":true},"ahrefsDr":{"type":"integer","nullable":true},"majCf":{"type":"integer","nullable":true},"majTf":{"type":"integer","nullable":true},"oprPageRank":{"type":"number","nullable":true}}}}},"DomainList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Domain"}},"meta":{"type":"object","properties":{"total":{"type":"integer"},"page":{"type":"integer"},"limit":{"type":"integer"},"totalPages":{"type":"integer"}}}}}}}}