Product Advertising API
Developer Guide (API Version 2011-08-01)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

Common ItemSearch Parameters

Once you decide on a search index value and check Search Index and ItemSearch Parameter Combinationsto determine what ItemSearch input parameters are valid for that search index, you should set values for as many valid parameters as you can to increase the accuracy of the search results.

The most commonly used input parameters are the ones that can be used with the most search indices, including:

  • Availability—Specifies that the item must be available for purchase. The only valid value for the parameter is "Available."

  • BrowseNode—Enables you to search a specified browse node for associated items.

  • Condition—Enables you to specify the condition of an item. Valid values are "All," "New," "Used," "Collectible," and "Refurbished." The default is "New." Condition does not restrict the total number of items returned. It does, however, restrict the offers returned to those items that are in the specified condition.

  • Keywords—A word or phrase (words separated by xml-encoded spaces, %20) used as a search criteria. The titles and descriptions of items are searched for keywords.

  • MaximumPrice—The maximum price that an item can cost.

  • MinimumPrice—The minimum price that an item can cost.

  • Title—A word or phrase (words separated by xml-encoded spaces, %20) used as a search criteria. The titles of items are searched for these words.

The definitions for all ItemSearch parameters are in the API Reference. The following sections describe in greater detail some of the commonly-used parameters.

Searching Across Indices

ItemSearch requests require that you specify a search index. This is because searching across the millions of products in Amazon databases would take too long. Product Advertising API does, however, enable you to search across multiple search indices using the All or Blended search indices.

All Search Index

You can use the All search index to do an ItemSearch search through all search indices. There are, however, a number of restrictions placed on this request: the only parameter that you can use in the request is Keywords, and you cannot, for example, sort results.

[Note]Note

You cannot use the All search index in an ItemLookup request.

Blended Searches

ItemSearch searches through a specified search index, or SearchIndex can be set to "Blended." A blended search always searches through the following search indices (only).

  • Apparel

  • Automotive

  • Books

  • DVD

  • Electronics

  • GourmetFood

  • Kitchen

  • Music

  • PCHardware

  • PetSupplies

  • Software

  • SoftwareVideoGames

  • SportingGoods

  • Tools

  • Toys

  • VHS

  • VideoGames