Product Advertising API
Developer Guide (API Version 2011-08-01)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

Collections Response Group

For every item returned in a response, the items associated with it are also returned if the Collections response group is used in the request. Items in collections 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 the ASINs and titles of the items in a collection.

For more information, see Displaying Collections.

If an item is part of a collection and that item is returned in a response, all of the other items in the collection are also returned if the request contains the Collections response group.

Relevant Operations

Operations that can use this response group include:

  • ItemLookup

  • ItemSearch

Response Elements

The following table describes and shows the parentage of the elements returned by Collections.

Parent Response Group

The following response groups are parent response groups of Collections.

  • None

Child Response Group

The following response groups are children response groups of Collections.

  • None

Sample REST Use Case

The following request illustrates the XML response elements returned by Collections.

http://webservices.amazon.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKey=[Access Key ID]&
Operation=ItemLookup&
ItemId=B000ALMQ9C&
ResponseGroup=ItemIds,Collections&
Version=2011-08-01
&Timestamp=[YYYY-MM-DDThh:mm:ssZ]
&Signature=[Request Signature]

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>