# Amazon Promo Code Details > Amazon Promo Code Details is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14). Retrieves the products offered under a specific Amazon promo code, including discount details, pricing, and availability. ## Facts - Endpoint: GET https://agents.openwebninja.com/realtime-amazon-data/promo-code-details?utm_source=zero.xyz - Price: price unknown - Payment: MPP - Status: unknown - Last checked: 2026-10-14 - Activations on Zero: 0 - Provider: agents.openwebninja.com - Website: https://agents.openwebninja.com - Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-amazon-promo-code-details-e96572c9 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gv_vHYqERzrMhGAfWLMRa Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability agents-openwebninja-com-amazon-promo-code-details-e96572c9 ``` Example prompt: What products are included in Amazon promo code A31M10S4V50SOU in the US marketplace, and what percentage discount does it offer? ## When to prefer this 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. ## Known failure modes - 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 ## How this service works Get the products offered by an Amazon promo code. ## Output 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. ## Request schema (JSON Schema) ```json { "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." } } } ``` ## Response schema (JSON Schema) ```json { "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" } } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-amazon-promo-code-details-e96572c9/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)