Amazon API
Deals
Get current Amazon deals with price, discount, rating, and category filters.
POST
$0.01/call/v1/amazon/dealsUsage
const res = await fetch('https://api.yepapi.com/v1/amazon/deals', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ country: 'US', page: 1 }),
});
const { data } = await res.json();
console.log(data);curl -X POST https://api.yepapi.com/v1/amazon/deals \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "US", "page": 1}'import requests
res = requests.post(
"https://api.yepapi.com/v1/amazon/deals",
headers={"x-api-key": "YOUR_API_KEY"},
json={"country": "US", "page": 1},
)
print(res.json()["data"])Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
country | string | No | ISO alpha-2 country code | US |
page | number | No | Page number (30 deals/page) | 1 |
price_range | string | No | Filter like ALL, UNDER_25, 25_50, 50_100, OVER_100 | ALL |
discount_range | string | No | ALL, 10_OFF, 25_OFF, 50_OFF, 70_OFF | ALL |
deal_type | string | No | e.g. BEST_DEAL, LIGHTNING_DEAL | — |
category | string | No | Amazon category slug | — |
min_rating | string | No | Minimum star rating filter | — |
Response
{
"ok": true,
"data": {
"status": "OK",
"request_id": "01ad1c29-5bf1-4f80-b321-009f1a64fa4e",
"parameters": { "country": "US", "price_range": "ALL", "discount_range": "ALL" },
"data": {
"deals": [
{
"deal_id": "64fc3cf8",
"deal_type": "BEST_DEAL",
"deal_title": "Ring Battery Doorbell, Head-to-Toe Video, Live View with Two-Way Talk",
"deal_photo": "https://m.media-amazon.com/images/I/51IswCEoJXL.jpg",
"deal_state": "AVAILABLE",
"deal_url": "https://www.amazon.com/Ring-Battery-Doorbell/dp/B0BZWRSRWV",
"canonical_deal_url": "https://www.amazon.com/deal/64fc3cf8",
"deal_starts_at": null,
"deal_ends_at": null,
"deal_price": { "amount": 59.99, "currency": "USD" },
"list_price": { "amount": 99.99, "currency": "USD" },
"savings_percentage": 40,
"savings_amount": { "amount": 40, "currency": "USD" },
"deal_badge": "40% off",
"type": "MULTI_ASIN",
"product_asin": "B0BZWRSRWV"
}
]
}
}
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.data.deals[].deal_id | string | Amazon deal ID |
data.data.deals[].deal_type | string | BEST_DEAL, LIGHTNING_DEAL, etc. |
data.data.deals[].deal_title | string | Deal title |
data.data.deals[].deal_photo | string | Image URL |
data.data.deals[].deal_state | string | AVAILABLE, EXPIRED, etc. |
data.data.deals[].deal_url | string | Direct product URL |
data.data.deals[].canonical_deal_url | string | Canonical Amazon deal URL |
data.data.deals[].deal_starts_at | string | null | ISO timestamp |
data.data.deals[].deal_ends_at | string | null | ISO timestamp |
data.data.deals[].deal_price.amount | number | Deal price amount |
data.data.deals[].deal_price.currency | string | ISO currency code |
data.data.deals[].list_price.amount | number | Original list price |
data.data.deals[].savings_percentage | number | Percent off |
data.data.deals[].savings_amount.amount | number | Absolute savings |
data.data.deals[].deal_badge | string | Formatted badge (e.g. "40% off") |
data.data.deals[].product_asin | string | ASIN of the featured product |