Skip to main content
GET
Get Reviews

Path Parameters

asin
string
required
The ASIN of the product to fetch reviews for.

Query Parameters

domain
string
default:"com"
Amazon marketplace TLD or code where the product is listed.Examples: com, co.uk, de
page
integer
default:1
Page number for paginated reviews. Starts at 1 and is capped at 20.Amazon exposes roughly 10 reviews per page, so this endpoint returns at most ~200 reviews per product (20 pages). Requesting a page beyond 20 returns no additional reviews.
sort_by
string
default:"helpful"
Sort order for reviews.
star
string
Filter reviews by star rating or sentiment.
verified_only
boolean
default:false
Only return reviews from verified purchases.
media_only
boolean
default:false
Only return reviews that include images or video.

Response

asin
string
The ASIN the reviews belong to.
domain
string
Marketplace domain.
rating
number
Overall average product rating.
ratings_total
integer
Total number of ratings for the product.
rating_breakdown
object
Percentage of ratings per star bucket (five_starone_star).
reviews
array
Array of reviews.
pagination
object
Pagination metadata with current_page, total_pages, total_results.

Example Response

Each reviews request costs 10 credits. Amazon exposes a public featured subset of reviews; full review history is login-gated. The page parameter is capped at 20 (~200 reviews per product) — there is no way to page deeper. Failed requests are not charged.

Authorizations

x-api-key
string
header
required

Path Parameters

asin
string
required

The ASIN of the product to fetch reviews for.

Query Parameters

domain
string
default:com

Amazon marketplace TLD or code (com, co.uk, de, ...).

page
integer
default:1

Page number for paginated reviews.

Required range: x >= 1
sort_by
enum<string>
default:helpful

Sort order for reviews.

Available options:
helpful,
recent
star
enum<string>

Filter reviews by star rating or sentiment.

Available options:
one_star,
two_star,
three_star,
four_star,
five_star,
positive,
critical
verified_only
boolean
default:false

Only return reviews from verified purchases.

media_only
boolean
default:false

Only return reviews that include images or video.

Response

200 - application/json

Product reviews

asin
string
domain
string
rating
number

Overall average product rating.

ratings_total
integer

Total number of ratings for the product.

rating_breakdown
object
reviews
object[]
pagination
object