{"openapi":"3.1.0","info":{"title":"AuditMe API","version":"1.0.0","description":"REST API for AuditMe SEO audit platform. Analyze websites for technical SEO, performance, schema, content quality, and AI visibility.","contact":{"name":"AuditMe Support","url":"https://www.auditme.dev/support","email":"support@auditme.dev"},"license":{"name":"Proprietary","url":"https://www.auditme.dev/terms"}},"servers":[{"url":"https://www.auditme.dev","description":"Production"}],"paths":{"/api/v1/audit":{"get":{"operationId":"runAudit","summary":"Run SEO Audit","description":"Analyze a URL for SEO issues. Returns a comprehensive audit with score, issues, and recommendations. Rate limit: 5 requests/minute.","tags":["Audit"],"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri"},"description":"The URL to audit","example":"https://www.auditme.dev"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","html"],"default":"json"},"description":"Response format"}],"responses":{"200":{"description":"Audit results","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"score":{"type":"number","description":"Overall SEO score (0-100)"},"issues":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"severity":{"type":"string","enum":["critical","high","medium","low"]},"category":{"type":"string"},"recommendation":{"type":"string"}}}},"meta":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"canonical":{"type":"string"},"h1":{"type":"string"}}}}}}}},"400":{"description":"Invalid URL"},"429":{"description":"Rate limit exceeded"}}}},"/api/ai-visibility-scan":{"post":{"operationId":"scanAiVisibility","summary":"AI Visibility Scan","description":"Deterministic check of a website's AI-readiness: LLMIs.txt, AI bot access, content structure, entity clarity.","tags":["AI Visibility"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"URL to scan"}}}}}},"responses":{"200":{"description":"AI visibility results","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"score":{"type":"number","description":"AI visibility score (0-100)"},"pillars":{"type":"object","properties":{"llmsTxt":{"type":"number"},"aiBotAccess":{"type":"number"},"answerStructure":{"type":"number"},"entityClarity":{"type":"number"}}},"recommendations":{"type":"array","items":{"type":"string"}}}}}}},"429":{"description":"Rate limit exceeded"}}}},"/api/ai-readiness":{"post":{"operationId":"checkAiReadiness","summary":"AI Readiness Check","description":"Check if a website is ready for AI search engines: LLMIs.txt presence, robots.txt AI bot rules, semantic HTML analysis.","tags":["AI Visibility"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"URL to check"}}}}}},"responses":{"200":{"description":"AI readiness results","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"score":{"type":"number"},"checks":{"type":"object","properties":{"llmsTxt":{"type":"boolean"},"aiBotsAllowed":{"type":"boolean"},"semanticHtml":{"type":"boolean"}}}}}}}}}}},"/api/mcp":{"post":{"operationId":"mcpToolCall","summary":"MCP Tool Call","description":"Model Context Protocol endpoint for AI agents. Execute SEO audit tools via MCP protocol.","tags":["MCP"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["method","params"],"properties":{"method":{"type":"string","enum":["tools/list","tools/call"],"description":"MCP method to invoke"},"params":{"type":"object","description":"Method parameters"}}}}}},"responses":{"200":{"description":"MCP response","content":{"application/json":{"schema":{"type":"object","properties":{"jsonrpc":{"type":"string","example":"2.0"},"id":{"type":"number"},"result":{"type":"object"}}}}}}}}}},"tags":[{"name":"Audit","description":"SEO audit operations"},{"name":"AI Visibility","description":"AI search engine readiness checks"},{"name":"MCP","description":"Model Context Protocol for AI agents"}]}