Search Deals
search_dealsFull Description
Search for COUPON CODES by merchant/brand name.
Do not use this tool unless the user is explicitly asking for deals, coupon codes, discounts, or other indicators that suggest the user wants to see deals on brands or product categories.
EXTRACT merchant/brand names from user queries:
- When user names a specific brand, just use that brand.
- When user asks for a product/category without naming a brand, provide at least
20 well-known merchants/brands that sell those products.
ONLY returns deals with coupon codes.
Examples:
- "Nike running shoes" → merchants=['Nike']
- "Nike or Adidas shoes" → merchants=['Nike', 'Adidas']
- "iHerb vitamins" → merchants=['iHerb']
- "gaming laptops" → merchants=['Best Buy', 'Newegg', 'Lenovo', 'Dell']
- "Best Buy" → merchants=['Best Buy']
- "makeup deals" → merchants=['Sephora', 'Ulta', 'MAC', 'NYX', 'Tarte']
Parameters (1 required)
merchantsarrayBRAND or MERCHANT NAMES to search for deals from. Our search matches deals by merchant name, so providing the right brands is critical for good results. WHEN USER NAMES A SPECIFIC BRAND — just use that brand: 'Show me Nike deals' → merchants=['Nike'] | 'Nike or Adidas running shoes' → merchants=['Nike', 'Adidas'] | 'iHerb vitamin coupons' → merchants=['iHerb'] | WHEN USER ASKS FOR A PRODUCT/CATEGORY (no specific brand) — you MUST provide at least 20 well-known merchant/brand names that sell those products. Think broadly about who sells in that space (direct brands + major retailers): 'gaming laptops' → merchants=['Best Buy', 'Newegg', 'Lenovo', 'Dell', 'HP', 'ASUS', 'MSI', 'Acer', 'Micro Center'] | 'running shoes deals' → merchants=['Nike', 'Adidas', 'New Balance', 'ASICS', 'Brooks', 'Hoka', 'Saucony', 'On Running', 'Foot Locker', 'Dick\'s Sporting Goods'] | 'organic baby food' → merchants=['Earth\'s Best', 'Happy Baby', 'Gerber', 'Plum Organics', 'Serenity Kids', 'Once Upon a Farm', 'Target', 'Walmart', 'Amazon', 'Thrive Market'] | 'makeup deals' → merchants=['Sephora', 'Ulta', 'MAC', 'NYX', 'Tarte', 'Too Faced', 'Charlotte Tilbury', 'Fenty Beauty', 'Glossier', 'ColourPop', 'e.l.f.'] | Strategy: For brand-specific queries, just pass the brand(s). For product/category queries, provide at least 20 merchants — more merchants = better results.