{"openapi":"3.1.0","info":{"title":"AskableHQ Public API","version":"1.0.0","description":"Read-only, unauthenticated API for products launched on AskableHQ."},"servers":[{"url":"https://askablehq.lol/"}],"paths":{"/v1/products":{"get":{"operationId":"listProducts","summary":"List products","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"pricing","in":"query","schema":{"type":"string"}},{"name":"tag","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string","enum":["trending","newest","top","score"]}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Product"}}}}}}}}}},"/v1/products/{slug}":{"get":{"operationId":"getProduct","summary":"Get a product","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Product"}}}}}},"404":{"description":"Not found"}}}},"/v1/search":{"get":{"operationId":"searchProducts","summary":"Search products","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Product"}}}}}}}}}},"/v1/categories":{"get":{"operationId":"listCategories","summary":"List categories","responses":{"200":{"description":"OK"}}}},"/v1/launches":{"get":{"operationId":"weeklyLaunches","summary":"Weekly launch board","parameters":[{"name":"week","in":"query","schema":{"type":"string","pattern":"^\\d{4}-w\\d{2}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Product"}}}}}}}}}},"/v1/deals":{"get":{"operationId":"listDeals","summary":"Active maker deals and coupon codes","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Product"}}}}}}}}}},"/v1/upcoming":{"get":{"operationId":"upcomingLaunches","summary":"Products scheduled to launch soon","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Product"}}}}}}}}}},"/v1/stats":{"get":{"operationId":"siteStats","summary":"Platform statistics","responses":{"200":{"description":"OK"}}}}},"components":{"schemas":{"Product":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"tagline":{"type":"string"},"description":{"type":"string"},"url":{"type":"string","format":"uri"},"page":{"type":"string","format":"uri"},"markdown":{"type":"string","format":"uri"},"category":{"type":"string"},"pricing":{"type":"string","enum":["Free","Freemium","Paid","Open Source"]},"tags":{"type":"array","items":{"type":"string"}},"votes":{"type":"integer"},"readinessScore":{"type":"integer","minimum":0,"maximum":100},"launchedAt":{"type":"string","format":"date-time"},"stats":{"type":"object","properties":{"views":{"type":"integer"},"outboundClicks":{"type":"integer"}}}}}}}}