{"uid":"cap_yHd6ep4Xk-q01vvnFSlz_","slug":"deal-finder-e24c72a3","name":"Deal Finder","description":"Discover actively-promoted discounted products in a category above a minimum discount threshold. Returns deals ranked by discount depth with price, list price, and retailer.","url":"https://api.syntalic.com/v1/shopper/deal-finder","method":"GET","headers":{},"bodySchema":{"type":"object","required":["category"],"properties":{"limit":{"type":"integer","default":20,"example":20,"maximum":50,"description":"Max results to return (default 20, max 50)"},"country":{"enum":["us","ca"],"type":"string","default":"us","example":"us","description":"Country (us or ca)"},"category":{"type":"string","example":"electronics","minLength":1,"description":"Product category (e.g., electronics, grocery, beauty). Fuzzy human-readable input — the resolver maps it through tier 1-4 (id → exact name → trigram → embedding kNN) to a canonical category_id. Pair with `category_id` if you have a deterministic id from a prior call."},"retailer":{"enum":["amazon","walmart","costco","homedepot","nordstrom","ikea"],"type":"string","example":"amazon","description":"Filter to a specific retailer"},"min_discount_pct":{"type":"integer","default":10,"example":10,"description":"Minimum discount percentage (default 10)"}},"additionalProperties":false},"responseSchema":{"type":"object","properties":{"deals":{"type":"array","items":{"type":"object"}},"category":{"type":"string"}}},"example":{"request":{"limit":10,"country":"us","category":"electronics","retailer":"amazon","min_discount_pct":20},"response":{"deals":[{"brand":"Panasonic","price":2645.91,"in_stock":true,"retailer":"amazon","condition":"refurbished","entity_uid":"022ea0e3e81f1023d00529407b82a36f","list_price":4760,"observed_at":"2026-06-17T06:13:56.861Z","product_uid":"amazon:B085GLCVNZ","star_rating":null,"discount_pct":44.4,"product_name":"Panasonic AG-CX350 4K Camcorder (Renewed)","review_count":null},{"brand":"GNMN","price":79.99,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"93916ffd8adc85842c6397a54c0ba436","list_price":179.99,"observed_at":"2026-06-14T06:05:50.532Z","product_uid":"amazon:B0GYQG8SWD","star_rating":null,"discount_pct":55.6,"product_name":"GNMN Active Noise Cancelling Ear Buds Wireless Earbuds 96hrs Playback Bluetooth Headphones Dual Battery Display Stereo Bass Earphones with Earhooks Microphone IPX7 Waterproof for Sports/Runing/Workout","review_count":null},{"brand":"Canon","price":1799,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"7eb3b18cbf79377a3642918834ea9b49","list_price":2498.01,"observed_at":"2026-06-17T06:13:56.861Z","product_uid":"amazon:B01KURGS9E","star_rating":null,"discount_pct":28,"product_name":"Canon EOS 5D Mark IV Full Frame Digital SLR Camera Body","review_count":null},{"brand":"Apple","price":157.97,"in_stock":true,"retailer":"amazon","condition":"refurbished","entity_uid":"25bb6a340e33efe38aca3ca97bd593bf","list_price":263.86,"observed_at":"2026-06-14T06:05:50.532Z","product_uid":"amazon:B0CP4CG1ZB","star_rating":null,"discount_pct":40.1,"product_name":"Apple AirPods Pro (2nd Generation) with USB-C Charging Case (Renewed)","review_count":null},{"brand":"Amazon Renewed","price":903.78,"in_stock":true,"retailer":"amazon","condition":"refurbished","entity_uid":"a9f372765536bc36594332c2ccf80ec0","list_price":1281.75,"observed_at":"2026-06-17T06:13:56.861Z","product_uid":"amazon:B079VGBX2H","star_rating":null,"discount_pct":29.5,"product_name":"Canon EOS 6D Mark II Digital SLR Camera Body (Renewed)","review_count":null},{"brand":"Beats","price":99.95,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"251dcfd0858968305b90c148e90dbd67","list_price":169.95,"observed_at":"2026-06-14T06:05:50.532Z","product_uid":"amazon:B0C2W1KLSS","star_rating":null,"discount_pct":41.2,"product_name":"Beats Studio Buds + | True Wireless Noise Cancelling Earbuds, Enhanced Apple & Android Compatibility, Built-in Microphone, Sweat Resistant Bluetooth Headphones, Spatial Audio - Black","review_count":null},{"brand":"Fitbit","price":99.95,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"faf8fbb06710f63873d49aaebea38a69","list_price":159.95,"observed_at":"2026-06-15T06:15:24.428Z","product_uid":"amazon:B0CC63GZ3R","star_rating":null,"discount_pct":37.5,"product_name":"Google Fitbit Charge 6 Advanced Health and Fitness Tracker with Built-in GPS, Stress Management Tools, Sleep Tracking, 24/7 Heart Rate and more -- Silver/White","review_count":null},{"brand":"Beats","price":129.95,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"783821adb7e62a2f259b5e96797d1372","list_price":199.95,"observed_at":"2026-06-14T06:05:50.532Z","product_uid":"amazon:B0CZPLV566","star_rating":null,"discount_pct":35,"product_name":"Beats Solo 4 - Wireless Bluetooth On-Ear Headphones, Apple & Android Compatible, Up to 50 Hours of Battery Life - Matte Black","review_count":null},{"brand":"Sony","price":38,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"823ab5b72781baed52d0c1948ccdc69e","list_price":69.99,"observed_at":"2026-06-15T06:15:24.428Z","product_uid":"amazon:B0BS1QB15L","star_rating":null,"discount_pct":45.7,"product_name":"Sony WH-CH520 Wireless Headphones Bluetooth On-Ear Headset with Microphone, White","review_count":null},{"brand":"Canon","price":499,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"727f052a9483c46fcf94a418dd5af35d","list_price":679,"observed_at":"2026-06-17T06:13:56.861Z","product_uid":"amazon:B0C5PGRP7V","star_rating":null,"discount_pct":26.5,"product_name":"Canon EOS R100 Mirrorless Camera RF-S18-45mm F4.5-6.3 is STM Lens Kit, 24.1 Megapixel CMOS (APS-C) Sensor, 4K Video, RF Mount, Black","review_count":null}],"country":"us","category":"electronics","currency":"USD","total_deals_found":10}},"exampleRequest":{"limit":10,"country":"us","category":"electronics","retailer":"amazon","min_discount_pct":20},"tags":["x402","shopping"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_aaRvnuPePOXqXgeawZ_0g","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Discovers actively-promoted discounted products in a given category above a minimum discount threshold, ranked by discount depth with price, list price, and retailer.","exampleAgentPrompt":"Find me the top 10 actively-promoted deals in electronics from Amazon in the US, with at least 20% off — ranked by biggest discount.","exampleUseCases":null,"resultDescription":"Returns a list of deal objects ranked by discount depth, each containing product details, current price, original list price, discount percentage, and retailer name, along with the resolved canonical category name.","failureModes":["Category not resolvable — if the provided category string is too vague or misspelled and cannot be mapped to a canonical category_id, the endpoint may return an empty deals array or an error","No deals found — if no products in the category meet the minimum discount threshold, an empty deals array is returned","Invalid retailer enum — if an unsupported retailer string is passed, a validation error is returned","Limit exceeded — if limit exceeds 50, a validation error is returned","Unsupported country — only 'us' and 'ca' are accepted; other values return a validation error","Payment failure — if the x402 micropayment of $0.01 USDC is not processed, the request is rejected"],"whenToPreferThis":"Use this endpoint when you need a curated list of currently active promotional deals within a broad product category, especially when you want to filter by retailer, minimum discount depth, or country. Prefer this over Best Price when you want category-wide deal discovery rather than price comparison for a specific known product. Prefer this over Promo Intelligence when you need actual product listings rather than aggregate promo statistics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:41:20.263Z","isFirstParty":false}