{"openapi":"3.1.0","info":{"title":"龙虾喵 ClawMeow Shop API","description":"Live listings for ClawMeow — a pre-loved & new electronics marketplace (laptops, desktops, PC parts, drones, cameras) by Qie Studio, Melbourne.","version":"1.0.0"},"servers":[{"url":"https://clawmeow.com"}],"paths":{"/api/public/products":{"get":{"operationId":"listProducts","summary":"List current ClawMeow listings","parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["laptop","desktop","parts","drone","camera","other"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Available listings","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string"},"title_zh":{"type":"string"},"title_en":{"type":"string"},"brand":{"type":"string","nullable":true},"category":{"type":"string"},"condition":{"type":"string"},"listing_type":{"type":"string","description":"studio = Qie verified with warranty; user = consignment"},"warranty":{"type":"boolean"},"highlight":{"type":"string","nullable":true},"status":{"type":"string","enum":["available","reserved","sold"]},"price":{"type":"number"},"original_price":{"type":"number","nullable":true},"currency":{"type":"string"},"price_display":{"type":"string"},"image":{"type":"string","nullable":true},"url":{"type":"string"}}}}}}}}}}}},"/api/public/recommend":{"get":{"operationId":"recommendProduct","summary":"Recommend one good item","parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"A recommended item","content":{"application/json":{"schema":{"type":"object","properties":{"item":{"type":"object","properties":{"sku":{"type":"string"},"title_zh":{"type":"string"},"title_en":{"type":"string"},"brand":{"type":"string","nullable":true},"category":{"type":"string"},"condition":{"type":"string"},"listing_type":{"type":"string","description":"studio = Qie verified with warranty; user = consignment"},"warranty":{"type":"boolean"},"highlight":{"type":"string","nullable":true},"status":{"type":"string","enum":["available","reserved","sold"]},"price":{"type":"number"},"original_price":{"type":"number","nullable":true},"currency":{"type":"string"},"price_display":{"type":"string"},"image":{"type":"string","nullable":true},"url":{"type":"string"}}}}}}}}}}},"/api/subscribe":{"post":{"operationId":"subscribe","summary":"Subscribe an email for new-stock updates","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string"},"name":{"type":"string"}}}}}},"responses":{"200":{"description":"Subscribed"}}}}}}