Amazon products by category API
GET /products-by-category lists the products Amazon shows for a category with no search keyword, one page at a time, up to page 20. It accepts the same category values as /search, a search alias such as electronics or a numeric browse node ID, and returns the same result fields: ASIN, title, price, rating and flags.
Part of Amazon Data API, sold on RapidAPI with a free plan of 100 requests a month. Endpoint details checked 2026-11-03.
What GET /products-by-category returns
Lists the products Amazon shows for a category with no search keyword, one page at a time. Takes the same category values as /search: a search alias such as electronics, or a numeric browse node ID. Returns the same result fields as /search.
Parameters
| Name | Required | Values | Notes |
|---|---|---|---|
category | yes | matches ^[A-Za-z0-9-]+$ | Amazon search category alias (e.g. electronics) or numeric browse node ID (e.g. 172282). Same values as /search. |
country | no | US, CA, MX, BR, GB, DE, FR, IT, ES, NL, SE, PL, BE, TR, AE, SA, EG, IN, JP, SG, AU, IE, ZA | Amazon marketplace, as an ISO country code. GB is amazon.co.uk. Default US (amazon.com). |
page | no | 1 to 20 (default 1) | |
sort | no | relevance, price_asc, price_desc, reviews, newest, bestsellers |
Example request
Every parameter that has an example, with country set explicitly. Send your key in X-RapidAPI-Key.
curl --request GET \
--url 'https://amazon-data-api-search-product-reviews-best-sellers.p.rapidapi.com/products-by-category?category=electronics&country=US' \
--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
--header 'X-RapidAPI-Host: amazon-data-api-search-product-reviews-best-sellers.p.rapidapi.com'import requests
resp = requests.get(
"https://amazon-data-api-search-product-reviews-best-sellers.p.rapidapi.com/products-by-category",
params={"category": "electronics", "country": "US"},
headers={
"X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
"X-RapidAPI-Host": "amazon-data-api-search-product-reviews-best-sellers.p.rapidapi.com",
},
timeout=30,
)
resp.raise_for_status()
body = resp.json()
if "error" in body: # bad input or not found: HTTP 200 with an error body
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"])const url = new URL('https://amazon-data-api-search-product-reviews-best-sellers.p.rapidapi.com/products-by-category');
url.search = new URLSearchParams({ category: 'electronics', country: 'US' });
const res = await fetch(url, {
headers: {
'X-RapidAPI-Key': process.env.RAPIDAPI_KEY,
'X-RapidAPI-Host': 'amazon-data-api-search-product-reviews-best-sellers.p.rapidapi.com',
},
});
const { data, meta } = await res.json();
console.log(data, meta.fetched_at);Example response
A recorded response, shortened to 3 items per list.
{
"data": {
"category": "electronics",
"page": 1,
"results": [
{
"position": 1,
"asin": "B0FQFB8FMG",
"title": "Apple AirPods Pro 3 Wireless Earbuds with Active Noise Cancellation",
"url": "https://www.amazon.com/dp/B0FQFB8FMG",
"image": "https://m.media-amazon.com/images/I/61solmQSSlL._AC_UL320_.jpg",
"price": 199,
"original_price": 249,
"currency": "USD",
"rating": 4.4,
"total_ratings": 17060,
"is_prime": null,
"is_sponsored": false,
"is_amazon_choice": false,
"is_best_seller": true,
"sales_volume": "10K+ bought in past month",
"subtitle": "Live Translation, Heart Rate Sensing, Hearing Aid Feature, Bluetooth Headphones, Spatial Audio, USB-C Charging",
"badges": [
"Best Seller"
],
"best_seller_category": "in Earbud & In-Ear Headphones",
"amazon_choice_keyword": null,
"deal_badge": null,
"sustainability": false,
"is_small_business": false,
"seller_id": "ATVPDKIKX0DER",
"image_large": "https://m.media-amazon.com/images/I/61solmQSSlL._AC_UL960_FMwebp_QL65_.jpg",
"authors": [],
"publication_date": null,
"formats": [],
"series": null,
"unit_price": null,
"original_price_type": "List",
"savings_percent": null,
"coupon": null,
"promotions": [],
"more_buying_choices": {
"price": 183.44,
"offers_count": 7,
"text": "$183.44 (7+ used & new offers)"
},
"delivery": {
"text": "FREE delivery Mon, Nov 2",
"fastest_text": null
},
"stock_left": null,
"points": null,
"installments": null
},
{
"position": 2,
"asin": "B07RZ3LSHM",
"title": "Complete Protect: One plan covers eligible past & future Amazon Purchases",
"url": "https://www.amazon.com/dp/B07RZ3LSHM",
"image": "https://m.media-amazon.com/images/I/41UPkD0ruML._AC_UL320_.jpg",
"price": 16.99,
"original_price": null,
"currency": "USD",
"rating": 4.3,
"total_ratings": 11304,
"is_prime": null,
"is_sponsored": false,
"is_amazon_choice": false,
"is_best_seller": false,
"sales_volume": null,
"subtitle": null,
"badges": [],
"best_seller_category": null,
"amazon_choice_keyword": null,
"deal_badge": null,
"sustainability": false,
"is_small_business": false,
"seller_id": null,
"image_large": "https://m.media-amazon.com/images/I/41UPkD0ruML._AC_UL960_FMwebp_QL65_.jpg",
"authors": [],
"publication_date": null,
"formats": [],
"series": null,
"unit_price": null,
"original_price_type": null,
"savings_percent": null,
"coupon": null,
"promotions": [],
"more_buying_choices": null,
"delivery": null,
"stock_left": null,
"points": null,
"installments": null
},
{
"position": 3,
"asin": "B0DCH8VDXF",
"title": "Apple EarPods Headphones with USB-C Plug, Wired Ear Buds with Built-in Remote to Control Music, Phone Calls, and Volume",
"url": "https://www.amazon.com/dp/B0DCH8VDXF",
"image": "https://m.media-amazon.com/images/I/513OSdW4elL._AC_UL320_.jpg",
"price": 19,
"original_price": null,
"currency": "USD",
"rating": 4.5,
"total_ratings": 19556,
"is_prime": null,
"is_sponsored": false,
"is_amazon_choice": false,
"is_best_seller": true,
"sales_volume": "10K+ bought in past month",
"subtitle": null,
"badges": [
"Best Seller"
],
"best_seller_category": "in Headphones, Earbuds & Accessories",
"amazon_choice_keyword": null,
"deal_badge": null,
"sustainability": false,
"is_small_business": false,
"seller_id": "ATVPDKIKX0DER",
"image_large": "https://m.media-amazon.com/images/I/513OSdW4elL._AC_UL960_FMwebp_QL65_.jpg",
"authors": [],
"publication_date": null,
"formats": [],
"series": null,
"unit_price": null,
"original_price_type": null,
"savings_percent": null,
"coupon": null,
"promotions": [],
"more_buying_choices": {
"price": 17.87,
"offers_count": 4,
"text": "$17.87 (4+ used & new offers)"
},
"delivery": {
"text": "Join Prime to get FREE delivery Wed, Oct 28",
"fastest_text": "Or Non-members get FREE delivery Sat, Oct 31 on $35 of items shipped by Amazon"
},
"stock_left": null,
"points": null,
"installments": null
}
],
"has_next_page": true,
"total_results": 74728,
"total_results_text": "1-24 of over 70,000 results",
"total_pages": 400,
"corrected_query": null,
"related_searches": [],
"refinements": [
{
"id": "primeRefinements",
"name": "Eligible for Free Shipping",
"options": [
{
"name": "Free Shipping by Amazon Get FREE Shipping on eligible orders shipped by Amazon",
"value": "n:172282,p_76:1249137011"
}
]
},
{
"id": "deliveryRefinements",
"name": "Delivery Day",
"options": [
{
"name": "Get It by Tomorrow",
"value": "n:172282,p_90:8308921011"
}
]
},
{
"id": "departments",
"name": "Department",
"options": [
{
"name": "Accessories & Supplies",
"value": "n:172282,n:281407"
},
{
"name": "Camera & Photo",
"value": "n:172282,n:502394"
},
{
"name": "Car & Vehicle Electronics",
"value": "n:172282,n:3248684011"
}
]
}
],
"sort_options": [
"Featured",
"Price: Low to High",
"Price: High to Low"
]
},
"meta": {
"country": "US",
"cached": false,
"fetched_at": "2026-10-26T14:05:11.000Z"
}
}What people use it for
Browse a whole niche when you do not know the keywords yet.
Find new products in a category with sort=newest.
Pull the cheapest or best-reviewed items of a category for a comparison page.
FAQ
- How is this different from best sellers?
- /best-sellers returns Amazon’s ranked top 100. /products-by-category returns the category’s product listing, which you can sort by relevance, price, reviews, newest or best selling, up to 20 pages.
Related endpoints
See all 17 endpoints and 23 marketplaces on the Amazon product API page.