{"openapi":"3.1.0","info":{"title":"DealRadar Product Discovery API","version":"1.0.0","description":"Compliant product discovery feeds for AI shopping agents, widgets, and builder tools. Routes shoppers through DealRadar pages and tracked affiliate links with clear disclosure."},"servers":[{"url":"https://www.dealsradar.app"}],"paths":{"/api/deals":{"get":{"summary":"List curated deals","parameters":[{"name":"category","in":"query","schema":{"type":"string","default":"all"}},{"name":"store","in":"query","schema":{"type":"string","default":"all"}},{"name":"limit","in":"query","schema":{"type":"integer","default":24,"minimum":1,"maximum":100}},{"name":"tag","in":"query","schema":{"type":"string","default":"api"},"description":"Tracking tag applied to outbound DealRadar links."},{"name":"q","in":"query","schema":{"type":"string"},"description":"Optional product/search query."}],"responses":{"200":{"description":"Deal feed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DealFeed"}}}}}}},"/api/search":{"get":{"summary":"Search products by shopping intent","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"example":"useful kitchen gadgets under 10 dollars"},{"name":"category","in":"query","schema":{"type":"string","default":"all"}},{"name":"limit","in":"query","schema":{"type":"integer","default":8,"minimum":1,"maximum":100}},{"name":"tag","in":"query","schema":{"type":"string","default":"ai-search"}}],"responses":{"200":{"description":"Intent-matched products","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchFeed"}}}}}}}},"components":{"schemas":{"DealFeed":{"type":"object","properties":{"name":{"type":"string"},"disclosure":{"type":"string"},"count":{"type":"integer"},"deals":{"type":"array","items":{"$ref":"#/components/schemas/Deal"}}}},"SearchFeed":{"type":"object","properties":{"name":{"type":"string"},"guidance":{"type":"string"},"count":{"type":"integer"},"results":{"type":"array","items":{"$ref":"#/components/schemas/Deal"}}}},"Deal":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"store":{"type":"string"},"price":{"type":"object"},"links":{"type":"object","properties":{"landing":{"type":"string","format":"uri"},"tracked":{"type":"string","format":"uri"}}},"disclosure":{"type":"string"},"buyingChecks":{"type":"array","items":{"type":"string"}},"assistantInstructions":{"type":"string"}}}}}}