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

Return Only Available Items

ItemSearch returns available and unavailable items. Unavailable items are, for example, items that are temporarily out of stock. By setting the Availability parameter to "Available,” ItemSearch can filter out most of the items that are unavailable. The following ItemSearch request returns shirts that are available.

Copy
http://webservices.amazon.com/onca/xml? Service=AWSECommerceService& AWSAccessKeyId=[AWS Access Key ID]& AssociateTag=[Associate Tag]& Operation=ItemSearch& Condition=All& Availability=Available& SearchIndex=Apparel& Keywords=Shirt &Timestamp=[YYYY-MM-DDThh:mm:ssZ] &Signature=[Request Signature]

"Available" is the only valid value for the parameter. Setting it to any other value returns an error message. By default, the value is not set.

Items that are available are classified on Amazon’s retail web site as:

  • Currently for sale

  • Pre-orders

  • Special orders

  • New releases

  • E-mail me when items become available

  • Items available for in-store pickup

  • Items for sale by third parties

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 can be slightly different. These differences are most evident for items, such as software, whose availability changes often.

Note

Do not confuse the Availability parameter with the return element, Availability. The latter is an element in a response that describes how soon an item can be shipped, such as, "Ships in 48 hours". While this is a helpful value to display, it does not guarantee that an item is truly available to be purchased. For that determination, test for an OfferListingId, which is provided by the Offers, OfferFull, and Large response groups.