Amazon API
Best Sellers
Get Amazon's best sellers, hot new releases, or most-wished-for items for any category.
POST
$0.01/call/v1/amazon/best-sellersUsage
const res = await fetch('https://api.yepapi.com/v1/amazon/best-sellers', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ category: 'software', type: 'BEST_SELLERS' }),
});
const { data } = await res.json();
console.log(data);curl -X POST https://api.yepapi.com/v1/amazon/best-sellers \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"category": "software", "type": "BEST_SELLERS"}'import requests
res = requests.post(
"https://api.yepapi.com/v1/amazon/best-sellers",
headers={"x-api-key": "YOUR_API_KEY"},
json={"category": "software", "type": "BEST_SELLERS"},
)
print(res.json()["data"])Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
category | string | Yes | Amazon leaf category slug (e.g. software, home-garden) — see /v1/amazon/categories | — |
country | string | No | ISO alpha-2 country code | US |
type | string | No | BEST_SELLERS, HOT_NEW_RELEASES, HIGH_RATED | BEST_SELLERS |
page | number | No | Page number (50 items/page) | 1 |
Response
{
"ok": true,
"data": {
"status": "OK",
"request_id": "ccb92b08-2845-4f7d-a2c5-aa9ef0bd5e85",
"parameters": { "country": "US", "type": "BEST_SELLERS", "page": 1, "category": "software" },
"data": {
"best_sellers": [
{
"rank": 1,
"asin": "B0FWV56H48",
"product_title": "TurboTax Deluxe Desktop Edition 2025, Federal & State Tax Return [Win11/Mac14 Download]",
"product_price": "$79.99",
"product_star_rating": "3.7",
"product_num_ratings": 4969,
"product_url": "https://www.amazon.com/dp/B0FWV56H48",
"product_photo": "https://images-na.ssl-images-amazon.com/images/I/71OcM906MLL._AC_UL900_SR900,600_.jpg",
"rank_change_label": null
},
{
"rank": 2,
"asin": "B0FRPW868X",
"product_title": "H&R Block Tax Software Deluxe + State 2025 Win/Mac",
"product_price": "$49.97",
"product_star_rating": "3.8",
"product_num_ratings": 2300,
"product_url": "https://www.amazon.com/dp/B0FRPW868X",
"product_photo": "https://images-na.ssl-images-amazon.com/images/I/611uM-FzipL._AC_UL900_SR900,600_.jpg",
"rank_change_label": null
}
]
}
}
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.data.best_sellers[].rank | number | 1-based rank within the category |
data.data.best_sellers[].asin | string | ASIN |
data.data.best_sellers[].product_title | string | Title |
data.data.best_sellers[].product_price | string | Current price |
data.data.best_sellers[].product_star_rating | string | Average rating |
data.data.best_sellers[].product_num_ratings | number | Rating count |
data.data.best_sellers[].product_url | string | Product URL |
data.data.best_sellers[].product_photo | string | Image URL |
data.data.best_sellers[].rank_change_label | string | null | e.g. "+3" or null if unchanged |