Prev		Next

Images Response Group

The Images response group returns the URLs to all available images of an item in three sizes: small, medium, and large. For example, if a blender is for sale and there are four images of it, this response group returns the URLs of twelve images: four images, each in three sizes.

In addition to returning the URLs of the images, the response groups also returns the height and width dimensions of each image. Use these values to help you display the images correctly.

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 Images 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, ECS will not return images.

Relevant Operations

Operations that can use this response group include:

Response Elements

The following table describes the elements returned by the Images response group. 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
`Height`	ImageSets/ImageSet/LargeImage/Heigh	Height of the large image
`Height`	ImageSets/ImageSet/MediumImage/Height	Height of the medium image
`Height`	ImageSets/ImageSet/SmallImage/Height	Height of the small image
`Height`	MediumImage/Height	Height of the medium image
`Height`	ImageSets/ImageSet/SwatchImage/Height	Height of the swatch image
`Height`	SmallImage/Height	Height of the small image
`Height`	LargeImage/Height	Height of the large image
`TotalPages`	Items/TotalPages	Total number of pages of images found. There areup to ten images per page in a response.
`TotalResults`	Items/TotalResults	Total nujmber of images found.
`URL`	LargeImage/URL	URL of the large image
`URL`	MediumImage/URL	URL of the medium image
`URL`	SmallImage/URL	URL of the small image
`URL`	ImageSets/ImageSet/SwatchImage/URL	URL of the swatch image
`URL`	ImageSets/ImageSet/SmallImage/URL	URL of the small image
`URL`	ImageSets/ImageSet/LargeImage/URL	URL of the large image
`URL`	ImageSets/ImageSet/MediumImage/URL	URL of the medium image
`Width`	ImageSets/ImageSet/MediumImage/Width	Width of the medium image
`Width`	ImageSets/ImageSet/LargeImage/Width	Width of the large image
`Width`	ImageSets/ImageSet/SmallImage/Width	Witch of the small image
`Width`	LargeImage/Width	Width of the large image
`Width`	MediumImage/Width	Width of the mediumm image
`Width`	SmallImage/Width	Width of the small image
`Width`	ImageSets/ImageSet/SwatchImage/Width	Width of the swatch image

Images 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 the Images response group.

None

Child Response Group

The following response groups are child response groups of the Images response group.

None

Sample REST Use Case

All locales.

http://ecs.amazonaws.com/onca/xml?Service=AWSECommerceService&
AWSAccessKeyId=[Access Key ID]&
Operation=ItemSearch&
Condition=All&
ResponseGroup=Images&
SearchIndex=Blended&
Keywords=GodSmack&Merchant=All

Sample Response Snippet

The following response snippet shows the elements returned by the Images response group.

<SearchIndex>
  <IndexName>DVD</IndexName> 
  <Results>7</Results> 
  <Pages>3</Pages> 
  <RelevanceRank>2</RelevanceRank> 
  <ASIN>B00005TNFV</ASIN> 
  <ASIN>B0002NRRBA</ASIN> 
  <ASIN>B000A2XB9U</ASIN> 
</SearchIndex>
<Item>
  <ASIN>B00005TNFV</ASIN> 
  <SmallImage>
    <URL>http://ec1.images-amazon.com/images/P/B00005TNFV.01._SCTHUMBZZZ_.jpg</URL> 
    <Height Units="pixels">60</Height> 
    <Width Units="pixels">43</Width> 
  </SmallImage>
  <MediumImage>
    <URL>http://ec1.images-amazon.com/images/P/B00005TNFV.01._SCMZZZZZZZ_.jpg</URL> 
    <Height Units="pixels">140</Height> 
    <Width Units="pixels">99</Width> 
  </MediumImage>
  <LargeImage>
    <URL>http://ec1.images-amazon.com/images/P/B00005TNFV.01._SCLZZZZZZZ_.jpg</URL> 
    <Height Units="pixels">475</Height> 
    <Width Units="pixels">336</Width> 
  </LargeImage>
  <ImageSets>
    <ImageSet Category="primary">
      <SmallImage>
        <URL>http://ec1.images-amazon.com/images/P/B00005TNFV.01._SCTHUMBZZZ_.jpg</URL> 
        <Height Units="pixels">60</Height> 
        <Width Units="pixels">43</Width> 
        </SmallImage>