{"openapi":"3.1.0","info":{"title":"BrandCert API","version":"1.0.0","description":"Scan 10 AI platforms for brand accuracy. Compare AI-generated descriptions against verified facts and get a detailed accuracy report with 5-dimension scoring.","contact":{"email":"hello@brandcert.com","url":"https://brandcert.com"}},"servers":[{"url":"https://brandcert.com","description":"Production"}],"paths":{"/api/analyze":{"post":{"operationId":"analyzeBrand","summary":"Scan a brand across 10 AI platforms","description":"Submits a brand name for scanning. Queries 10 AI platforms with 25 questions across 5 dimensions (purchase, product, policy, company, competitor). Returns an accuracy report with per-platform scores and specific issues.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["brand"],"properties":{"brand":{"type":"string","description":"The brand name to scan","example":"Anker"},"industry":{"type":"string","enum":["saas","dtc","fintech","general"],"description":"Industry type for specialized questions. Auto-detected if not provided."}}}}}},"responses":{"200":{"description":"Brand accuracy report","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandReport"}}}},"400":{"description":"Invalid request — brand name missing or empty"},"500":{"description":"Scan failed"}}}},"/api/report/{id}":{"get":{"operationId":"getReport","summary":"Get a previously generated report","description":"Retrieves a shared report by its unique ID.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Report ID (e.g., anker-mn18rau0)"}],"responses":{"200":{"description":"Brand accuracy report","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandReport"}}}},"404":{"description":"Report not found"}}}},"/api/subscribe":{"post":{"operationId":"subscribe","summary":"Subscribe with email to unlock full report","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string","format":"email"},"brandName":{"type":"string"},"reportId":{"type":"string"}}}}}},"responses":{"200":{"description":"Subscribed successfully"}}}}},"components":{"schemas":{"BrandReport":{"type":"object","properties":{"brandName":{"type":"string"},"overallScore":{"type":"integer","minimum":0,"maximum":100,"description":"Overall accuracy score across all platforms"},"grade":{"type":"string","enum":["A+","A","B","C","D","F"]},"analyzedAt":{"type":"string","format":"date-time"},"summary":{"type":"string"},"reportId":{"type":"string"},"factSource":{"type":"object","properties":{"source":{"type":"string","enum":["preset","llms-txt","website","wikipedia","crunchbase","cross-verified","none"]},"sourceCount":{"type":"integer"}}},"platformResults":{"type":"array","items":{"$ref":"#/components/schemas/PlatformResult"}},"topIssues":{"type":"array","items":{"$ref":"#/components/schemas/Issue"}},"recommendations":{"type":"array","items":{"type":"string"}}}},"PlatformResult":{"type":"object","properties":{"platform":{"type":"string","example":"ChatGPT"},"platformId":{"type":"string","example":"chatgpt"},"icon":{"type":"string"},"score":{"type":"integer","minimum":0,"maximum":100},"qaPairs":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string"},"answer":{"type":"string"}}}},"issues":{"type":"array","items":{"$ref":"#/components/schemas/Issue"}},"highlights":{"type":"array","items":{"type":"string"}}}},"Issue":{"type":"object","properties":{"type":{"type":"string","enum":["error","warning","info"]},"category":{"type":"string","enum":["purchase","product","policy","company","competitor","other"]},"description":{"type":"string"},"aiSaid":{"type":"string","description":"Direct quote from the AI platform"},"officialFact":{"type":"string","description":"Verified correct information"}}}}}}