Skip to main content
GET
/
v1
/
amazon
/
promo-code-details
cURL
curl --request GET \
  --url 'https://api.keyapi.ai/v1/amazon/promo-code-details?promo_code=AZDIA7AYE39P2&country=us' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'
{
  "code": 0,
  "message": "success",
  "data": {
    "promo_title": "Promotion has ended",
    "is_promo_available": false,
    "discount_percentage": null,
    "products": [
      {
        "asin": "B0C592S4S5",
        "product_title": "ArtbyHannah Framed Fall Wall Art, Thanksgiving Pictures Wall Decor with Autumn Pumpkin Prints Harvest Home Decorations for Living Room Kitchen Mantel Porch Entryway Bathroom (11x14 Inch, 3 Pack)",
        "product_price": "$24.99",
        "product_url": "https://www.amazon.com/dp/B0C592S4S5",
        "product_star_rating": null,
        "product_num_ratings": null,
        "product_photo": "https://m.media-amazon.com/images/I/41j9PW7d70L._SR400,400_.jpg",
        "product_availability": "In Stock"
      },
      {
        "asin": "B0D1GHMV2B",
        "product_title": "ArtbyHannah Framed Thanksgiving Wall Decor, Fall Pictures Wall Art with Pumpkin Prints Autumn Harvest Home Decorations for Living Room Kitchen Mantel Porch Entryway (11x14 Inch, 3 Pack)",
        "product_price": "$27.99",
        "product_url": "https://www.amazon.com/dp/B0D1GHMV2B",
        "product_star_rating": null,
        "product_num_ratings": null,
        "product_photo": "https://m.media-amazon.com/images/I/41bKFDWmqPL._SR400,400_.jpg",
        "product_availability": "In Stock"
      },
      {
        "asin": "B0D1GH53BD",
        "product_title": "ArtbyHannah Framed 3D Thanksgiving Wall Decor, Fall Pictures Wall Art with Pumpkin Prints Autumn Harvest Home Decorations for Living Room Kitchen Porch Entryway Bathroom (12x16 Inch)",
        "product_price": "$19.99",
        "product_url": "https://www.amazon.com/dp/B0D1GH53BD",
        "product_star_rating": null,
        "product_num_ratings": null,
        "product_photo": "https://m.media-amazon.com/images/I/41zJ3p9fgkL._SR400,400_.jpg",
        "product_availability": "In Stock"
      }
    ],
    "country": "US",
    "domain": "www.amazon.com"
  },
  "requestId": "ad110e65-2364-4f96-8341-ab2dd6d71cbc"
}
🪙3 creditsper request

​
Copy for AI

🤖 Why Code When AI Can Do It For You?

Stop writing code like it’s 1970! Let AI do the heavy lifting - click the sparkles to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.

Authorizations

​
Authorization
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx Get your API key from the Dashboard.

Query Parameters

​
promo_code
string
required

Promo code for which to get products. The promo code can be extracted from the /promocode Amazon URL. For example the promo code for https://www.amazon.com/promocode/A31M10S4V50SOU is A31M10S4V50SOU.

​
country
string
default:us

Sets the Amazon domain, marketplace country, language and currency. Allowed values: US, AU, BR, CA, CN, FR, DE, IN, IT, MX, NL, SG, ES, TR, AE, GB, JP, SA, PL, SE, BE, EG, ZA, IE

​
language
string

The language of the results. In case not specified, results will be returned in the default domain language. Supported languages per country: US: en_US, es_US AU: en_AU BR: pt_BR CA: en_CA, fr_CA FR: fr_FR, en_GB DE: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK IN: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN IT: it_IT, en_GB MX: es_MX NL: nl_NL, en_GB SG: en_SG ES: es_ES, pt_PT, en_GB TR: tr_TR AE: en_AE, ar_AE GB: en_GB JP: ja_JP, en_US, zh_CN SA: ar_AE, en_AE PL: pl_PL SE: sv_SE, en_GB BE: fr_BE, nl_BE, en_GB EG: ar_AE, en_AE ZA: en_ZA IE: en_IE

Response

The response is of type object.