Skip to main content
GET
Get Reviews

Path Parameters

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

Query Parameters

string
default:"com"
Amazon marketplace TLD or code where the product is listed.Examples: com, co.uk, de
integer
default:1
Page number for paginated reviews. Starts at 1.
string
default:"helpful"
Sort order for reviews.
string
Filter reviews by star rating or sentiment.
boolean
default:false
Only return reviews from verified purchases.
boolean
default:false
Only return reviews that include images or video.

Response

string
The ASIN the reviews belong to.
string
Marketplace domain.
number
Overall average product rating.
integer
Total number of ratings for the product.
object
Percentage of ratings per star bucket (five_starone_star).
array
Array of reviews.
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. 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