{"openapi":"3.1.0","info":{"title":"CodeHype Public API","version":"1.0.0","description":"Read-only public API for the CodeHype AI and SaaS product directory. No authentication. Returns published listings only. Companion MCP server: /mcp. Discovery: /.well-known/mcp.json.","contact":{"email":"business.codehype@gmail.com"}},"servers":[{"url":"https://codehype.ai","description":"Production"}],"tags":[{"name":"Products"},{"name":"Categories"},{"name":"Launches"},{"name":"Discovery"}],"paths":{"/v1":{"get":{"tags":["Discovery"],"summary":"API index","operationId":"getApiIndex","responses":{"200":{"description":"API directory","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiIndex"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/products":{"get":{"tags":["Products"],"summary":"List published products","operationId":"listProducts","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"category","in":"query","required":false,"schema":{"type":"string"}},{"name":"scope","in":"query","required":false,"schema":{"type":"string","enum":["all","ai","saas"]}},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["ai_tool","ai_saas","ai_agent","developer_tool","api","chrome_extension","mobile_app","ai_startup","other"]}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["trending","newest","upvoted"]}},{"name":"featured","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"trending","in":"query","required":false,"description":"If true and sort is omitted, sort=trending","schema":{"type":"boolean"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Product page","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSummaryList"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/products/{slug}":{"get":{"tags":["Products"],"summary":"Get a published product by slug or ID","operationId":"getProduct","parameters":[{"name":"slug","in":"path","required":true,"description":"Product slug or public ID","schema":{"type":"string","minLength":1,"maxLength":120}}],"responses":{"200":{"description":"Product","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductEnvelope"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/search":{"get":{"tags":["Discovery"],"summary":"Search published products","operationId":"searchProducts","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"category","in":"query","required":false,"schema":{"type":"string"}},{"name":"scope","in":"query","required":false,"schema":{"type":"string","enum":["all","ai","saas"]}},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["ai_tool","ai_saas","ai_agent","developer_tool","api","chrome_extension","mobile_app","ai_startup","other"]}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["trending","newest","upvoted"]}},{"name":"featured","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"trending","in":"query","required":false,"description":"If true and sort is omitted, sort=trending","schema":{"type":"boolean"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Search hits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductList"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/categories":{"get":{"tags":["Categories"],"summary":"List categories","operationId":"listCategories","responses":{"200":{"description":"Categories","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryList"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/categories/{slug}":{"get":{"tags":["Categories"],"summary":"Get a category","operationId":"getCategory","parameters":[{"name":"slug","in":"path","required":true,"description":"Category slug","schema":{"type":"string","minLength":1,"maxLength":120}}],"responses":{"200":{"description":"Category","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryEnvelope"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/categories/{slug}/products":{"get":{"tags":["Categories"],"summary":"List products in a category","operationId":"listCategoryProducts","parameters":[{"name":"slug","in":"path","required":true,"description":"Category slug","schema":{"type":"string","minLength":1,"maxLength":120}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"scope","in":"query","required":false,"schema":{"type":"string","enum":["all","ai","saas"]}},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["ai_tool","ai_saas","ai_agent","developer_tool","api","chrome_extension","mobile_app","ai_startup","other"]}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["trending","newest","upvoted"]}},{"name":"featured","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"trending","in":"query","required":false,"description":"If true and sort is omitted, sort=trending","schema":{"type":"boolean"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Category products","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryProductList"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/launches":{"get":{"tags":["Launches"],"summary":"Recent launches","operationId":"listLaunches","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Recent products and optional weekly window","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LaunchList"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/featured":{"get":{"tags":["Discovery"],"summary":"Featured products","operationId":"listFeatured","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Featured products","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSummaryList"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/trending":{"get":{"tags":["Discovery"],"summary":"Trending products","operationId":"listTrending","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Trending products","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSummaryList"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/stats":{"get":{"tags":["Discovery"],"summary":"Public directory stats","operationId":"getStats","responses":{"200":{"description":"Stats","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatsEnvelope"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{},"schemas":{"Pagination":{"type":"object","additionalProperties":false,"required":["page","limit","total","totalPages","hasMore"],"properties":{"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":"integer"},"totalPages":{"type":"integer"},"hasMore":{"type":"boolean"}}},"Error":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","not_found","method_not_allowed","rate_limited","internal_error"]},"message":{"type":"string"}}}}},"CategoryRef":{"type":"object","additionalProperties":false,"required":["slug","name"],"properties":{"slug":{"type":"string"},"name":{"type":"string"}}},"Founder":{"type":"object","additionalProperties":false,"required":["displayName","username","url"],"properties":{"displayName":{"type":"string"},"username":{"type":"string"},"url":{"type":"string","format":"uri"}}},"ProductSummary":{"type":"object","additionalProperties":false,"required":["name","slug","url","logoUrl","tagline","kind","kindLabel","categories","voteCount","launchedAt","featured"],"properties":{"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri"},"logoUrl":{"type":["string","null"]},"tagline":{"type":"string"},"kind":{"type":"string","enum":["ai_tool","ai_saas","ai_agent","developer_tool","api","chrome_extension","mobile_app","ai_startup","other"]},"kindLabel":{"type":"string"},"categories":{"type":"array","items":{"$ref":"#/components/schemas/CategoryRef"}},"voteCount":{"type":"integer"},"launchedAt":{"type":["string","null"]},"featured":{"type":"boolean"}}},"Product":{"allOf":[{"$ref":"#/components/schemas/ProductSummary"},{"type":"object","additionalProperties":false,"required":["websiteUrl","description","tags","features","pricing","commentCount","founder"],"properties":{"websiteUrl":{"type":["string","null"]},"description":{"type":["string","null"]},"tags":{"type":"array","items":{"type":"string"}},"features":{"type":"array","items":{"type":"string"}},"pricing":{"type":["string","null"]},"commentCount":{"type":"integer"},"founder":{"$ref":"#/components/schemas/Founder"}}}]},"Category":{"type":"object","additionalProperties":false,"required":["slug","name","description","url","productCount"],"properties":{"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"url":{"type":"string","format":"uri"},"productCount":{"type":"integer"}}},"LaunchWindow":{"type":"object","additionalProperties":false,"required":["slug","title","url","startsAt","endsAt"],"properties":{"slug":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"startsAt":{"type":"string"},"endsAt":{"type":"string"}}},"ProductSummaryList":{"type":"object","additionalProperties":false,"required":["data","pagination"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ProductSummary"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}},"ProductList":{"type":"object","additionalProperties":false,"required":["data","pagination"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Product"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}},"ProductEnvelope":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Product"}}},"CategoryList":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Category"}}}},"CategoryEnvelope":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Category"}}},"CategoryProductList":{"type":"object","additionalProperties":false,"required":["data","pagination","category"],"properties":{"category":{"$ref":"#/components/schemas/Category"},"data":{"type":"array","items":{"$ref":"#/components/schemas/ProductSummary"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}},"LaunchList":{"type":"object","additionalProperties":false,"required":["data","pagination","window"],"properties":{"window":{"oneOf":[{"$ref":"#/components/schemas/LaunchWindow"},{"type":"null"}]},"data":{"type":"array","items":{"$ref":"#/components/schemas/ProductSummary"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}},"Stats":{"type":"object","additionalProperties":false,"required":["totalProducts","totalAiTools","totalSaasProducts","totalCategories","featuredCount","generatedAt"],"properties":{"totalProducts":{"type":"integer"},"totalAiTools":{"type":"integer"},"totalSaasProducts":{"type":"integer"},"totalCategories":{"type":"integer"},"featuredCount":{"type":"integer"},"generatedAt":{"type":"string"}}},"StatsEnvelope":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Stats"}}},"ApiIndex":{"type":"object","additionalProperties":true}}},"security":[]}