{"openapi":"3.1.0","info":{"title":"Agent Review Data API","version":"1.1.0","description":"Exact UK product rankings with provenance-bearing comparison facts. Evidence timestamps come from stored source retrievals, never response time.","contact":{"email":"hello@agentreviewdata.com"}},"servers":[{"url":"https://agentreviewdata.com"}],"paths":{"/api/v1/products":{"get":{"summary":"List ranked products","parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["portable-air-conditioner","dehumidifier","power-bank","air-fryer","cordless-vacuum","robot-vacuum","wireless-earbuds"]}}],"responses":{"200":{"description":"Ranked product collection","content":{"application/json":{"schema":{"type":"object","required":["meta","data"],"properties":{"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"data":{"type":"array","items":{"$ref":"#/components/schemas/ProductSummary"}}}}}}},"400":{"$ref":"#/components/responses/Problem"}}}},"/api/v1/products/{slug}":{"get":{"summary":"Get one exact product record","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Exact product record","content":{"application/json":{"schema":{"type":"object","required":["meta","data"],"properties":{"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"data":{"$ref":"#/components/schemas/ProductSummary"}}}}}},"404":{"description":"Product not found"}}}},"/api/v1/compare":{"get":{"summary":"Reorder one category by declared preferences","parameters":[{"name":"category","in":"query","schema":{"type":"string","enum":["portable-air-conditioner","dehumidifier","power-bank","air-fryer","cordless-vacuum","robot-vacuum","wireless-earbuds"]}},{"name":"minimum","in":"query","schema":{"type":"number","exclusiveMinimum":0}},{"name":"priority","in":"query","schema":{"type":"string","enum":["balanced","value","speciality","evidence"]}},{"name":"available","in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Preference-ordered category results"},"400":{"$ref":"#/components/responses/Problem"}}}}},"components":{"schemas":{"EnvelopeMeta":{"type":"object","required":["api_version","data_status","evidence_checked_at","generated_at"],"properties":{"api_version":{"const":"v1"},"data_status":{"const":"verified"},"evidence_checked_at":{"type":"string","format":"date-time"},"generated_at":{"type":"null","description":"Always null; response time is not evidence freshness."}}},"ProductSummary":{"type":"object","required":["id","slug","name","brand","model","category","facts","offer","evidence","recommendation"],"properties":{"id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"brand":{"type":"string"},"model":{"type":"string"},"category":{"type":"string","enum":["portable-air-conditioner","dehumidifier","power-bank","air-fryer","cordless-vacuum","robot-vacuum","wireless-earbuds"]},"facts":{"type":"object","additionalProperties":{"type":"object","required":["value","unit","display","source_url","source_class","retrieved_at"],"properties":{"value":{"type":["string","number","null"]},"unit":{"type":["string","null"]},"display":{"type":"string"},"source_url":{"type":"string","format":"uri"},"source_class":{"type":"string","enum":["manufacturer_claim","retailer_observation","controlled_test","regulatory_record","owner_report"]},"retrieved_at":{"type":"string","format":"date-time"}}}},"offer":{"type":"object","description":"Timestamped retailer observation; callers must evaluate checked_at before repeating price or stock."},"evidence":{"type":"object"},"recommendation":{"type":"object"}}}},"responses":{"Problem":{"description":"Invalid request","content":{"application/problem+json":{"schema":{"type":"object","required":["title","status","detail"]}}}}}},"externalDocs":{"description":"Human-readable API and evidence contract","url":"https://agentreviewdata.com/docs/api"}}