{"openapi":"3.1.0","info":{"title":"Brand Bakery Public API","version":"1.1.0","description":"Public API endpoints for Brand Bakery tools."},"servers":[{"url":"https://www.brandbakery.tech"}],"security":[],"paths":{"/api/tools/seo-audit":{"post":{"operationId":"runSeoAudit","summary":"Run heuristic HTML checks and optional Lighthouse lab measurements.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"The page or site URL to audit."}}}}}},"responses":{"200":{"description":"Audit report grouped by readiness modules.","content":{"application/json":{"schema":{"type":"object","required":["url","overallScore","methodology","modules"],"properties":{"url":{"type":"string"},"overallScore":{"type":["number","null"],"description":"Average of HTML heuristics, excluding Lighthouse performance."},"methodology":{"type":"string"},"modules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"score":{"type":["number","null"],"description":"Null means unavailable."},"items":{"type":"array","items":{"type":"object"}}}}}}}}}},"400":{"description":"Missing or invalid URL."},"429":{"description":"Rate limited. Honour Retry-After."}}}},"/api/health":{"get":{"operationId":"getHealth","summary":"Check API availability.","responses":{"200":{"description":"Service health status.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","const":"ok"}}}}}}}}}}}