Amazon API
Search
Search Amazon for products by keyword with filters for price, rating, Prime, and deals.
POST
$0.01/call/v1/amazon/searchUsage
const res = await fetch('https://api.yepapi.com/v1/amazon/search', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ query: 'Phone', country: 'US' }),
});
const { data } = await res.json();
console.log(data);curl -X POST https://api.yepapi.com/v1/amazon/search \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "Phone", "country": "US"}'import requests
res = requests.post(
"https://api.yepapi.com/v1/amazon/search",
headers={"x-api-key": "YOUR_API_KEY"},
json={"query": "Phone", "country": "US"},
)
print(res.json()["data"])Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
query | string | Yes | Search keywords | — |
page | number | No | Page number (1-based) | 1 |
country | string | No | ISO alpha-2 country code (US, GB, DE, CA, AU, IN, JP, FR, IT, ES, etc.) | 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 |
is_prime | boolean | No | Only return Prime-eligible products | — |
deals_and_discounts | string | No | Filter for discount tiers (e.g. ALL_DISCOUNTS) | — |
Response
{
"ok": true,
"data": {
"status": "OK",
"request_id": "15a2016d-c6a2-4b15-ab0b-7764d1cd25c1",
"parameters": {
"query": "Phone",
"country": "US",
"sort_by": "RELEVANCE",
"page": 1
},
"data": {
"total_products": 135961,
"country": "US",
"domain": "www.amazon.com",
"products": [
{
"asin": "B0DM1S54MZ",
"product_title": "Samsung Galaxy A16 4G LTE (128GB + 4GB) International Model, Unlocked, 6.7\", 50MP Triple Camera, Black",
"product_price": "$133.47",
"product_original_price": null,
"currency": "USD",
"product_star_rating": "4.4",
"product_num_ratings": 4084,
"product_url": "https://www.amazon.com/dp/B0DM1S54MZ",
"product_photo": "https://m.media-amazon.com/images/I/61Lp1UcxeLL._AC_UY654_QL65_.jpg",
"product_num_offers": 12,
"product_minimum_offer_price": "$126.80",
"is_best_seller": false,
"is_amazon_choice": true,
"is_prime": false,
"sales_volume": "4K+ bought in past month",
"has_variations": true
}
]
}
}
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.data.total_products | number | Total products matching query across all pages |
data.data.country | string | Country for the listings |
data.data.domain | string | Amazon domain (e.g. www.amazon.com) |
data.data.products[].asin | string | Amazon Standard Identification Number |
data.data.products[].product_title | string | Product title |
data.data.products[].product_price | string | Current price (formatted) |
data.data.products[].product_original_price | string | null | Original MSRP if discounted |
data.data.products[].currency | string | ISO currency code |
data.data.products[].product_star_rating | string | Average rating (0–5) |
data.data.products[].product_num_ratings | number | Number of ratings |
data.data.products[].product_url | string | Amazon product URL |
data.data.products[].product_photo | string | Primary image URL |
data.data.products[].product_num_offers | number | Count of third-party offers |
data.data.products[].is_best_seller | boolean | Carries Best Seller badge |
data.data.products[].is_amazon_choice | boolean | Carries Amazon's Choice badge |
data.data.products[].is_prime | boolean | Prime-eligible |
data.data.products[].sales_volume | string | null | e.g. "4K+ bought in past month" |
data.data.products[].has_variations | boolean | Has color/size variations |