Product Advertising API
Developer Guide (API Version 2011-08-01)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

CartSimilarities Response Group

The CartSimilarities response group returns the title and ASINs of items that:

  • Are similar to the item specified in the request. These results, tagged in the XML response with <SimilarProducts> and <SimilarProduct>, are displayed on the retail web site under the heading, "Customers who bought this [item] also bought."

  • Have been viewed by customers who also viewed the the item specified in the request. These results, tagged in the XML response with <SimilarViewedProducts> and <SimilarViewedProduct>, are displayed on the retail web site under the heading, "Customers who viewed this [item] also viewed"

  • Can be found in other categories that are similar to the item specified in the request. These results, tagged in the XML response with <OtherCategoriesSimilarProducts> and <OtherCategoriesSimilarProduct>, are displayed on the retail web site under the heading, "Explore Similar Items," which falls under the heading, "Customers who bought this [item] also bought."

This response group returns a number of items similar to the one the customer added to the shopping cart. The response group is used typically to spur the customer's interest in purchasing additional items.

Relevant Operations

Operations that can use this response group include:

Response Elements

The following table describes the elements returned by CartSimilarities.

CartSimilarities 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 CartSimilarities.

  • None

Child Response Group

The following response groups are child response groups of CartSimilarities.

  • None

Sample REST Use Case

All locales.

http://webservices.amazon.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS Access Key ID]&
AssociateTag=ws&
Operation=CartCreate&
Item.1.ASIN=B000062TU1&
Item.1.Quantity=2&
ResponseGroup=CartSimilarities&
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 CartSimilarities.

<SimilarProducts>
  <SimilarProduct>
    <ASIN>B00008DDXC</ASIN>
    <Title>Harry Potter and the Chamber of Secrets (Widescreen Edition) (Harry Potter 2)</Title>
  </SimilarProduct>
</SimilarProducts>
<SimilarViewedProducts>
  <SimilarViewedProduct>
    <ASIN>B000E6UZZK</ASIN>
    <Title>Harry Potter Years 1-4 (Harry Potter and the Sorcerer's Stone / Chamber of Secrets / Prisoner of Azkaban / Goblet of Fire) (Widescreen Edition)</Title>
  </SimilarViewedProduct>
</SimilarViewedProducts>
<OtherCategoriesSimilarProducts>
  <OtherCategoriesSimilarProduct>
    <ASIN>0590353403</ASIN>
    <Title>Harry Potter and the Sorcerer's Stone (Book 1)</Title>
  </OtherCategoriesSimilarProduct>
</OtherCategoriesSimilarProducts>