{"uid":"cap_34wRxrRrJFYhgY92j2vC8","slug":"api-crushrewards-dev-5e870e16","name":"CrushRewards Deal Finder","description":"Real-time pricing, promotions, and competitive intelligence across US and Canadian retailers — exposed as paid API endpoints and MCP tools that AI agents can call directly, with x402 and MPP micropayments per query.","url":"https://api.crushrewards.dev/v1/shopper/deal-finder","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"json"},"example":{"request":{"country":"us","category":"electronics","retailer":"amazon","min_discount_pct":15},"response":{"deals":[{"brand":"GNMN","price":79.99,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"93916ffd8adc85842c6397a54c0ba436","list_price":179.99,"observed_at":"2026-06-12T06:06:32.470Z","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":"Apple","price":159.99,"in_stock":true,"retailer":"amazon","condition":"refurbished","entity_uid":"25bb6a340e33efe38aca3ca97bd593bf","list_price":263.86,"observed_at":"2026-06-12T06:06:32.470Z","product_uid":"amazon:B0CP4CG1ZB","star_rating":null,"discount_pct":39.4,"product_name":"Apple AirPods Pro (2nd Generation) with USB-C Charging Case (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-12T06:06:32.470Z","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":"Beats","price":129.95,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"783821adb7e62a2f259b5e96797d1372","list_price":199.95,"observed_at":"2026-06-12T06:06:32.470Z","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":"Soundcore","price":26.99,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"d3d2e6ba3f8c11966b80ade1c3646ccd","list_price":49.99,"observed_at":"2026-06-12T06:06:32.470Z","product_uid":"amazon:B0DJW5G283","star_rating":null,"discount_pct":46,"product_name":"Soundcore Q11i Wireless Over-Ear Bluetooth Headphones by Anker, Deep Bass, 60H Playtime, Hi-Res Audio, Detachable Ear Cushions, Multipoint Connection","review_count":null},{"brand":"soundcore","price":19.99,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"b9593322cac325566f4761355442994a","list_price":39.99,"observed_at":"2026-06-12T06:06:32.470Z","product_uid":"amazon:B0BTYCRJSS","star_rating":null,"discount_pct":50,"product_name":"soundcore by Anker P20i True Wireless Earbuds, 10mm Drivers with Big Bass, Bluetooth 5.3, 30H Long Playtime, IPX5 Water-Resistant, 2 Mics for AI Clear Calls, 22 Preset EQs, Customization via App","review_count":null},{"brand":"JBL","price":63.99,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"23910760a20b4d1b6fda766f17ea0b94","list_price":99.95,"observed_at":"2026-06-12T06:06:32.470Z","product_uid":"amazon:B0C1QNRGHC","star_rating":null,"discount_pct":36,"product_name":"JBL Tune Flex - True Wireless Noise Cancelling Earbuds (Black)","review_count":null},{"brand":"soundcore","price":34.99,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"b210115dff42b68d2f58a07421ba82c6","list_price":59.99,"observed_at":"2026-06-12T06:06:32.470Z","product_uid":"amazon:B0FNWCYLZN","star_rating":null,"discount_pct":41.7,"product_name":"soundcore P31i by Anker, Real-Time Adaptive Noise Cancelling, Hi-Res Sound, Translation Earbuds, 50H Playtime, Wireless Earbuds, Bluetooth Earphones, Spatial Audio, Fast Charging, IP55","review_count":null},{"brand":"Apple","price":179,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"74341270164bdbc0f481ff5b5cf54cd6","list_price":249,"observed_at":"2026-06-12T06:06:32.470Z","product_uid":"amazon:B0FQFB8FMG","star_rating":null,"discount_pct":28.1,"product_name":"Apple AirPods Pro 3 Wireless Earbuds, Active Noise Cancellation, Live Translation, Heart Rate Sensing, Hearing Aid Feature, Bluetooth Headphones, Spatial Audio, High-Fidelity Sound, USB-C Charging","review_count":null},{"brand":"soundcore","price":20.99,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"b9593322cac325566f4761355442994a","list_price":39.99,"observed_at":"2026-06-12T06:06:32.470Z","product_uid":"amazon:B0BTYCJXBK","star_rating":null,"discount_pct":47.5,"product_name":"soundcore by Anker P20i True Wireless Earbuds, 10mm Drivers with Big Bass, Bluetooth 5.3, 30H Long Playtime, IPX5 Water-Resistant, 2 Mics for AI Clear Calls, 22 Preset EQs, Customization via App","review_count":null},{"brand":"Skullcandy","price":29.99,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"a8cbf715535f201e240aa98e6445581b","list_price":51.99,"observed_at":"2026-06-12T06:06:32.470Z","product_uid":"amazon:B0B75MQJQR","star_rating":null,"discount_pct":42.3,"product_name":"Skullcandy Riff Wireless 2 On-Ear Bluetooth Headphones, Up to 34 Hrs Battery, Foldable Lightweight Design, Convenient for Travel with Included 3.5mm AUX Cable, Microphone for iPhone Android - Black","review_count":null},{"brand":"Sony","price":94.5,"in_stock":true,"retailer":"amazon","condition":"refurbished","entity_uid":"6ce69f1372804a6ce4aa1dcd4dea6bbf","list_price":138,"observed_at":"2026-06-12T06:06:32.470Z","product_uid":"amazon:B07M6MRQMP","star_rating":null,"discount_pct":31.5,"product_name":"Sony WH-RF400 RF400 Wireless Home Theater Headphones (Renewed)","review_count":null},{"brand":"JBL","price":39.95,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"0d0a46992bc0ace2e4a0fe524ae56eca","list_price":64.95,"observed_at":"2026-06-12T06:06:32.470Z","product_uid":"amazon:B0DN45YMP6","star_rating":null,"discount_pct":38.5,"product_name":"JBL Vibe Beam 2 - True Wireless Noise Cancelling Earbuds - Black","review_count":null},{"brand":"Sony","price":248,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"72c78f1401cd88dac12723819f7c6cd2","list_price":329.99,"observed_at":"2026-06-12T06:06:32.470Z","product_uid":"amazon:B0C33XXS56","star_rating":null,"discount_pct":24.8,"product_name":"Sony WF-1000XM5 The Best Truly Wireless Bluetooth Noise Cancelling Earbuds Headphones with Alexa Built in, Black","review_count":null},{"brand":"soundcore","price":29.99,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"718c41cf4c6d3e8cdfeff496c72ba480","list_price":49.99,"observed_at":"2026-06-12T06:06:32.470Z","product_uid":"amazon:B0D2XRXNGY","star_rating":null,"discount_pct":40,"product_name":"soundcore V20i by Anker Open-Ear Headphones, Adjustable Ear Hooks, Ultra-Comfort, Snug Fit, Powerful Sound, Clear Calls, IP55, LED Lights, 36H Playtime, Bluetooth 5.4 Earbuds, Multipoint Connection","review_count":null},{"brand":"Skullcandy","price":90.99,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"3c57b1eec6b4584220d6641501aa9045","list_price":129.99,"observed_at":"2026-06-12T06:06:32.470Z","product_uid":"amazon:B0DWC512JJ","star_rating":null,"discount_pct":30,"product_name":"Skullcandy Method 360 ANC Wireless Earbuds, Sound by Bose, Bluetooth Headphones, Premium Noise Cancelling, Up to 40 Hrs Battery, Sweat and Water Resistant, Microphone for iPhone Android - True Black","review_count":null},{"brand":"Beats","price":149.99,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"6d75c6129dc1495cb0584d6a8789d7f6","list_price":199.95,"observed_at":"2026-06-12T06:06:32.470Z","product_uid":"amazon:B09JL41N9C","star_rating":null,"discount_pct":25,"product_name":"Beats Fit Pro (1st Gen) - True Wireless Noise Cancelling Earbuds - Active Noise Cancelling - Sweat Resistant Earphones, Compatible with Apple & Android, Class 1 Bluetooth®- Beats Black","review_count":null},{"brand":"JBL","price":39.95,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"1901a2a4049bc22e6c038f7a58844f6e","list_price":59.95,"observed_at":"2026-06-12T06:06:32.470Z","product_uid":"amazon:B0CQ1HP3RX","star_rating":null,"discount_pct":33.4,"product_name":"JBL Tune 520BT - Wireless On-Ear Headphones, Up to 57H Battery Life and Speed Charge, Lightweight, Comfortable and Foldable Design, Hands-Free Calls with Voice Aware (Purple)","review_count":null},{"brand":"PocBuds","price":24.64,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"5a62966f8f07ee6ff1dfccb072c5c1da","list_price":39.99,"observed_at":"2026-06-12T06:06:32.470Z","product_uid":"amazon:B0C3W4MNN1","star_rating":null,"discount_pct":38.4,"product_name":"PocBuds Wireless Earbuds Bluetooth Headphones with Wireless Charging Case Over-Ear Buds with Earhooks Built-in Mic Headset for Workout","review_count":null},{"brand":"bmani","price":24.66,"in_stock":true,"retailer":"amazon","condition":"new","entity_uid":"99de7307b07fa2726a818478c8467fdf","list_price":39.99,"observed_at":"2026-06-12T06:06:32.470Z","product_uid":"amazon:B09FLNSYDZ","star_rating":null,"discount_pct":38.3,"product_name":"bmani Wireless Earbuds Bluetooth Headphones 48hrs Play Back Sport Earphones with LED Display Over-Ear Buds with Earhooks Built-in Mic Headset for Workout Black","review_count":null}],"country":"us","category":"electronics","currency":"USD","total_deals_found":20}},"exampleRequest":{"country":"us","category":"electronics","retailer":"amazon","min_discount_pct":15},"tags":["x402"],"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_T8TShUfFI013kRpgxfqBh","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 category above a minimum discount threshold, ranked by discount depth with price, list price, and retailer.","exampleAgentPrompt":"Find me the top 10 deals in the electronics category on Amazon in the US with at least 25% off, ranked by biggest discount.","exampleUseCases":null,"resultDescription":"A list of up to 50 deal objects each containing product name, retailer, current price, list price, discount percentage, brand, in-stock status, star rating, and review count — plus top-level metadata for category, country, currency, and total deals found.","failureModes":["Missing required 'category' parameter returns a 400 validation error","Unsupported retailer value outside the allowed enum returns a validation error","Unsupported country code outside 'us'/'ca' returns a validation error","min_discount_pct out of range (0-100) returns a validation error","Payment not provided or insufficient USDC balance returns a 402 Payment Required","No deals found for a niche category returns an empty deals array with total_deals_found of 0"],"whenToPreferThis":"Use this endpoint when you need to surface actively-promoted, discounted products in a specific category ranked by discount depth — especially when you want to filter by a minimum discount threshold and optionally restrict to a single retailer. Prefer this over general product search when the goal is finding deals and promotions rather than browsing all products in a category.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:31:13.098Z","isFirstParty":false}