Amazon search API
GET /search runs a keyword search on one Amazon marketplace and returns each result’s page position, ASIN, title, price, list price, rating, ratings count, sponsored, Amazon’s Choice and Best Seller flags, badges, coupon and delivery text, unit price and the “bought in past month” text. Each page also gives the total result count, related searches and the filters Amazon offers. Results come 1 page at a time, up to page 20, with sorting and price filters.
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 /search returns
Keyword search on one Amazon marketplace. Returns each result's position, ASIN, title, price, list price, rating, ratings count, sponsored, Amazon's Choice and Best Seller flags, and "bought in past month" text. Sponsored and organic placements of the same ASIN are both returned, with their page positions. `is_prime` is true when Amazon shows a Prime badge; null when unknown (logged-out pages rarely show Prime).
Parameters
| Name | Required | Values | Notes |
|---|---|---|---|
query | yes | string | Search keywords. |
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 | |
min_price | no | number | In the marketplace's currency. |
max_price | no | number | |
category | no | string | Amazon search category alias (e.g. electronics) or numeric browse node ID (e.g. 172541). |
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/search?query=usb+c+cable&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/search",
params={"query": "usb c cable", "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/search');
url.search = new URLSearchParams({ query: 'usb c cable', 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": {
"results": [
{
"position": 1,
"asin": "B088NRLMPV",
"title": "Anker USB C to USB C Cable, 60W Fast Charging Cable (2-Pack, 6 ft, Black)",
"url": "https://www.amazon.com/dp/B088NRLMPV",
"image": "https://m.media-amazon.com/images/I/71IE9dLBduL._AC_UY218_.jpg",
"price": 9.99,
"original_price": null,
"currency": "USD",
"rating": 4.7,
"total_ratings": 90221,
"is_prime": null,
"is_sponsored": false,
"is_amazon_choice": true,
"is_best_seller": false,
"sales_volume": "10K+ bought in past month",
"subtitle": "For iPhone 18 / 17 Series, iPad mini 6, and More",
"badges": [
"Overall Pick",
"Carbon impact",
"ClimatePartner Verified"
],
"best_seller_category": null,
"amazon_choice_keyword": null,
"deal_badge": null,
"sustainability": true,
"is_small_business": false,
"seller_id": "A294P4X9EWVXLJ",
"image_large": "https://m.media-amazon.com/images/I/71IE9dLBduL._AC_UY654_FMwebp_QL65_.jpg",
"authors": [],
"publication_date": null,
"formats": [],
"series": null,
"unit_price": {
"amount": 5,
"unit": "count",
"text": "$5.00 / count"
},
"original_price_type": null,
"savings_percent": null,
"coupon": null,
"promotions": [],
"more_buying_choices": null,
"delivery": {
"text": "Join Prime to get FREE delivery Tomorrow 4 AM - 8 AM on eligible orders",
"fastest_text": "Or Non-members get FREE delivery Tue, Oct 27 on $35 of items shipped by Amazon"
},
"stock_left": null,
"points": null,
"installments": null
},
{
"position": 2,
"asin": "B088NMR44C",
"title": "Anker USB C to USB C Cable, 60W Fast Charging Cable (2-Pack, 3.3 ft, Black)",
"url": "https://www.amazon.com/dp/B088NMR44C",
"image": "https://m.media-amazon.com/images/I/71btI2mQBmL._AC_UY218_.jpg",
"price": 9.99,
"original_price": null,
"currency": "USD",
"rating": 4.7,
"total_ratings": 90221,
"is_prime": null,
"is_sponsored": false,
"is_amazon_choice": false,
"is_best_seller": true,
"sales_volume": "10K+ bought in past month",
"subtitle": "For iPhone 18 / 17 Series, iPad mini 6, and More",
"badges": [
"Best Seller"
],
"best_seller_category": "in USB Cables",
"amazon_choice_keyword": null,
"deal_badge": null,
"sustainability": false,
"is_small_business": false,
"seller_id": "A294P4X9EWVXLJ",
"image_large": "https://m.media-amazon.com/images/I/71btI2mQBmL._AC_UY654_FMwebp_QL65_.jpg",
"authors": [],
"publication_date": null,
"formats": [],
"series": null,
"unit_price": {
"amount": 1.51,
"unit": "feet",
"text": "$1.51 / feet"
},
"original_price_type": null,
"savings_percent": null,
"coupon": null,
"promotions": [],
"more_buying_choices": {
"price": 8.99,
"offers_count": 2,
"text": "$8.99 (2 used & new offers)"
},
"delivery": {
"text": "Join Prime to get FREE delivery Tomorrow 4 AM - 8 AM on eligible orders",
"fastest_text": "Or Non-members get FREE delivery Tue, Oct 27 on $35 of items shipped by Amazon"
},
"stock_left": null,
"points": null,
"installments": null
},
{
"position": 3,
"asin": "B0HF8JJT4H",
"title": "USB C Cable Beaded 60W Fast Charging Phone Charger Cord Women Girl 6FT Pink",
"url": "https://www.amazon.com/dp/B0HF8JJT4H",
"image": "https://m.media-amazon.com/images/I/71ELUNiS45L._AC_UY218_.jpg",
"price": 14.99,
"original_price": null,
"currency": "USD",
"rating": 5,
"total_ratings": 4,
"is_prime": null,
"is_sponsored": false,
"is_amazon_choice": false,
"is_best_seller": false,
"sales_volume": null,
"subtitle": "Beaded 90 Degree Right Angle Cord Type C Wire Gaming Bedside Phone Charging Cable for Pixel 11 10 Pro for iPhone 17 16 18 Pro",
"badges": [],
"best_seller_category": null,
"amazon_choice_keyword": null,
"deal_badge": null,
"sustainability": false,
"is_small_business": false,
"seller_id": "A1SUQAO5Q57L64",
"image_large": "https://m.media-amazon.com/images/I/71ELUNiS45L._AC_UY654_FMwebp_QL65_.jpg",
"authors": [],
"publication_date": null,
"formats": [],
"series": null,
"unit_price": null,
"original_price_type": null,
"savings_percent": null,
"coupon": "10% off coupon applied",
"promotions": [],
"more_buying_choices": null,
"delivery": {
"text": "Join Prime to get FREE delivery Tomorrow, Oct 23",
"fastest_text": "Or Non-members get FREE delivery Tue, Oct 27 on $35 of items shipped by Amazon"
},
"stock_left": null,
"points": null,
"installments": null
}
],
"has_next_page": true,
"total_results": 76300,
"total_results_text": "1-16 of over 70,000 results for",
"total_pages": 20,
"corrected_query": null,
"related_searches": [
"usb c charger",
"usb c cable 10ft",
"usb c charger cable"
],
"refinements": [
{
"id": "topRefinements/0",
"name": "Popular Shopping Ideas",
"options": [
{
"name": "10 Feet",
"value": null
},
{
"name": "6ft",
"value": null
},
{
"name": "3ft",
"value": null
}
]
},
{
"id": "primeRefinements",
"name": "Eligible for Free Shipping",
"options": [
{
"name": "Free Shipping by Amazon Get FREE Shipping on eligible orders shipped by Amazon",
"value": "p_76:1249137011"
}
]
},
{
"id": "deliveryRefinements",
"name": "Delivery Day",
"options": [
{
"name": "Get It by Tomorrow",
"value": "p_90:8308921011"
}
]
}
],
"sort_options": [
"Featured",
"Price: Low to High",
"Price: High to Low"
],
"query": "usb c cable",
"page": 1
},
"meta": {
"country": "US",
"cached": false,
"fetched_at": "2026-10-22T14:05:11.000Z"
}
}What people use it for
Track where your product ranks for a keyword, organic and sponsored, day by day.
Find the cheapest or best-rated listing for a query with sort=price_asc or sort=reviews.
Seed a product database for a niche, then call /product-details on the ASINs you keep.
FAQ
- Does the Amazon search API return sponsored results?
- Yes. Sponsored and organic placements are both returned, each with its page position, and is_sponsored tells them apart. The same ASIN can appear twice, once sponsored and once organic.
- How do I sort Amazon search results by price?
- Pass sort=price_asc or sort=price_desc. The other values are relevance, reviews, newest and bestsellers. min_price and max_price filter in the marketplace’s currency.
- Can I search inside one category?
- Yes. Pass category as a search alias such as electronics or as a numeric browse node ID such as 172541.
Related endpoints
See all 17 endpoints and 23 marketplaces on the Amazon product API page.