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

Return Variations

By default, ItemSearch returns parent variations only. To return the associated variations and their images, specify the Variations and VariationImages response groups in the request.

For example, when you add the Variations response group to an ItemLookup request, the response includes variations and their offers:

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

Each offer is associated with an Item element and each item is a variation. The following example response shows how variations differ 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 information about each item in the response. Use the VariationMatrix response group with an ItemSearch request to see the values of the variation dimensions.

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>

The example response shows that the VariationMatrix response group returns the names of the dimensions along with their values for each returned item.

For more information, see the following topics: