Amazon Product Advertising API Developer's Manual page 107

Product Advertising API Developer Guide
http://webservices.amazon.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS Access Key
Operation=ItemSearch&
SearchIndex=Baby&
Keywords=pants&
Availability=Available&
Condition=All&
MinimumPrice=0& MaximumPrice=2499&
ResponseGroup=SearchBins
&Timestamp=[YYYY-MM-DDThh:mm:ssZ]
&Signature=[Request Signature]
ItemSearch divides the results of this request into another set of search bins because the SearchBins
response group was used again. This means that the price range of the first search bin in the first response
is split into multiple search bins in the response to the second request. The second response enables
you to present more granularity in price ranges. For example, from the first response, you could return
all items that cost between $0 and $24.99. In the second response, you are able to provide a much smaller
price interval, for example, $10 to $14.99.
To refine search results using SearchBin
1. Include the SearchBins response group in an ItemSearch request.
The response includes the narrowby value and results grouped by bins.
2. Use related ItemSearch parameters to send a second request to return results related to only those
items within the specified bin.
For example, if the NarrowBy value is PriceRange , the related ItemSearch parameters are
MinimumPrice and MaximumPrice .
3. If you want to refine the results further, use the SearchBins response group in a second request and
repeat the procedure.
The process of using search bin results for ItemSearch parameter values can be iterative. You can, for
example, submit a third request using the SearchBins response group to divide one search bin into more
search bins. This process can be repeated until the level of granularity you desire is reached. At that
point, you can send a last request using other response groups of your choosing.
Alternatively, you could refine the search results in a different way. Some search indices return more than
one set of search bins. In those cases, you can use the values from more than one set of search bins in
an ItemSearch request. Using the preceding example, if the response also included a search bin based
on BrandName, which is the NarrowBy value, you could use brand and price range values in an
ItemSearch request.
Brand=Levi's&
MinimumPrice=0&
MaximumPrice=2499&
The response would then only include shirts by Levi's that cost under $25. You could continue to drill
down by adding additional parameters to the request.
ItemSearch Request Tips
Here are some tips to help you create accurate
Using Search Bins to Find Items
ID]&
ItemSearch (p. 196)
API Version 2011-08-01
100
requests.