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...

AlternateVersions Response Group

The AlternateVersions response group returns all of the available media formats for a book title. Sample formats include Paperback, Audio CD, Audio Cassette, and Hardcover. This response group works only with the Books and ForeignBooks product categories, that is, 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 book or foreign book.

The following list shows the complete set of formats that AlternateVersions can return.

  • 3.5" disk

  • Accessory

  • Audio CD

  • Audio Download

  • Audio Reel Tape

  • Bargain Book

  • Bath Book

  • Board book

  • Calendar

  • Card Book

  • Cards

  • Cassette audio

  • CD-ROM

  • Comic

  • Diary

  • Digital

  • Diskette

  • DVD Audio

  • DVD-ROM

  • Film

  • Foam Book

  • Game

  • Gift

  • Hardcover

  • Hardcover Comic

  • Journal

  • Laser Disc

  • Leather Bound

  • Library Binding

  • Loose Leaf

  • Map

  • Mass Market Paperback

  • Microfiche

  • Mini-Disc

  • Misc.

  • Misc. Supplies

  • MP3 CD

  • Paperback

  • Perfect

  • Personal Computers

  • Plastic Comb

  • Pop-Up

  • Poster

  • Rag Book

  • Ring-bound

  • Roughcut

  • School & Library Binding

  • Sheet music

  • Slide

  • Software

  • Spiral-bound

  • Stationery

  • Textbook Binding

  • Turtleback

  • Unbound

  • Unknown Binding

  • Wall Chart

  • Workbook

Relevant Operations

Operations that can use this response group include:

  • ItemSearch, when the search index is Books or, in non-US locales, ForeignBooks

  • ItemLookup when the specified item is a book or foreign book and, if a search index is specified, the value must be Books or, in non-US locales, ForeignBooks

Response Elements

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

AlternateVersions also returns the elements that all response groups return, which described in Elements Common to All Response Groups.

Parent Response Group

The following response groups are parent response groups of AlternateVersions.

  • None

Child Response Group

The following response groups are children response groups of AlternateVersions.

  • None

Sample REST Use Case

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

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]

Sample Response Snippet

The following response snippet shows the elements returned by AlternateVersions.

<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>
  <AlternateVersion>
    <ASIN>0439785960</ASIN>
    <Title>
    Harry Potter And The Half-Blood Prince (Harry Potter, Book 6) (Harry Potter)
    </Title>
    <Binding>Paperback</Binding>
  </AlternateVersion>
  <AlternateVersion>
    <ASIN>0439786770</ASIN>
    <Title>
    Harry Potter and the Half-Blood Prince (Book 6) [LIBRARY EDITION]
    </Title>
    <Binding>Library Binding</Binding>
  </AlternateVersion>