<Value>2499</Value>
</BinParameter>
</Bin>
<Bin>
<BinName>$25$49</BinName>
<BinItemCount>647</BinItemCount>
<BinParameter>
<Name>MinimumPrice</Name>
<Value>2500</Value>
</BinParameter>
<BinParameter>
<Name>MaximumPrice</Name>
<Value>4999</Value>
</BinParameter>
</Bin>
<Bin>
<BinName>$50$99</BinName>
<BinItemCount>173</BinItemCount>
<BinParameter>
<Name>MinimumPrice</Name>
<Value>5000</Value>
</BinParameter>
<BinParameter>
<Name>MaximumPrice</Name>
<Value>9999</Value>
</BinParameter>
</Bin>
This response snippet shows the first three bins in the response. The NarrowBy value shows that the
items were divided up based on price range. The BinName element names the bin. The names are
descriptive of the price ranges that each bin represents. For example, the BinName, $50$99, contains
items that cost between $50 and $99.99, which you can see by the values returned for MinimumPrice
and MaximumPrice in that bin. The BinItemCount element shows how many items are in each bin, for
example, there are 173 items in the last bin.
The BinParameter/Value elements show the values used to create the bins. In this example, the parameters
are the minimum and maximum prices of the items in that bin. For example, in the last bin, the minimum
price of an item in that bin is $50.00 and the maximum value is $99.99.
The BinParameter/Name value, such as MaximumPrice, is an
ItemSearch
parameter name. This means
that you can use the <Value> as the value for the parameter named by <Name> in a subsequent
ItemSearch
request. In this example, MinimumPrice is the
ItemSearch
parameter and, in the last bin,
the value is 5000. By submitting a second request using
ItemSearch
's parameters,
MinimumPrice
and
MaximumPrice
, you could return the item attributes for only the items in that bin.
As you can see from this example, the SearchBins response group enables you to narrow your search
without you having to parse through item attributes.
NarrowBy Values
The following table describes the NarrowBy values.
Description
NarrowBy Values
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.
BrandName
API Version 2011-08-01
97
Product Advertising API Developer Guide
Using Search Bins to Find Items
