{"openapi":"3.1.0","info":{"title":"yourhack.ai Tools API","version":"1.0.0","description":"Free, no-auth REST API for the yourhack.ai catalog of browser-based tools. Returns tool and category metadata (id, name, category, url, description, keywords). Every tool runs client-side at its url.","contact":{"name":"yourhack.ai","url":"https://yourhack.ai/"},"license":{"name":"Free to use"}},"servers":[{"url":"https://yourhack.ai"}],"paths":{"/api/tools":{"get":{"summary":"List all tools","description":"Returns every tool with its metadata and canonical url.","responses":{"200":{"description":"The full tool catalog.","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"tools":{"type":"array","items":{"$ref":"#/components/schemas/Tool"}}}}}}}}}},"/api/tools/{id}":{"get":{"summary":"Get one tool","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Tool id (url slug)."}],"responses":{"200":{"description":"Tool metadata.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tool"}}}},"404":{"description":"No tool with that id."}}}},"/api/categories":{"get":{"summary":"List all categories","responses":{"200":{"description":"All categories with tool counts.","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"categories":{"type":"array","items":{"$ref":"#/components/schemas/Category"}}}}}}}}}},"/api/directory":{"get":{"summary":"List third-party tool listings","description":"Returns the curated directory of recommended external tools (source \"curated\") plus every live tool listed by its maker (source \"maker\"). Each listing includes the listing page url on yourhack.ai and the external tool url.","responses":{"200":{"description":"The full directory of external tool listings.","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"listings":{"type":"array","items":{"$ref":"#/components/schemas/DirectoryListing"}}}}}}}}}},"/api/showcase":{"get":{"summary":"List web projects on Launches","description":"Returns the real projects from the web (apps, games, experiments, APIs, sites) listed on yourhack.ai Launches: hand-picked ones (source \"curated\"), which are opened and tried before they are listed, plus every live project listed by its maker (source \"maker\"). Each item includes the listing page url on yourhack.ai and the external project url.","responses":{"200":{"description":"All hand-picked web projects on Launches.","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/ShowcaseItem"}}}}}}}}}}},"components":{"schemas":{"Tool":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"category":{"type":"string"},"url":{"type":"string","format":"uri"},"description":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}}}},"Category":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"title":{"type":"string"},"tagline":{"type":"string"},"description":{"type":"string"},"url":{"type":"string","format":"uri"},"toolCount":{"type":"integer"}}},"DirectoryListing":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri","description":"Review page on yourhack.ai."},"externalUrl":{"type":"string","format":"uri","description":"The third-party tool itself."},"tagline":{"type":"string"},"category":{"type":"string"},"bestFor":{"type":"string"},"pricing":{"type":"string","enum":["free","freemium"]},"noSignup":{"type":"boolean"},"openSource":{"type":"boolean"},"source":{"type":"string","enum":["curated","maker"],"description":"curated = our editorial pick; maker = listed by its maker."}}},"ShowcaseItem":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri","description":"Listing page on yourhack.ai."},"externalUrl":{"type":"string","format":"uri","description":"The project itself."},"tagline":{"type":"string"},"kind":{"type":"string","enum":["app","game","experiment","api","site"]},"pricing":{"type":"string","enum":["free","freemium"]},"openSource":{"type":"boolean"},"verified":{"type":"boolean","description":"True when we have confirmed the project live and working."},"source":{"type":"string","enum":["curated","maker"],"description":"curated = our editorial pick; maker = listed by its maker."}}}}}}