Note
Search bins are only available in the US locale.
Related Topics
•
SearchBins Response Group (p. 271)
NarrowBy Attribute
The basis on which returned items are split into bins is specified by the
NarrowBy
attribute in the
SearchBinSet element. In the following example, the NarrowBy attribute shows that the bins are based
on price range.
<SearchBinSet NarrowBy="PriceRange">
For another product category, the
NarrowBy
attribute might be different, for example:
<SearchBinSet NarrowBy="BrandName>
You cannot specify
NarrowBy
values nor can you specify the values they encompass. When the
SearchBins response group is included in a request,
ItemSearch
automatically divides the
ItemSearch
results into bins.
Search Bin Example
The following request uses the SearchBins response group to return search bins.
Service=AWSECommerceService&
AWSAccessKeyId=
[Access Key ID]
&
Operation=ItemSearch&
SearchIndex=Baby&
Keywords=pants&
Availability=Available&
Condition=All&
ResponseGroup=SearchBins
&Timestamp=[YYYY-MM-DDThh:mm:ssZ]
&Signature=[Request Signature]
The following xml is a snippet from the response.
<SearchBinSets>
<SearchBinSet NarrowBy="PriceRange">
<Bin>
<BinName>$0$24</BinName>
<BinItemCount>1645</BinItemCount>
<BinParameter>
<Name>MinimumPrice</Name>
<Value>0</Value>
</BinParameter>
<BinParameter>
<Name>MaximumPrice</Name>
API Version 2011-08-01
96
Product Advertising API Developer Guide
Using Search Bins to Find Items
