Menu
Product Advertising API
Developer Guide (API Version 2013-08-01)

Return Variations

By default, ItemSearch only returns parent variations.

To return the associated variations and their images

  • Include in the request the Variations and VariationImages response groups.

For example, when you add Variations to the preceding request, the response includes, in addition to what is shown, variations and their offers, as shown in the following response snippet.

Copy
<Offer> ... <OfferListing> <OfferListingId>4L2h0ymPZs3lDap8fU9Kw8hmKiPs5qVknFiifrviXAkRDZivZpZsSfTe0YMLtbo6MVWHTCzyKjT9UZI%2BpvF8Ax%2BFeSG29QGqQ4eF6ZspRD5fdxj8zmRp%2Bw%3D%3D</OfferListingId> ... </Offer> <Offer> ... <OfferListing> <OfferListingId>PCOIjALkrkCts8UYi3pqf%2BqBaH5xbmJfikoaB5fNhlF7yRMeh19NJxBEBBNz9GDFMMYtH0EI06Y1Vbar7raOf6ieUnzzST94RN8wwiXpEn2jaWmZ%2F%2BYc7Q%3D%3D</OfferListingId>

Each of these offers is associated with an Item element and each of these items is a variation. The following snippet, which comes from the same response, shows how each variation is differentiated by size.

Copy
<Item> <ItemAttributes> <Brand>Eddie Bauer</Brand> ... </ItemAttributes> <VariationAttributes> <VariationAttribute> <Name>ClothingSize</Name> <Value>Small Regular<Value> </VariationAttribute> <VariationAttribute> <Name>ClothingSize</Name> <Value>Medium Regular</Value> </VariationAttribute> <VariationAttribute> <Name>ClothingSize</Name> <Value>Large Regular<Value> </VariationAttribute> <VariationAttribute> <Name>ClothingSize</Name> <Value>X-Large Regular<Value> </VariationAttribute> </VariationAttributes> ... </Item>

Return Variation Dimension Information Only

The Variations and VariationSummary response groups return a great deal of information about each item in the response.

To see the values of the variation dimensions

  • Use the VariationMatrix response group in an ItemSearch request.

Copy
<Item> <ASIN>B0008G23PQ</ASIN> <Variations> <VariationDimensions> <VariationDimension>ClothingSize</VariationDimension> <VariationDimension>Color</VariationDimension> </VariationDimensions> <Item> <ASIN>B0008EOA9U</ASIN> <VariationAttributes> <VariationAttribute> <Name>Color</Name> <Value>Grey<Value> </VariationAttribute> <VariationAttribute> <Name>ClothingSize</Name> <Value>29W x 30L</Value> </VariationAttribute> </VariationAttributes> </Item> <Item> <ASIN>B0008EO9J6</ASIN> <VariationAttributes> <VariationAttribute> <Name>Color</Name> <Value>Navy<Value> </VariationAttribute> <VariationAttribute> <Name>ClothingSize</Name> <Value>29W x 30L</Value> </VariationAttribute> </VariationAttributes> </Item>

This response snippet shows that the VariationMatrix response group returns the names of the dimensions along with their values for each returned item. For more information, see VariationMatrix Response Group.