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 the reviews returned by the API. Each API page contains up to 10 reviews.In full mode, the service first collects all accessible reviews up to max_pages and limit, then slices them into API pages. An API page beyond the collected set returns an empty list.
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.
string
default:"public"
Review collection mode.Full mode is available for com, de, fr, co.uk, it, and es.
integer
default:10
Full mode only: maximum Amazon review pages to fetch per star sweep. Maximum 50.
boolean
default:false
Full mode only: also sweep each star filter and merge and deduplicate the results.
integer
Full mode only: stop after collecting this many distinct reviews. Optional; maximum 1000.
string
Full mode on com only: optional URL or slug of a current Woot offer. Without it, the service attempts to resolve a matching offer automatically from Woot’s public catalog.

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_star … one_star).
array
Array of reviews.
object
Pagination metadata with current_page, total_pages, total_results.

Example Response

public mode returns only Amazon’s featured subset. Use mode=full to collect the complete written-review set exposed by Amazon’s cursor pagination. ratings_total includes ratings without written text and can be higher than pagination.total_results. Full-mode credit usage depends on the number of upstream pages fetched and appears in the X-Credits-Used response header.

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.

mode
enum<string>
default:public

public returns the anonymous featured block; full uses an authenticated account to paginate all accessible written reviews.

Available options:
public,
full
max_pages
integer
default:10

Full mode only: maximum Amazon review pages to fetch per star sweep.

Required range: 1 <= x <= 50
per_star
boolean
default:false

Full mode only: sweep every star filter and merge and deduplicate the results.

limit
integer

Full mode only: stop after collecting this many distinct reviews.

Required range: 1 <= x <= 1000
woot_offer
string

Full mode on com only: optional current Woot offer URL or slug. Otherwise the service attempts automatic offer resolution.

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