{"uid":"cap_V93oOQrDTo5elb1C3bv9m","slug":"agents-openwebninja-com-amazon-deals-api-3a980765","name":"Amazon Deals API","description":"Get Amazon Deals (Today's Deals / Top Deals, Best Deals, and Lightning Deals)  with support for all deal types, filters, and options available on Amazon.","url":"https://agents.openwebninja.com/realtime-amazon-data/deals-v2?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"brands":{"type":"string","description":"Return deals with products by specific brands.  \n  Multiple brands can be specified separated by comma (,).  \n  In addition, brand names can be found under the Brand filter on the filter/refinements panel on https://www.amazon.com/deals (when applicable)."},"fields":{"type":"string","description":"A comma separated list of deal fields to include in the response (field projection).  \n  By default all fields are returned."},"offset":{"type":"string","description":"Number of results to skip / index to start from (for pagination). Works with multiples of 30 (like on Amazons deals page) - 0, 30, 60, 90, etc."},"country":{"enum":["US","AU","BR","CA","CN","FR","DE","IN","IT","MX","NL","SG","ES","TR","AE","GB","JP","SA","PL","SE","BE","EG","ZA","IE"],"type":"string","default":"US","description":"Sets the Amazon domain, marketplace country, language and currency."},"language":{"type":"string","description":"The language of the results. In case not specified, results will be returned in the default domain language.  \n\n  **Supported languages per country:**  \n  `US`: en_US, es_US  \n  `AU`: en_AU  \n  `BR`: pt_BR  \n  `CA`: en_CA, fr_CA  \n  `FR`: fr_FR, en_GB  \n  `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK  \n  `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN  \n  `IT`: it_IT, en_GB  \n  `MX`: es_MX  \n  `NL`: nl_NL, en_GB  \n  `SG`: en_SG  \n  `ES`: es_ES, pt_PT, en_GB  \n  `TR`: tr_TR  \n  `AE`: en_AE, ar_AE  \n  `GB`: en_GB  \n  `JP`: ja_JP, en_US, zh_CN  \n  `SA`: ar_AE, en_AE  \n  `PL`: pl_PL  \n  `SE`: sv_SE, en_GB  \n  `BE`: fr_BE, nl_BE, en_GB  \n  `EG`: ar_AE, en_AE  \n  `ZA`: en_ZA  \n  `IE`: en_IE   "},"categories":{"type":"string","description":"Return deals with products in specific categories / departments.  \n  Multiple categories can be specified as a comma (,) separated list.  \n  Numeric category id's can be found in the URL after selecting a specific category on https://www.amazon.com/deals."},"price_range":{"enum":["ALL","1","2","3","4","5"],"type":"string","default":"ALL","description":"Return deals with price within a specific price range.  \n  1 is lowest price range shown on Amazon (e.g. Under $25) while 5 is the highest price range (e.g. $200 & Above)."},"discount_range":{"enum":["ALL","1","2","3","4","5"],"type":"string","default":"ALL","description":"Return deals with discount within a specific discount range.  \n  1 is lowest discount range shown on Amazon (e.g. 10% off or more) while 5 is the highest discount range (e.g. 70% off or more)."},"lightning_deals":{"type":"boolean","description":"Only return lightning deals"},"prime_exclusive":{"type":"boolean","description":"Only return prime exclusive deals."},"delivery_country":{"type":"string","description":"Delivery destination country (ISO 3166-1 alpha-2 code, e.g. `NL`). When set, delivery dates, shipping costs, availability and offers reflect delivery to this country instead of the marketplace's domestic delivery. Defaults to the marketplace country.  \n  Only specific `country` / `delivery_country` combinations are supported. Currently supported: `country` = `DE`, `FR`, `IT` or `ES` with `delivery_country` = `NL`.  \n  Other combinations return a 400 error. If you need another combination, contact us at support@openwebninja.com and we will look into adding it."},"prime_early_access":{"type":"boolean","description":"Only return prime early access deals."},"min_product_star_rating":{"enum":["ALL","1","2","3","4"],"type":"string","default":"ALL","description":"Return deals with products star rating greater than a specific value"}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"deals":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"Type classification of the deal"},"deal_id":{"type":"string","description":"Unique identifier for the deal"},"deal_url":{"type":"string","description":"URL to the deal page"},"deal_type":{"type":"string","description":"Type/category of the deal"},"deal_badge":{"type":"string","description":"Badge/label for the deal"},"deal_photo":{"type":"string","description":"URL of the deal image"},"deal_state":{"type":"string","description":"Current state/status of the deal"},"deal_title":{"type":"string","description":"Title/name of the deal"},"deal_ends_at":{"type":"string","description":"End timestamp of the deal"},"product_asin":{"type":"string","description":"ASIN of the product in deal"},"deal_starts_at":{"type":"string","description":"Start timestamp of the deal"},"canonical_deal_url":{"type":"string","description":"Canonical URL for the deal"},"savings_percentage":{"type":"integer","description":"Percentage discount offered"}}}},"domain":{"type":"string","description":"Amazon marketplace domain"},"country":{"type":"string","description":"Country code for the deals"},"total_deals":{"type":"string","nullable":true,"description":"Total number of deals (null if not available)"}}},"status":{"type":"string","description":"Status of the API response"},"request_id":{"type":"string","description":"Unique identifier for the API request"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","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":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_ZzOQ4xPizwGEnMFTiAC3u","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Fetches real-time Amazon deals including Today's Deals, Best Deals, and Lightning Deals with filtering by category, brand, rating, deal type, and country.","exampleAgentPrompt":"Can you pull up today's Lightning Deals and Best Deals on Amazon US in the Electronics and Kitchen categories, filtering for products with at least 4-star ratings?","exampleUseCases":[{"title":"Daily deal discovery for shoppers","prompt":"Show me all of today's top Amazon deals in the US, especially Lightning Deals in Electronics and Home & Kitchen — only show ones with at least 4-star ratings."},{"title":"Cross-country deal comparison","prompt":"Fetch Amazon deals in Germany and the UK for the Sports & Outdoors category so I can compare what's on sale across those two marketplaces right now."},{"title":"Brand-specific deal monitoring","prompt":"Find me any current Amazon deals in the US for products from Sony, Samsung, or Bose — I want to see the discount percentages and when each deal expires."}],"resultDescription":"Returns an array of deal objects each containing the deal title, type (e.g. Lightning Deal, Best Deal), URL, product ASIN, deal state, savings percentage, start/end timestamps, deal badge, and photo URL, plus top-level metadata including the Amazon domain, country, and total deal count.","failureModes":["Invalid country code returns 400 error","Unsupported country/delivery_country combination returns 400 error","Invalid category IDs return empty results or 400","Offset not a multiple of 30 may return unexpected results","Rate limiting or authentication failure returns 401/429","No deals matching filters returns empty deals array"],"whenToPreferThis":"Use this endpoint when you need real-time Amazon deal data across multiple countries and categories, with rich filtering options (brand, category, deal type, star rating). It is preferable over scraping Amazon directly and supports 24 country marketplaces with multilingual output.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:43.077Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-amazon-deals-api-3a980765"}