Menu
Product Advertising API
Developer Guide (API Version 2013-08-01)

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 if the item qualifies for super saver shipping.

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:

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 uses the OfferListings response group.

Copy
http://webservices.amazon.com/onca/xml? Service=AWSECommerceService& AWSAccessKeyId=[AWS Access Key ID]& AssociateTag=[Associate ID]& Operation=ItemSearch& Keywords=sports& ResponseGroup=OfferListings& Version=2013-08-01 &Timestamp=[YYYY-MM-DDThh:mm:ssZ] &Signature=[Request Signature]

Sample Response Snippet

The following response snippet shows the elements returned by OfferListings.

Copy
<Item> <ASIN>B000AYGDIO</ASIN> <Offers> <TotalOffers>3</TotalOffers> <TotalOfferPages>1</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> <IsEligibleForPrime>0</IsEligibleForPrime> </OfferListing> </Offer> </Offers> </Item>