Product Advertising API
Developer Guide (API Version 2011-08-01)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

Similar Versions of the Same Item

Some items come in a variety of media formats. For example, a book might come in hardback, paperback, audio cassette, audio CD, and DVD. A person buying an item in one format might be interested in the same item presented in a different format. To return all of the media formats of a single item, Product Advertising API provides the AlternateVersions response group. The catch is, the response group works only with items in the KindleStore, Music, MP3Downloads, Books, or ForeignBooks product categories. That means, for ItemSearch and ItemLookup, the search index must be Books or, in non-US locales, ForeignBooks, and, for ItemLookup, the specified item must be a music title, or a book or foreign book.

http://webservices.amazon.com/onca/xml?
Service=AWSECommerceService&
Operation=ItemSearch&
AWSAccessKeyId=[AWS Access Key ID]&
AssociateTag=ws&
SearchIndex=Books&
Keywords=potter&
ResponseGroup=AlternateVersions&
Version=2011-08-01
&Timestamp=[YYYY-MM-DDThh:mm:ssZ]
&Signature=[Request Signature]

This request returns books and media in other formats that contain "potter" in their title or product description, as shown in the following snippet of the response.

<AlternateVersions>
  <AlternateVersion>
    <ASIN>030728364X</ASIN>
    <Title>Harry Potter and the Half-Blood Prince (Book 6)
    </Title>
    <Binding>Audio Cassette</Binding>
  </AlternateVersion>
  <AlternateVersion>
    <ASIN>0307283658</ASIN>
    <Title>Harry Potter and the Half-Blood Prince (Book 6)
    </Title>
    <Binding>Audio CD</Binding>
  </AlternateVersion>
</AlternateVersions>

This response shows that the book, Harry Potter and the Half-Blood Prince, is available on audio cassette and CD.