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

RelatedItems

The RelatedItems response group returns items related to an item specified in an ItemLookup request. For example, related items could be all of the Unbox episodes in a TV season that are sold separately, or all of the MP3Download tracks on an MP3 album.

The data returned for RelatedItems is limited to ASINs and ItemAttributes. This remains true even if you add additional response groups, such as Large, that would otherwise return additional data.

The relationship between items is unidirectional. One item is the parent and one item is the child. Items, however, can have multiple children or multiple parents for a given relationship type.

The way in which the items are related is specified by the RelationshipType parameter. This parameter is required when you use the RelatedItems response group. Some values include Episode, Season, Tracks, and Variation. For a list of all relationship types, go to the ItemLookup page.

The relationship type is usually named after the child item in the relationship. For example, an MP3 Track is related to an MP3 album and the type of relationship is Tracks. In this relationship, the album is the parent. If you did an ItemLookup for an MP3 Track and requested RelatedItems using Tracks as the RelationshipType, you would receive the parent album (or albums) for that Track. Conversely, looking up an album using Tracks as the RelationshipType returns the list of Tracks on that album.

Each ItemLookup request can return, at most, 10 related items. To return additional items, use the RelateditemsPage parameter. For example, a value of 2 returns the second set of 10 related items.

Relevant Operations

Operations that can use this response group include:

Response Elements

The following elements are returned by RelatedItems:

RelatedItems also returns the elements that all response groups return. For more information, go to Elements Common to All Response Groups.

Parent Response Group

The following response groups are parent response groups of RelatedItems.

  • None

Child Response Group

The following response groups are child response groups of RelatedItems.

  • None

Sample REST Use Case

The following request iluses the RelatedItems response group.

Copy
http://webservices.amazon.com/onca/xml? Service=AWSECommerceService& AWSAccessKeyId=[AWS Access Key ID]& AssociateTag=[Associate ID]& Operation=ItemLookup& RelationshipType=Tracks& ItemId=B0013D8EQK& ItemType=ASIN& ResponseGroup=RelatedItems,Small& Version=2013-08-01 &Timestamp=[YYYY-MM-DDThh:mm:ssZ] &Signature=[Request Signature]

Sample Response Snippet

The following response snippet shows the elements returned by RelatedItems.

Copy
<Item> <ASIN>B0013D8EQK</ASIN> <ItemAttributes> <Creator Role="Primary Contributor">Johnny Cash</Creator> <Manufacturer>Columbia/Legacy</Manufacturer> <ProductGroup>Digital Music Album</ProductGroup> <Title>At San Quentin</Title> </ItemAttributes> <RelatedItems> <Relationship>Children</Relationship> <RelationshipType>Tracks</RelationshipType> <RelatedItemCount>31</RelatedItemCount> <RelatedItemPageCount>4</RelatedItemPageCount> <RelatedItemPage>1</RelatedItemPage> <RelatedItem> <Item> <ASIN>B0013D4KJK</ASIN> <ItemAttributes> <Creator Role="Primary Contributor">Johnny Cash</Creator> <Manufacturer>Columbia/Legacy</Manufacturer> <ProductGroup>Digital Music Track</ProductGroup> <Title>The Long Black Veil/Give My Love To Rose (Live)</Title> </ItemAttributes> </Item> </RelatedItem> <RelatedItem> <Item> <ASIN>B0013D7VG4</ASIN> <ItemAttributes> <Creator Role="Primary Contributor">Johnny Cash</Creator> <Manufacturer>Columbia/Legacy</Manufacturer> <ProductGroup>Digital Music Track</ProductGroup> <Title>Folsom Prison Blues (Live)</Title> </ItemAttributes> </Item> </RelatedItem> ... </RelatedItems> </Item>