Collections Response Group

A collection is a group of items that are related thematically. For example, all of the linens that go into a bedroom might be associated in a bedding collection. The Collections response group returns all of the items in a collection. If, for example, ItemSearch returns four items and each of them are in a collection, the Collections response group returns the ASINs and titles of all the items in all four collections.

Collections have one parent item (CollectionParent) and one or more child items (CollectionItem). The parent item has an ASIN and title but cannot be purchased. The title of the parent item names the collection, for example, Bedding Collection.

For more information, see Displaying Collections.

Relevant Operations

Operations that can use this response group include:

ItemLookup
ItemSearch

Response Elements

The following table describes and shows the ancestry of the elements returned by Collections. 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
ASIN	Collections/Collection/CollectionParent Collections/Collection/CollectionItem	The ASIN of the parent or child item, respectively. An ASIN is an alphanumeric token that uniquely identifies an item.
Collection	Collections	A container for one CollectionParent and one or more CollectionItems.
CollectionItem	Collections/Collection/	An item in a collection, which is specified by its ASIN and Title. In a collection, there is one parent item (CollectionParent) and one or more child items (CollectionItems).
CollectionParent	Collections/Collection/	An item that characterizes all of the items in a collection. In a collection, there is one parent item (CollectionParent) and one or more child items (CollectionItems).
Collections		Container for one or more Collection elements.
Title	Collections/Collection/CollectionParent Collections/Collection/CollectionItem	The title of the parent or child item, respectively.

Parent Response Group

The following response groups are parent response groups of Collections.

None

Child Response Group

The following response groups arechildren response groups of Collections.

None

Sample REST Use Case

The folllowing request was used to illustrate the XML response elements returned by Collections.

http://webservices.amazon.com/onca/xml?Service=AWSECommerceService&
AWSAccessKey=[AWS Access Key]&
Operation=ItemLookup&
ItemId=B000673NE2&
ResponseGroup=ItemIds,Collections&
Version=2007-01-17

Sample Response Snippet

The following response snippet shows the elements returned by Collections.

<Collections>
  <Collection>
    <CollectionParent>
      <ASIN>B0006PLAOE</ASIN> 
      <Title>Fieldcrest® Classic Bedding Collection GarnetIvory</Title> 
    </CollectionParent>
    <CollectionItem>
      <ASIN>B00067IV8U</ASIN> 
      <Title>Fieldcrest® Classic Solid Sheets Garnet</Title> 
    </CollectionItem>
    <CollectionItem>
      <ASIN>B000673NE2</ASIN> 
      <Title>Fieldcrest® Classic Solid Pillowcases Set of 2 Garnet</Title> 
    </CollectionItem>
    <CollectionItem>
      <ASIN>B00065WTJY</ASIN> 
      <Title>Fieldcrest® Classic Dobby Pillowcases Set of 2 Garnet</Title> 
    </CollectionItem>
  </Collection>
</Collections>