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

Checking for an Offer Listing ID

An offer listing ID is an alphanumeric token that uniquely identifies an item that is sold by any merchant, including Amazon. Whereas an offer is a combination of Condition and Price, an offer listing ID is similar to a price tag, one is associated with each item for sale, as shown in the following figure.


          See the example offer listing ID.

This figure shows that three vendors are selling the same item, a shirt. The vendor, labeled Offer 1, has three shirts in stock and each has an OfferListingId.

If an item is for sale, it has an offer listing ID. This ID is returned by the Offers and OfferFull response groups, as shown in the following response snippet.

Copy
<OfferListing> <OfferListingId>[Offer Listing ID]</OfferListingId> <Price> <FormattedPrice>Too low to display</FormattedPrice> </Price> <Availability>Usually ships in 24 hours</Availability> <IsEligibleForSuperSaverShipping>0</IsEligibleForSuperSaverShipping> <IsEligibleForPrime>1</IsEligibleForPrime> </OfferListing>

Offers contain availability and shipping information.

Using the OfferSummary Response Group

The OfferSummary response group returns, in part, the total number of items available in each condition, for example:

Copy
<Item> <ASIN>B000BWFJQ2</ASIN> <OfferSummary> <LowestNewPrice> <Amount>295</Amount> <CurrencyCode>USD</CurrencyCode> <FormattedPrice>$2.95</FormattedPrice> </LowestNewPrice> <TotalNew>1</TotalNew> <TotalUsed>0</TotalUsed> <TotalCollectible>0</TotalCollectible> <TotalRefurbished>0</TotalRefurbished> </OfferSummary>

This response shows that only one of the specified items, B000BWFJQ2, is available and it is only available in "New" condition.