OfferListings

Product Advertising API: 2009-11-01

previous page next page

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.

Relevant Operations

Operations that can use this response group include:

  • ItemLookup

  • ItemSearch

  • ListLookup

  • 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 was used to illustrate the XML response elements returned by OfferListings.

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=<replaceable>
<replaceable>[AWS Access Key ID]</replaceable>
</replaceable>]&
            AssociateTag=</replaceable>
            <replaceable>[Associate ID]</replaceable>
            </replaceable>&
Operation=ItemSearch&
Keywords=sports&
ResponseGroup=OfferListings&
Version=2008-08-19

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>
         <Seller>
            <SellerId>A43VGTGXZ8ZI6</SellerId>
         <AverageFeedbackRating>4.9</AverageFeedbackRating>
            <TotalFeedback>300</TotalFeedback>
         </Seller>
         <OfferAttributes>
            <Condition>New</Condition>
            <SubCondition>new</SubCondition>
            <ConditionNote>
               Brand new, unopened and complete in the retail box.
            </ConditionNote>
         </OfferAttributes>
         <OfferListing>
            <OfferListingId>
              pBmLD7%2F4J7zqIMjOLpQI5pkO774zf%2BsvrzbG4JR92xLmC%
            </OfferListingId>
            <ExchangeId>Y01Y4632798Y1053687</ExchangeId>
            <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>
previous page start next page