Amazon API
Seller Reviews
Get reviews for a third-party Amazon seller with star-rating and verified-purchase filters.
POST
$0.01/call/v1/amazon/seller-reviewsUsage
const res = await fetch('https://api.yepapi.com/v1/amazon/seller-reviews', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ seller_id: 'A02211013Q5HP3OMSZC7W', page: 1 }),
});
const { data } = await res.json();
console.log(data);curl -X POST https://api.yepapi.com/v1/amazon/seller-reviews \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"seller_id": "A02211013Q5HP3OMSZC7W", "page": 1}'import requests
res = requests.post(
"https://api.yepapi.com/v1/amazon/seller-reviews",
headers={"x-api-key": "YOUR_API_KEY"},
json={"seller_id": "A02211013Q5HP3OMSZC7W", "page": 1},
)
print(res.json()["data"])Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
seller_id | string | Yes | Amazon seller ID | — |
country | string | No | ISO alpha-2 country code | US |
page | number | No | Page number (5 reviews/page) | 1 |
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 |
Response
{
"ok": true,
"data": {
"status": "OK",
"request_id": "6c2f60f0-2322-4d79-9b82-a4a87e64b44d",
"parameters": { "seller_id": "A02211013Q5HP3OMSZC7W", "country": "US", "page": 1, "star_rating": "ALL" },
"data": {
"seller_id": "A02211013Q5HP3OMSZC7W",
"country": "US",
"domain": "www.amazon.com",
"has_next_page": true,
"seller_reviews": [
{
"review_author": "Vadim p",
"review_comment": "I love this product and its smell. But this particular refill is a huge disappointment. The original had strong, lasting smell for weeks. These refills are DOA — all I get is aftersmell.",
"review_star_rating": 1,
"has_response": false,
"review_date": "April 24, 2026"
},
{
"review_author": "Skye c.",
"review_comment": "Came on time and not damaged",
"review_star_rating": 5,
"has_response": false,
"review_date": "April 24, 2026"
}
]
}
}
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.data.seller_id | string | Seller ID |
data.data.country | string | Country scope |
data.data.has_next_page | boolean | Whether another page of reviews is available |
data.data.seller_reviews[].review_author | string | Reviewer display name |
data.data.seller_reviews[].review_comment | string | Review body text |
data.data.seller_reviews[].review_star_rating | number | Star rating (1–5) |
data.data.seller_reviews[].has_response | boolean | Seller has posted a public response |
data.data.seller_reviews[].review_date | string | Human-readable review date |