{"uid":"cap_gv_vHYqERzrMhGAfWLMRa","slug":"agents-openwebninja-com-amazon-promo-code-details-e96572c9","name":"Amazon Promo Code Details","description":"Get the products offered by an Amazon promo code.","url":"https://agents.openwebninja.com/realtime-amazon-data/promo-code-details?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["promo_code"],"properties":{"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   "},"promo_code":{"type":"string","description":"Promo code for which to get products.  \n  The promo code can be extracted from the /promocode Amazon URL.  \n  For example the promo code for https://www.amazon.com/promocode/A31M10S4V50SOU is A31M10S4V50SOU."},"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."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"domain":{"type":"string","description":"Amazon marketplace domain"},"country":{"type":"string","description":"Country where promotion is valid"},"products":{"type":"array","items":{"type":"object","properties":{"asin":{"type":"string","description":"Amazon Standard Identification Number"},"product_url":{"type":"string","description":"URL to the product page"},"product_photo":{"type":"string","description":"URL of the product image"},"product_price":{"type":"string","description":"Current price with promotion applied"},"product_title":{"type":"string","description":"Title of the product"},"product_num_ratings":{"type":"string","description":"Number of customer ratings"},"product_star_rating":{"type":"string","description":"Average customer rating"},"product_availability":{"type":"string","description":"Current stock availability status"}}}},"promo_title":{"type":"string","description":"Title of the promotion"},"is_promo_available":{"type":"boolean","description":"Whether the promotion is currently active"},"discount_percentage":{"type":"integer","description":"Percentage discount offered by the promotion"}}},"status":{"type":"string","description":"Status of the API response"},"parameters":{"type":"object","properties":{"country":{"type":"string","description":"Country code for the promotion"},"promo_code":{"type":"string","description":"Promotion code to apply"}}},"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_syRgOD36ROnx1Bew5z3iM","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":"Retrieves the products offered under a specific Amazon promo code, including discount details, pricing, and availability.","exampleAgentPrompt":"What products are included in Amazon promo code A31M10S4V50SOU in the US marketplace, and what percentage discount does it offer?","exampleUseCases":[{"title":"Validating a shared Amazon promo code","prompt":"I got an Amazon promo code SAVE25TECH from a friend — can you look it up and tell me what products it covers, what the discount is, and whether it's still active?"},{"title":"Comparing Amazon deals before checkout","prompt":"I'm shopping on Amazon US and have two promo codes: DEAL1ABC and DEAL2XYZ. Can you fetch the product lists and discount percentages for both so I can figure out which one saves me more?"},{"title":"International promo code lookup for German marketplace","prompt":"Can you check what products are available under Amazon promo code DEPROMO123 on the German Amazon marketplace, and return results in English?"}],"resultDescription":"Returns a structured object containing the promotion title, active status, discount percentage, and an array of products with each product's ASIN, title, URL, photo, current discounted price, star rating, number of ratings, and availability status, along with the marketplace domain and country.","failureModes":["Invalid or expired promo code returns is_promo_available: false or empty products array","Unsupported country/delivery_country combination returns 400 error","Malformed promo code string may return no results or an error","Rate limiting or upstream Amazon blocking may cause intermittent failures","Promo code only valid in specific country — wrong country parameter yields no products"],"whenToPreferThis":"Use this endpoint when you have an Amazon promo code (extracted from an amazon.com/promocode/ URL) and need to discover which products it applies to, what discount it provides, and whether it is currently active. This is the go-to endpoint for resolving Amazon promotional codes into actionable product and pricing data across 24 supported Amazon marketplaces.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:35:27.516Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-amazon-promo-code-details-e96572c9"}