VariationSummary Response Group

Description

The VariationSummary response group provides the lowest price, highest price, lowest sale price, and highest sale price for all child ASINs in the response.

Parent ASINs do not have offers; their children do. For example, you cannot buy a shirt (the parent ASIN). You can, however, buy a shirt that is a certain color and size and is made by a specific manufacturer (the child ASIN).

A variation is a child ASIN. The parent ASIN is an abstraction of the children items. For example, Shirt is a parent ASIN. Parent ASINs cannot be sold. A child ASIN of it would be a blue shirt, size 16, sold by MyApparelStore. This child ASIN is one of potentially many variations. The ways in which variations differ are called dimensions. In the above example, size and color are the dimensions. Parent ASINs therefore return two related elements:

For example, 


<VariationDimensions>
    <VariationDimension>ClothingSize</VariationDimension>
    <VariationDimension>Color</VariationDimension>
</VariationDimensions>

The values returned by these elements are the dimensions listed in the child ASIN’s response, for example, 

<Item>
   ...
   <ItemAttributes>
      ...
      <ClothingSize>Large</ClothingSize>
      <Color>Black</Color>
      ...
   </ItemAttributes>
   ...
</Item>

REST Sample Response and Request

Sample Response (REST)

<?xml version="1.0" encoding="UTF-8"?>
<ItemLookupResponse xmlns="http://webservices.amazon.com/AWSECommerceService/2006-10-31">
  <OperationRequest>
    <HTTPHeaders>
      <Header Name="UserAgent" Value="Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)"/>
    </HTTPHeaders>
    <RequestId>0R6G71MRKKAJCKAMWSES</RequestId>
    <Arguments>
      <Argument Name="MerchantId" Value="All"/>
      <Argument Name="Service" Value="AWSECommerceService"/>
      <Argument Name="AssociateTag" Value="[Your Associate ID Here]"/>
      <Argument Name="AWSAccessKeyId" Value="[Your Access Key ID Here]"/>
      <Argument Name="ItemId" Value="B00006XYAA"/>
      <Argument Name="ResponseGroup" Value="VariationSummary"/>
      <Argument Name="Operation" Value="ItemLookup"/>
    </Arguments>
  </OperationRequest>
  <Items>
    <Request>
      <IsValid>True</IsValid>
    </Request>
    <Item>
      <ASIN>B00006XYAA</ASIN>
      <VariationSummary>
        <LowestPrice>
          <Amount>1450</Amount>
          <CurrencyCode>USD</CurrencyCode>
          <FormattedPrice>$14.50</FormattedPrice>
        </LowestPrice>
        <HighestPrice>
          <Amount>1750</Amount>
          <CurrencyCode>USD</CurrencyCode>
          <FormattedPrice>$17.50</FormattedPrice>
        </HighestPrice>
        <SingleMerchantId>A3BHV8OQ3W90PJ</SingleMerchantId>
      </VariationSummary>
    </Item>
  </Items>
</ItemLookupResponse>

The Request that Generated the Response (REST)

http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &AWSAccessKeyId=[Your Access Key ID Here]
    &AssociateTag=[Your Associate ID Here]
    &Operation=ItemLookup
    &ItemId=B00006XYAA
    &MerchantId=All
    &ResponseGroup=VariationSummary