Prev Next

CustomerReviews Response Group

For each customer in the response, the CustomerReviews response group returns:

Reviews include:

All of this information is returned only if the customer has choosen to make it public. Privacy choices are implemented by the customer in the Your Account web page that is accessible from Amazon’s retail web site.

Relevant Operations

Operations that can use this response group include:

Response Elements

The following table describes the elements returned by CustomerReviews. 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 ElementAncestryDefinition
ASIN CustomerReviews/Review/ASINA positive integer distributed by Amazon that uniquely identifies an item, which, in this case, is the tiem being reviewed.
CustomerReviews Customer/CustomerReviewsA parent element that encapsulates elements related to the customer reivews.
Content CustomerReviews/Review/ContentThe content of the customer review.
Date CustomerReviews/Review/DateThe date the customer review was created.
HelpfulVotes CustomerReviews/Review/HelpfulVotesThe number of times readers felt the review was helpful to them.
Rating CustomerReviews/Review/RatingThe customer's review of the item being reviewed. The highest rating is 5.
Summary CustomerReviews/Review/SummarA one line summary of the customer review.
TotalVotes CustomerReviews/Review/TotalVotesThe total number of people that voted whether the review was helpful.
TotalReviewPages CustomerReviews/TotalReviewPagesThe total number of review pages found. There are up to ten reviews per page.
TotalReviews CustomerReviews/TotalReviews The total number of reviews found.

CustomerReviews also returns the elements that all response groups return, which is described in Elements Common to All Response Groups.

Parent Response Group

The following response groups are parent response groups of CustomerReviews.

Child Response Group

The following response groups are child response groups of CustomerReviews.

Sample REST Use Case

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[Access Key ID]&
Operation=CustomerContentLookup&
CustomerId=[ID]&
ResponseGroup=CustomerReviews

The following response snippet shows the elements returned by CustomerReviews. 

<Customer>
  <CustomerId>A2KEKKJ9CAC2KC</CustomerId> 
  <CustomerReviews>
  <TotalReviews>8</TotalReviews> 
  <TotalReviewPages>1</TotalReviewPages> 
  <Review>
    <ASIN>6305692688</ASIN> 
    <Rating>1</Rating> 
    <HelpfulVotes>21</HelpfulVotes> 
    <TotalVotes>35</TotalVotes> 
    <Date>2000-02-29</Date> 
    <Summary>one star is indeed one too many</Summary> 
    <Content>Let's face facts. This is a terrible, terrible movie. We have to guess that all involved in this project are hiding. Really, I'm generally quite easy on movies, but this endless stream of uninteresting battle scenes with pointless dialogue and no discernable plot is perhaps one of the worst movies ever made. Sorry if this seems harsh, but I just don't want anyone to buy it unknowingly.
      </Content> 
    </Review>
Prev Copyright Information Next