Table of Contents
Advertisement
Product Advertising API Developer Guide
•
Large Response Group (p. 239)
Note
Large is a parent of the Offers response group.
All of the search operations listed, except BrowseNodeLookup , can use these response groups. These
response groups return an OfferListingId element for each item that can be purchased. Items that do not
have an OfferListingId cannot be purchased.
The following response snippet shows that an item can be purchased because the response contains an
OfferListingId .
<Item>
...
<Offer>
...
<OfferListing>
<OfferListingId>g7CWSnBZmVESKy%2BCNS</OfferListingId>
<Price>
<Amount>625</Amount>
<CurrencyCode>USD</CurrencyCode>
<FormattedPrice>$6.25</FormattedPrice>
</Price>
<Availability>Usually ships in 1-2 business days
</Availability>
</OfferListing>
</Offer>
</Item>
This response shows how the OfferListingId element is a child of the Item element.
The Availability element in the preceding example is not a reliable means of determining whether or not
an item is truly available for purchase. Its message concerns how quickly an item can ship when it is in
stock. A value returned for Availability does not guarantee that the item is in stock.
Tip
The next chapter talks about adding items to a customer's shopping cart. While it is possible to
add an item to a cart using an ASIN, the preferred means of adding an item is by specifying an
OfferListingId because an OfferListingId , not an ASIN, guarantees that an item can be
purchased.
Availability Parameter
The Availability parameter filters out of ItemSearch results those items that are unavailable. The
availability of an item can change rapidly. There is typically a discrepancy between an item's availability
as reported by ItemSearch and the item's true availability, as reported by Amazon's web site. For this
reason, the availability of items reported by ItemSearch and by Amazon's web site will be slightly
different. Items that are "available" are classified on Amazon's retail web site as:
• Currently for sale
• Pre-orders
• Special orders
Items You Cannot Buy
API Version 2011-08-01
85
Advertisement
Table of Contents
Troubleshooting
