> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keyapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Promo Code Detail
> Retrieve products and discount details associated with a specific Amazon promotional code.
🪙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.
## OpenAPI
````yaml en/amazon.openapi.json GET /v1/amazon/promo-code-details
openapi: 3.0.1
info:
title: Amazon API english documentation
description: >-
The english reference documentation of the Amazon API includes the
interface's purpose, parameter description, response status, and sample
structure.
version: 1.0.0
servers:
- url: https://api.keyapi.ai
description: Production
security: []
tags: []
paths:
/v1/amazon/promo-code-details:
get:
tags: []
summary: Promo Code Detail
description: >-
Retrieve products and discount details associated with a specific Amazon
promotional code.
parameters:
- name: promo_code
in: query
description: >-
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.
required: true
example: AZDIA7AYE39P2
schema:
type: string
- name: country
in: query
description: >-
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
required: false
example: us
schema:
type: string
default: us
- name: language
in: query
description: >-
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
required: false
schema:
type: string
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
properties: {}
example:
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
headers: {}
'400':
description: Bad Request
content:
application/json:
schema:
type: object
example:
code: 400
data: null
message: 'Missing required parameter: handle'
'401':
description: Unauthorized
content:
application/json:
schema:
type: object
example:
code: 401
data: null
message: apiKey is null
'402':
description: Payment Required
content:
application/json:
schema:
type: object
example:
code: 402
data: null
message: apiKey quota is not enough
'429':
description: Too Many Requests
content:
application/json:
schema:
type: object
example:
code: 429
data: null
message: qps limit exceeded
'500':
description: Internal Server Error
content:
application/json:
schema:
type: object
example:
code: 500
data: null
message: Internal server error
deprecated: false
security:
- JWT Bearer: []
x-codeSamples:
- lang: curl
label: cURL
source: |-
curl --request GET \
--url 'https://api.keyapi.ai/v1/amazon/promo-code-details?promo_code=AZDIA7AYE39P2&country=us' \
--header 'Authorization: Bearer '
- lang: python
label: Python
source: |-
import requests
response = requests.get(
'https://api.keyapi.ai/v1/amazon/promo-code-details',
params={"promo_code": "AZDIA7AYE39P2", "country": "us"},
headers={'Authorization': 'Bearer '}
)
print(response.json())
- lang: javascript
label: JavaScript
source: >-
const params = new URLSearchParams({"promo_code": "AZDIA7AYE39P2",
"country": "us"});
const response = await
fetch(`https://api.keyapi.ai/v1/amazon/promo-code-details?${params}`,
{
method: 'GET',
headers: { 'Authorization': 'Bearer ' }
});
const data = await response.json();
console.log(data);
components:
securitySchemes:
JWT Bearer:
type: http
scheme: bearer
bearerFormat: JWT
description: |-
API key for authentication. Format: `sk_live_xxxxxxxxxxxxx`
Get your API key from the [Dashboard](http://keyapi.ai/app/dashboard).
````