Amazon Product Advertising API Developer's Manual page 279

Product Advertising API Developer Guide
might have a bin that returns ASINs for shoes that cost between $0 and $50, a second bin for shoes that
cost $50 to $100, and a third bin for shoes that cost more than $100. The basis on which the items are
split into bins is specified by the
you make repeated requests using the
ItemSearch returns the first twenty-five bins of results.
For more information about search bins, see
Availability
US locale only.
NarrowBy
The basis on which the items are split into bins is specified by the
SearchBinSet (p. 310) tag. In the following example, the
are based on price range:
<SearchBinSet NarrowBy="PriceRange">
For another product category, the
<SearchBinSet NarrowBy="BrandName">
You cannot specify NarrowBy (p. 272)
SearchBins is included as a Response Group in a request, ItemSearch automatically divides the
ItemSearch results into bins.
NarrowBy Values
NarrowBy values include:
• Subject—BrowseNode IDs of all topics related to items returned by ItemSearch . For example, searching
for books about dogs returns, in the Subject bins, BrowseNodes for "Home & Garden," "Animal Care
& Pets," "Dogs," and "Educational."
• BrandName—Brands, such as Levi's, Reebok, and Nike, that create the item. Use the name of a brand
to filter out similar items made by other companies.
• PriceRange—Minimum and maximum prices for a bin of items. Use the minimum and maximum price
values in each bin to filter out items outside of the price range you want.
• PercentageOff—Percentage off required on items returned. Use the values returned with
MinPercentageOff key to refine the results
All Search Indices return the Subject bin. Most return all of the bins.
NarrowBy Values by Search Index
The following list shows which NarrowBy values are returned by each Search Index:
• Apparel—Subject, BrandName, PriceRange, PercentageOff
• Appliances—Subject, BrandName, PriceRange, PercentageOff
• ArtsAndCrafts—Subject, BrandName, PriceRange, PercentageOff
• Automotive—Subject, BrandName, PriceRange, PercentageOff
SearchBins Response Group
NarrowBy (p. 272) attribute in the SearchBinSet tag. To refine the search,
NarrowBy (p. 272)
Using Search Bins to Find Items (p.
NarrowBy (p. 272) attribute might be different, for example:
values nor can you specify the values they encompass. When
API Version 2011-08-01
272
values.
95).
NarrowBy (p. 272)
NarrowBy (p. 272) attribute shows that the bins
attribute in the