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
NarrowBy (p. 272)
attribute in the SearchBinSet tag. To refine the search,
you make repeated requests using the
NarrowBy (p. 272)
values.
ItemSearch
returns the first twenty-five bins of results.
For more information about search bins, see
Using Search Bins to Find Items (p. 95)
.
Availability
US locale only.
NarrowBy
The basis on which the items are split into bins is specified by the
NarrowBy (p. 272)
attribute in the
SearchBinSet (p. 310)
tag. In the following example, the
NarrowBy (p. 272)
attribute shows that the bins
are based on price range:
<SearchBinSet NarrowBy="PriceRange">
For another product category, the
NarrowBy (p. 272)
attribute might be different, for example:
<SearchBinSet NarrowBy="BrandName">
You cannot specify
NarrowBy (p. 272)
values nor can you specify the values they encompass. When
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
API Version 2011-08-01
272
Product Advertising API Developer Guide
SearchBins Response Group
