VariationSummary Response Group

The VariationSummary response group provides the lowest price, highest price, lowest sale price, and highest sale price for all child ASINs in a 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 (the child ASIN).

Relevant Operations

Operations that can use this response group include:

Variation Dimensions

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 preceding example, size and color are the dimensions. Parent ASINs therefore return two related elements:

VariationDimensions
VariationDimension

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>
   ...
  </ItemAttributes>
  <VariationAttributes>
    <VariationAttribute>
      <Name>Color</Name>
      <Value>Black<Value>
    </VariationAttribute>
    <VariationAttribute>
      <Name>ClothingSize</Name>
      <Value>Large</Value>
    </VariationAttribute>
  </VariationAttributes>
  ...
</Item>

Response Elements

The following table describes the elements returned by VariationSummary.

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

None

Child Response Group

The following response groups are child response groups of VariationSummary.

None

Sample REST Use Case

The following request was used to illustrate the XML response elements returned by VariationSummary.

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=<replaceable>
<replaceable>[AWS Access Key ID]</replaceable>
  </replaceable>&
Operation=ItemLookup&
ItemId=B00006XYAA&
MerchantId=All&
ResponseGroup=VariationSummary&
Version=2008-08-19
&Timestamp=[YYYY-MM-DDThh:mm:ssZ]
&Signature=[Request Signature]

Sample Response Snippet

The following response snippet shows the elements returned by VariationSummary.

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