{"openapi":"3.1.0","info":{"title":"Fazy Deals API","version":"2026-09-12","description":"Search a price-checked deals catalogue for US shoppers. Free, keyless, 60 requests a minute per address. Every `url` redirects to the retailer and attributes the click; hand it to the shopper unchanged.","termsOfService":"https://fazy.com/terms","contact":{"url":"https://fazy.com/developers"}},"servers":[{"url":"https://fazy.com/api/v1"}],"paths":{"/deals/search":{"get":{"operationId":"searchDeals","summary":"Search deals","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":120},"description":"What the shopper wants, in plain words."},{"name":"brand","in":"query","required":false,"schema":{"type":"string"}},{"name":"max_price","in":"query","required":false,"schema":{"type":"number"},"description":"US dollars"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"`next_cursor` from the previous page"},{"name":"X-Fazy-Agent","in":"header","required":false,"schema":{"type":"string","maxLength":32},"description":"Your agent's name, e.g. 'chatgpt' or 'my-shopping-bot'. Attributes the shopper's click to you."}],"responses":{"200":{"description":"A page of deals","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","required":["object","id","title","price","merchant","url"],"properties":{"object":{"type":"string","enum":["deal"]},"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"brand":{"type":["string","null"]},"category":{"type":["string","null"]},"product_type":{"type":["string","null"]},"price":{"type":"object","properties":{"amount":{"type":"integer","description":"US cents"},"currency":{"type":"string","enum":["USD"]}}},"reference_price":{"type":["object","null"],"properties":{"amount":{"type":"integer"},"currency":{"type":"string"}}},"discount_pct":{"type":["integer","null"]},"merchant":{"type":"object","properties":{"name":{"type":"string"}}},"image":{"type":["string","null"],"format":"uri"},"url":{"type":"string","format":"uri","description":"Give this to the shopper unchanged. It redirects to the retailer's product page."},"price_checked_at":{"type":["string","null"],"format":"date-time"},"in_stock":{"type":["boolean","null"]},"summary":{"type":["string","null"]}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"total":{"type":"integer"}}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Rate limited; see retry-after","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/deals/{id}":{"get":{"operationId":"getDeal","summary":"One deal by id","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Fazy-Agent","in":"header","required":false,"schema":{"type":"string","maxLength":32},"description":"Your agent's name, e.g. 'chatgpt' or 'my-shopping-bot'. Attributes the shopper's click to you."}],"responses":{"200":{"description":"The deal","content":{"application/json":{"schema":{"type":"object","required":["object","id","title","price","merchant","url"],"properties":{"object":{"type":"string","enum":["deal"]},"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"brand":{"type":["string","null"]},"category":{"type":["string","null"]},"product_type":{"type":["string","null"]},"price":{"type":"object","properties":{"amount":{"type":"integer","description":"US cents"},"currency":{"type":"string","enum":["USD"]}}},"reference_price":{"type":["object","null"],"properties":{"amount":{"type":"integer"},"currency":{"type":"string"}}},"discount_pct":{"type":["integer","null"]},"merchant":{"type":"object","properties":{"name":{"type":"string"}}},"image":{"type":["string","null"],"format":"uri"},"url":{"type":"string","format":"uri","description":"Give this to the shopper unchanged. It redirects to the retailer's product page."},"price_checked_at":{"type":["string","null"],"format":"date-time"},"in_stock":{"type":["boolean","null"]},"summary":{"type":["string","null"]}}}}}},"404":{"description":"No live deal with that id","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"message":{"type":"string"}}}}}}}}}}}}}