{"openapi":"3.0.3","info":{"title":"AgentReviews API","description":"AI-synthesized product reviews aggregated from Amazon, Reddit, YouTube, and forums. Agent-first review aggregation.","version":"1.0.0","contact":{"url":"https://agentscored.com"}},"servers":[{"url":"https://agentscored.com","description":"Production"}],"paths":{"/api/search":{"get":{"operationId":"searchProducts","summary":"Full-text search for products","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"Search query (min 2 chars)"},{"name":"limit","in":"query","schema":{"type":"integer","default":10},"description":"Max results"}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"brand":{"type":"string"},"category":{"type":"string"},"score":{"type":"number","nullable":true}}}},"query":{"type":"string"},"total":{"type":"integer"}}}}}}}}},"/api/products":{"get":{"operationId":"listProducts","summary":"List all products with scores","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1},"description":"Page number"},{"name":"limit","in":"query","schema":{"type":"integer","default":100},"description":"Items per page (max 500)"},{"name":"category","in":"query","schema":{"type":"string"},"description":"Filter by category slug"},{"name":"sort","in":"query","schema":{"type":"string","enum":["score","price-asc","price-desc","name"]},"description":"Sort order"}],"responses":{"200":{"description":"Product list","content":{"application/json":{"schema":{"type":"object","properties":{"products":{"type":"array","items":{"$ref":"#/components/schemas/ProductSummary"}},"total":{"type":"integer"}}}}}}}}},"/api/products/{slug}":{"get":{"operationId":"getProduct","summary":"Get full product details including article, reviews, and images","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"example":"bushnell-pro-x3-link"}],"responses":{"200":{"description":"Full product data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FullProduct"}}}},"404":{"description":"Product not found"}}}},"/api/products/{slug}/reviews":{"get":{"operationId":"getProductReviews","summary":"Get raw review data for a product","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Review list","content":{"application/json":{"schema":{"type":"object","properties":{"productId":{"type":"string"},"slug":{"type":"string"},"reviews":{"type":"array","items":{"$ref":"#/components/schemas/Review"}},"total":{"type":"integer"}}}}}}}}}},"components":{"schemas":{"ProductSummary":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"brand":{"type":"string"},"category":{"type":"string"},"description":{"type":"string"},"imageUrl":{"type":"string"},"affiliateUrl":{"type":"string"},"ourProduct":{"type":"boolean"},"prices":{"type":"array","items":{"type":"object","properties":{"store":{"type":"string"},"price":{"type":"number"},"url":{"type":"string"}}}},"score":{"$ref":"#/components/schemas/Score"},"articleSummary":{"type":"string","nullable":true},"aggregateScore":{"type":"number","nullable":true}}},"FullProduct":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"brand":{"type":"string"},"category":{"type":"string"},"description":{"type":"string"},"reviews":{"type":"array","items":{"$ref":"#/components/schemas/Review"}},"article":{"$ref":"#/components/schemas/Article"},"score":{"$ref":"#/components/schemas/Score"}}},"Score":{"type":"object","properties":{"overall":{"type":"number"},"durability":{"type":"number"},"valueForMoney":{"type":"number"},"easeOfUse":{"type":"number"},"design":{"type":"number"},"topPros":{"type":"array","items":{"type":"string"}},"topCons":{"type":"array","items":{"type":"string"}}}},"Review":{"type":"object","properties":{"productId":{"type":"string"},"source":{"type":"string"},"author":{"type":"string"},"rating":{"type":"number","nullable":true},"text":{"type":"string"},"date":{"type":"string"},"sentiment":{"type":"string"}}},"Article":{"type":"object","properties":{"title":{"type":"string"},"summary":{"type":"string"},"body":{"type":"string"},"aggregateScore":{"type":"number"},"prosConsFromReviews":{"type":"object","properties":{"pros":{"type":"array","items":{"type":"string"}},"cons":{"type":"array","items":{"type":"string"}}}},"totalReviewsAnalyzed":{"type":"integer"}}}}}}