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

OfferListings

The OfferListings response group returns the OfferListings for items returned in the response. The values returned are similar to those returned by the Offers response group minus the values returned by the OfferSummary response group. OfferListings returns shipping options, including IsEligibleForSuperSavingShipping which specifies whether the item qualifies for super saver shipping.

[Note]Note

This response group is not returned for Amazon Kindle digital books. An Amazon Kindle ASIN can be verified through the Binding, Format, and ProductTypeName response elements.

Relevant Operations

Operations that can use this response group include:

  • ItemLookup

  • ItemSearch

  • SimilarityLookup

Response Elements

The following table describes and shows the parentage of the elements returned by OfferListings. In the Ancestry column, the elements on the left side of a slash mark are the parents of the elements on the right side of the slash mark.

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

  • None

Child Response Group

The following response groups are children response groups of OfferListings.

  • None

Sample REST Use Case

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

http://webservices.amazon.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS Access Key ID]&
AssociateTag=[Associate ID]&
Operation=ItemSearch&
Keywords=sports&
ResponseGroup=OfferListings&
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 OfferListings.

<Item>
   <ASIN>B000AYGDIO</ASIN>
   <Offers>
      <TotalOffers>18</TotalOffers>
      <TotalOfferPages>2</TotalOfferPages>
      <Offer>
         <OfferAttributes>
            <Condition>New</Condition>
         </OfferAttributes>
         <OfferListing>
            <OfferListingId>
              pBmLD7%2F4J7zqIMjOLpQI5pkO774zf%2BsvrzbG4JR92xLmC%
            </OfferListingId>
            <Price>
               <Amount>24700</Amount>
               <CurrencyCode>USD</CurrencyCode>
               <FormattedPrice>$247.00</FormattedPrice>
            </Price>
            <Availability>Usually ships in 1-2 business days</Availability>
            <IsEligibleForSuperSaverShipping>0</IsEligibleForSuperSaverShipping>
          
         </OfferListing>
      </Offer>
      <!-- 9 ADDITIONAL OFFERS -->
   </Offers>
</Item>