Amazon API
Product Reviews
Get customer reviews for any Amazon product with star filters, verified-purchase filter, and pagination.
POST
$0.01/call/v1/amazon/product-reviewsUsage
const res = await fetch('https://api.yepapi.com/v1/amazon/product-reviews', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ asin: 'B07ZPKBL9V', sort_by: 'TOP_REVIEWS' }),
});
const { data } = await res.json();
console.log(data);curl -X POST https://api.yepapi.com/v1/amazon/product-reviews \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"asin": "B07ZPKBL9V", "sort_by": "TOP_REVIEWS"}'import requests
res = requests.post(
"https://api.yepapi.com/v1/amazon/product-reviews",
headers={"x-api-key": "YOUR_API_KEY"},
json={"asin": "B07ZPKBL9V", "sort_by": "TOP_REVIEWS"},
)
print(res.json()["data"])Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
asin | string | Yes | Amazon ASIN | — |
country | string | No | ISO alpha-2 country code | US |
sort_by | string | No | TOP_REVIEWS or MOST_RECENT | TOP_REVIEWS |
star_rating | string | No | ALL, 5_STARS, 4_STARS, 3_STARS, 2_STARS, 1_STARS, POSITIVE, CRITICAL | ALL |
verified_purchases_only | boolean | No | Only verified purchasers | false |
images_or_videos_only | boolean | No | Only reviews with media | false |
current_format_only | boolean | No | Only reviews for the current format/variation | false |
page | number | No | Page number (7 reviews/page) | 1 |
Response
{
"ok": true,
"data": {
"status": "OK",
"request_id": "272b8277-8deb-46c3-99ff-1948bcc081d8",
"parameters": {
"asin": "B07ZPKBL9V",
"sort_by": "TOP_REVIEWS",
"star_rating": "ALL",
"page": 1
},
"data": {
"asin": "B07ZPKBL9V",
"country": "US",
"domain": "www.amazon.com",
"total_ratings": 59992,
"rating_distribution": { "1": 11, "2": 3, "3": 5, "4": 12, "5": 69 },
"reviews": [
{
"review_id": "RY89LJI770S2T",
"review_title": "Great price",
"review_comment": "Perfect replacement for my 13 year old daughter. Works perfectly.",
"review_star_rating": "5",
"review_link": "https://www.amazon.com/gp/customer-reviews/RY89LJI770S2T",
"review_author": "JEKurtz",
"review_author_avatar": "https://m.media-amazon.com/images/S/amazon-avatars-global/default.png",
"review_images": [],
"review_video": null,
"review_date": "Reviewed in the United States on March 8, 2026",
"is_verified_purchase": true,
"helpful_vote_statement": "5 people found this helpful",
"reviewed_product_asin": "B07ZPKBL9V",
"reviewed_product_variant": {
"Size": "64GB",
"Color": "White",
"Service provider": "Unlocked",
"Product grade": "Renewed"
},
"is_vine": false
}
]
}
}
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.data.asin | string | Product ASIN |
data.data.total_ratings | number | Total ratings across all pages |
data.data.rating_distribution | object | Percent per star rating ("1" → "5") |
data.data.reviews[].review_id | string | Amazon review ID |
data.data.reviews[].review_title | string | Review title |
data.data.reviews[].review_comment | string | Review body text |
data.data.reviews[].review_star_rating | string | Star rating (1–5) |
data.data.reviews[].review_link | string | Deep link to review on Amazon |
data.data.reviews[].review_author | string | Author display name |
data.data.reviews[].review_images | string[] | Uploaded image URLs (may be empty) |
data.data.reviews[].review_date | string | Localized review date string |
data.data.reviews[].is_verified_purchase | boolean | Verified-purchase badge |
data.data.reviews[].helpful_vote_statement | string | "N people found this helpful" |
data.data.reviews[].reviewed_product_variant | object | Variant attributes (Size, Color, etc.) |
data.data.reviews[].is_vine | boolean | Amazon Vine program review |