Amazon API
Products by Category
List Amazon products under any category node ID with filters for sort, price, and Prime.
POST
$0.01/call/v1/amazon/products-by-categoryUsage
const res = await fetch('https://api.yepapi.com/v1/amazon/products-by-category', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ category_id: '2478868012', country: 'US' }),
});
const { data } = await res.json();
console.log(data);curl -X POST https://api.yepapi.com/v1/amazon/products-by-category \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"category_id": "2478868012", "country": "US"}'import requests
res = requests.post(
"https://api.yepapi.com/v1/amazon/products-by-category",
headers={"x-api-key": "YOUR_API_KEY"},
json={"category_id": "2478868012", "country": "US"},
)
print(res.json()["data"])Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
category_id | string | Yes | Amazon category browse-node ID (numeric) | — |
country | string | No | ISO alpha-2 country code | US |
sort_by | string | No | RELEVANCE, LOWEST_PRICE, HIGHEST_PRICE, REVIEWS, NEWEST, BEST_SELLERS | RELEVANCE |
product_condition | string | No | ALL, NEW, USED, RENEWED, COLLECTIBLE | ALL |
page | number | No | Page number (48 products/page) | 1 |
is_prime | boolean | No | Only Prime-eligible | — |
deals_and_discounts | string | No | Discount filter | — |
Response
{
"ok": true,
"data": {
"status": "OK",
"request_id": "6dc35479-a1dc-45d4-828d-978ec94ebe61",
"parameters": { "category_id": "2478868012", "country": "US", "sort_by": "RELEVANCE", "page": 1 },
"data": {
"total_products": 975521,
"country": "US",
"domain": "www.amazon.com",
"products": [
{
"asin": "168281808X",
"product_title": "Untitled Empyrean (Not Book Four)",
"product_price": "$17.49",
"product_original_price": "$24.99",
"currency": "USD",
"product_star_rating": null,
"product_num_ratings": 0,
"book_format": "Hardcover",
"product_url": "https://www.amazon.com/dp/168281808X",
"product_photo": "https://m.media-amazon.com/images/I/716ogrQC-4L._AC_UL960_QL65_.jpg",
"product_num_offers": 1,
"product_minimum_offer_price": "$17.49",
"is_best_seller": false,
"is_amazon_choice": false,
"is_prime": false,
"has_variations": false
}
]
}
}
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.data.total_products | number | Total products in the category |
data.data.country | string | Country scoped to |
data.data.domain | string | Amazon domain |
data.data.products[].asin | string | ASIN |
data.data.products[].product_title | string | Title |
data.data.products[].product_price | string | Current price |
data.data.products[].product_original_price | string | null | MSRP if discounted |
data.data.products[].currency | string | ISO currency code |
data.data.products[].product_star_rating | string | null | Average rating |
data.data.products[].book_format | string | Present for books (Hardcover, Paperback, etc.) |
data.data.products[].product_url | string | Amazon URL |
data.data.products[].product_photo | string | Image URL |
data.data.products[].product_num_offers | number | Third-party offer count |
data.data.products[].product_minimum_offer_price | string | Lowest available price across offers |
data.data.products[].is_amazon_choice | boolean | Amazon's Choice badge |
data.data.products[].is_prime | boolean | Prime-eligible |
data.data.products[].has_variations | boolean | Has variations |