Prev		Next

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 above 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>
  ...
  <ClothingSize>Large</ClothingSize>
  <Color>Black</Color>
   ...
  </ItemAttributes>
  ...
</Item>

Response Elements

The following table describes the elements returned by VariationSummary. 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 Element	Ancestry	Definition
`Amount`	VariationSummary/LowestSalePrice/Amount	The lowest sales price in terms of the lowest currency denomination, for example, pennies, of all variations.
`Amount`	VariationSummary/HighestPrice/Amount	The highest price in terms of the lowest currency denomination, for example, pennies, of all variations.
`Amount`	VariationSummary/LowestPrice/Amount	The lowest price in terms of the lowest currency denomination, for example, pennies, of all variations.
`Amount`	VariationSummary/HighestSalePrice/Amount	The highest sales price in terms of the lowest currency denomination, for example, pennies, of all variations.
`CurrencyCode`	VariationSummary/HighestPrice/CurrencyCode VariationSummary/LowestSalePrice/CurrencyCode VariationSummary/HighestSalePrice/CurrencyCode VariationSummary/LowestPrice/CurrencyCode	Abbreviation for the format to use when displaying the price in a particular locale.
`FormattedPrice`	VariationSummary/HighestSalePrice/FormattedPrice VariationSummary/LowestSalePrice/FormattedPrice VariationSummary/LowestPrice/FormattedPrice VariationSummary/HighestPrice/FormattedPrice	The price formatted according to CurrencyCode for a specific locale.
`SingleMerchantId`	VariationSummary/SingleMerchantId	ID of a merchant that applices across all of the variations of an item.

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 folllowing request was used to illustrate the XML response elements returned by VariationSummary.

http://ecs.amazonaws.com/onca/xml?Service=AWSECommerceService &
AWSAccessKeyId=[Access Key ID]&
Operation=ItemLookup&
ItemId=B00006XYAA&
MerchantId=All&
ResponseGroup=VariationSummary

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>