VariationImages Response Group

The VariationImages response group displays different image variations of the same item in four sizes: swatch, small, medium, and large, where the swatch image is smaller than the small image. VariationImages is used when there are variations of an item for sale. For example, a shirt for sale might come in four colors. If VariationImages is used as the response group, the shirt will be displayed in sixteen images: four image sizes of each of the four colors.

The images returned are associated with the merchant selling the item. For that reason, you must specify the merchant ID in the request when you use the VariationImages response group. MerchantId, however, defaults to "Amazon." So, if the item is being sold by Amazon, specifying a MerchantId is not required. If you do not specify a MerchantId and a merchant other than Amazon is selling the item, Amazon Associates Web Service will not return images.

Parent ASINs do not always have images associated with them; their children, however, should.

Relevant Operations

Operations that can use this response group include:

ItemLookup

Response Elements

The following table describes the elements returned by VariationImages. The elements on the left side of a slash mark are the parents of the elements on the right side of the slash mark.

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

None

Child Response Group

The following response groups are child response groups of VariationImages.

None

Sample REST Use Case

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

http://ecs.amazonaws.com/onca/xml?Service=AWSECommerceService &
AWSAccessKeyId=[AWS Access Key ID]&
Operation=ItemLookup&
ItemId=0239409223&
ResponseGroup=VariationImages

Sample Response Snippet

The following response snippet shows the elements returned by VariationImages.

<ImageSets>
  <ImageSet Category="primary">

  <SmallImage>
    <URL>
    http://images.amazon.com/images/P/B99999999A.01._SCTHUMBZZZ_.jpg
    </URL>
    <Height Units="pixels">60</Height>
    <Width Units="pixels">60</Width>
  </SmallImage>

  <MediumImage>
    <URL>
    http://images.amazon.com/images/P/B99999999A.01._SCMZZZZZZZ_.jpg
    </URL>
    <Height Units="pixels">140</Height>
    <Width Units="pixels">140</Width>
  </MediumImage>

  <LargeImage>
    <URL>
    http://images.amazon.com/images/P/B99999999A.01._SCLZZZZZZZ_.jpg
    </URL>
    <Height Units="pixels">500</Height>
    <Width Units="pixels">500</Width>
    </LargeImage>
    </ImageSet>
  <ImageSet Category="variant">

  <SmallImage>
    <URL>
    http://images.amazon.com/images/P/B99999999A.01.PT01._SCTHUMBZZZ_.jpg
    </URL>
    <Height Units="pixels">48</Height>
    <Width Units="pixels">60</Width>
  </SmallImage>

  <MediumImage>
    <URL>
    http://images.amazon.com/images/P/B99999999A.01.PT01._SCMZZZZZZZ_.jpg
    </URL>
    <Height Units="pixels">120</Height>
    <Width Units="pixels">150</Width>
  </MediumImage>

  <LargeImage>
    <URL>
    http://images.amazon.com/images/P/B99999999A.01.PT01._SCLZZZZZZZ_.jpg
    </URL>
    <Height Units="pixels">400</Height>
    <Width Units="pixels">500</Width>
  </LargeImage>

</ImageSet>