{"openapi":"3.1.0","info":{"title":"ClubMarket SG Public Data API","version":"1.0.0","description":"Read-only, PII-minimized access to public Singapore club membership and listing information. ClubMarket SG is independent and not affiliated with any listed club. ClubMarket SG charges a 1% broker fee on the final agreed sale price, normally paid by the seller. Browsing listings and creating an account are free. Club transfer and entrance fees are separate and paid to the club. ClubMarket SG is not commission-free."},"servers":[{"url":"https://clubmarket.org"}],"paths":{"/api/public/clubs":{"get":{"operationId":"listClubs","summary":"List clubs, memberships, and aggregate market information","responses":{"200":{"description":"Public club catalog","content":{"application/json":{"schema":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"platformFee":{"$ref":"#/components/schemas/PlatformFee"},"dataNotes":{"type":"object"},"clubs":{"type":"array","items":{"$ref":"#/components/schemas/Club"}}}}}}}}}},"/api/public/listings":{"get":{"operationId":"listMembershipListings","summary":"Search current public membership listings","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Search terms"},{"name":"club","in":"query","schema":{"type":"string"},"description":"Club slug"},{"name":"type","in":"query","schema":{"type":"string"},"description":"Membership name"},{"name":"min","in":"query","schema":{"type":"number","minimum":0},"description":"Minimum SGD price"},{"name":"max","in":"query","schema":{"type":"number","minimum":0},"description":"Maximum SGD price"},{"name":"sort","in":"query","schema":{"type":"string","enum":["newest","price_asc","price_desc"],"default":"newest"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":60,"default":24}}],"responses":{"200":{"description":"A page of public listings","content":{"application/json":{"schema":{"type":"object","properties":{"platformFee":{"$ref":"#/components/schemas/PlatformFee"},"listings":{"type":"array","items":{"$ref":"#/components/schemas/Listing"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}}}}}}},"components":{"schemas":{"PlatformFee":{"type":"object","description":"The broker fee ClubMarket SG charges on completed sales.","required":["name","type","value","paidBy","appliesTo","description"],"properties":{"name":{"type":"string"},"type":{"type":"string","enum":["percentage"]},"value":{"type":"number","description":"Percentage of the final agreed sale price"},"paidBy":{"type":"string","enum":["seller"]},"appliesTo":{"type":"string"},"description":{"type":"string"}}},"Club":{"type":"object","required":["slug","name","sourceUrl","memberships"],"properties":{"slug":{"type":"string"},"name":{"type":"string"},"heroImage":{"type":["string","null"]},"sourceUrl":{"type":"string","format":"uri"},"officialWebsites":{"type":"object"},"market":{"type":"object","description":"Aggregate, non-user-specific market information"},"memberships":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"transferability":{"type":"string"},"resalePriceDisplay":{"type":"string"},"priceHistoryProvenance":{"type":"string","enum":["real","estimated","mixed","unavailable"]},"priceHistory":{"type":"array","items":{"type":"object"}}}}}}},"Listing":{"type":"object","required":["slug","title","membershipType","priceSgd","club","sourceUrl"],"properties":{"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"membershipType":{"type":"string"},"priceSgd":{"type":"number","minimum":0},"negotiable":{"type":"boolean"},"transferFeeDetails":{"type":"string"},"status":{"type":"string","enum":["PUBLISHED"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"club":{"type":"object"},"images":{"type":"array","items":{"type":"object"}},"sourceUrl":{"type":"string","format":"uri"}}},"Pagination":{"type":"object","required":["total","page","pageSize","hasMore"],"properties":{"total":{"type":"integer","minimum":0},"page":{"type":"integer","minimum":1},"pageSize":{"type":"integer","minimum":1,"maximum":60},"hasMore":{"type":"boolean"}}}}}}