{"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 curated third-party tool listings","description":"Returns the curated directory of recommended external tools. Each listing includes the review page url on yourhack.ai and the external tool url. Editorial picks, not paid placements.","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 showcased web projects","description":"Returns the showcase of real projects from the web (apps, games, experiments, APIs, sites). Each item includes the listing page url on yourhack.ai and the external project url. The open shelf next to the curated tools directory; every entry is opened and tried before it is listed.","responses":{"200":{"description":"The full showcase of web projects.","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"}}},"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."}}}}}}