The Reviews response group returns, for each item in the response, a:
List of customer reviews
Average review rating (1 to 5 stars, where 5 is the best)
Total number of reviews
Each customer review contains a:
Rating
Summary
Date of review
Text of the full review
Operations that can use this response group include:
The following table describes the elements returned by Reviews. The elements on the left side of a slash mark are the parents of the elements on the right side of the slash mark.
| Response Element | Ancestry | Definition |
|---|---|---|
ASIN
| CustomerReviews/Review/ASIN | A positive integer distributed by Amazon that uniquely specifies a customer reiview. |
AverageRating
| CustomerReviews/AverageRating | An average of all of the ratings entered by customers where 5 is the best. |
Content
| CustomerReviews/Review/Content | The content of the review. |
CustomerId
| CustomerReviews/Review/CustomerId | A positive number distribued by Amazon that unqiely identifies a customer who entered a review. |
Date
| CustomerReviews/Review/Date | The date the review was created. |
HelpfulVotes
| CustomerReviews/Review/HelpfulVotes | The number of customers who felt that the review was helpful. |
Rating
| CustomerReviews/Review/Rating | A customer's rating in their review where a rating of 5 is the best. |
Summary
| CustomerReviews/Review/Summary | A short summary of the content of the review. |
TotalPages
| Items/TotalPages | Total number of pages in the response. There are up to five reviews per page. |
TotalResults
| Items/TotalResults | The total number of reviews. |
TotalReviewPages
| CustomerReviews/TotalReviewPages | The number of pages of reviews found. Up to ten reviews are returned in a response |
TotalReviews
| CustomerReviews/TotalReviews | Total number of reviews of an item. |
TotalVotes
| CustomerReviews/Review/TotalVotes | The total number of review votes cast. |
Reviews also returns the elements that all response groups return, which is described in Elements Common to All Response Groups.
The folllowing request was used to illustrate the XML response elements returned by Reviews.
http://ecs.amazonaws.com/onca/xml?Service=AWSECommerceService& AWSAccessKeyId=[Access Key ID]& Operation=ItemLookup& ItemId=0976925524& ResponseGroup=Reviews
The following response snippet shows the elements returned by Reviews.
<Review> <ASIN>0976925524</ASIN> <Rating>5</Rating> <HelpfulVotes>2</HelpfulVotes> <CustomerId>A111111111111111</CustomerId> <TotalVotes>9</TotalVotes> <Date>2006-04-12</Date> <Summary>Fabulous reading. Order a copy.</Summary> <Content>Human drama happens in a small, private school for girls in New England where a beloved headmistress has been dismissed. Her successor is challenged with the task of saving the school. Steven Davenport’s book, Saving Miss Olivers, is filled with wisdom, lots of humor, plot twists and characters that leap off of the page. The passion of the characters pulls you in and within the first twenty pages you feel you know them and care about them. This book is more than just a page-turner, which it, nevertheless, is. The author gives each character a full range of emotions and throughout the course of the book we see each character grow. You will love each one for different reasons. This book belongs on everyone's shelf whether you know private schools or not. This is human drama and the author is fabulous at writing about it. I can't recommend the book highly enough.</Content> </Review>