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

Search Indices

On Amazon, you can find just about anything—from a book to a $100,000 piece of jewelry. The job of finding the items you want to buy is made more difficult by having so many items for sale. Returning too many items in a response is almost as bad as returning no items at all. Amazon addresses this difficulty by placing every item it sells into a product category, called a search index.

You can think of search indices as dividing into groups everything for sale on Amazon, as shown in the following figure.

By selecting one slice in a request , you avoid returning items in all of the other slices. This functionality makes requests more targeted and reduces search times. For example, when looking for a specific book, it is best to specify the Books search index in the request.

Copy
SearchIndex=Books

Titles and keywords used to find items often occur in multiple search indices. For example, if you were searching using "Harry%20Potter" as your keyword, you would get results in many search indices, including Books, DVD, Video, and Music. By specifying the search index you are interested in, your request becomes much better targeted.

Specifying the wrong search index leads to no results or results that do not meet the customer's search criteria. For example, if your keyword was carburetor and the search index was Kitchen, you might not get any items that match the search criteria. Change the search index to Automotive and you'd get many matches. For a complete list of search indices that are valid per locale, see Locale Reference for the Product Advertising API.

Combined Search Indices

As a convenience, some of the search indices are combinations of other search indices, for example:

All

Searches through all search indices. Only five pages of items can be returned where each page contains up to five items.

Blended

Combines the following search indices: DVD, Electronics, Toys, VideoGames, PCHardware, Tools, SportingGoods, Books, Software, Music, GourmetFood, Kitchen, and Apparel search indices.

Music

Combines Classical, DigitalMusic, and MusicTracks search indices.

Video

Combines DVD and VHS search indices.

These search index combinations are helpful when you are not sure which search index to specify. The downside of using one of these combined search indices is that they might return quite a few items in the response.

More commonly, you will specify individual search indices in requests, for example,

Copy
http://webservices.amazon.com/onca/xml? Service=AWSECommerceService& AWSAccessKeyId=[AWS Access Key ID]& AssociateTag=[Associate ID]& Operation=ItemSearch& Condition=All& ResponseGroup=Images& SearchIndex=Books& Title=Harry%20Potter &Timestamp=[YYYY-MM-DDThh:mm:ssZ] &Signature=[Request Signature]

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. You cannot, for example, sort results. Results are restricted to the first five pages of results. Each page can have up to five results.

Note

The list of all available search indices by locale can be found on the search indices page.