Product Advertising API
Developer Guide (API Version 2011-08-01)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

Reviews Response Group

The reviews response group returns the URL to an iframe that contains customer reviews. You can embed the iframe on any web page to display the response content.

[Important]Important

Each iframe URL is valid for 24 hours. If the iframe URL expires, you will receive a 403 Forbidden error code.

[Note]Note

As of November 8, 2010, only the iframe URL is returned in the request content.

For more information about reviews, see Getting Customer Reviews.

Each customer review contains the following:

  • Rating

  • Summary

  • Date of review

  • Text of the review

Relevant Operations

Operations that can use this response group include:

Response Elements

The following elements are returned by Reviews:

Reviews also returns the elements that all response groups return, as described in Elements Common to All Response Groups.

Parent Response Group

The following response groups are parent response groups of Reviews.

  • None

Child Response Group

The following response groups are child response groups of Reviews.

  • None

Sample REST Use Case

The following request illustrates the XML response elements returned by Reviews.

http://webservices.amazon.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS Access Key ID]&
Operation=ItemLookup&
ItemId=0316067938&
ResponseGroup=Reviews&
TruncateReviewsAt="256"&
IncludeReviewsSummary="False"&
Version=2011-08-01
&Timestamp=[YYYY-MM-DDThh:mm:ssZ]
&Signature=[Request Signature]

Sample Response Snippet

The following response snippet shows the elements returned by Reviews.

<ItemLookupResponse>
	<OperationRequest>
		<RequestId>[Request ID]</RequestId>
		<Arguments>
			<Argument Name="Operation" Value="ItemLookup"/>
			<Argument Name="Service" Value="AWSECommerceService"/>
			<Argument Name="ItemId" Value="0316067938"/>
			<Argument Name="TruncateReviewsAt" Value="256"/>
			<Argument Name="AWSAccessKeyId" Value="[AWS Access Key ID]"/>
			<Argument Name="IncludeReviewsSummary" Value="False"/>
			<Argument Name="ResponseGroup" Value="Reviews"/>
			<Argument Name="Version" Value="2010-09-01"/>
		</Arguments>
		<RequestProcessingTime>0.0416880000000000</RequestProcessingTime>
	</OperationRequest>
	<Items>
		<Item>
			<ASIN>0316067938</ASIN>
			<CustomerReviews>
				<IFrameURL>http://www.amazon.com/reviews/iframe?akid=[AWS Access Key ID]&asin=0316067938&exp=2010-09-02T17%3A54%3A07Z&linkCode=xm2&summary=0&tag=ws&truncate=256&v=2&sig=[Signature]</IFrameURL>
			</CustomerReviews>
		</Item>
	</Items>
</ItemLookupResponse>