Browse Node Searches

Browse Node Searches via XML

The browse structure is the way that Amazon.com organizes products into subjects and categories on our site so that customers can find the product they want easily and efficiently. A browse ID is a number that corresponds to a general subject area of Amazon.com. (For example, the browse ID for the parent books category in the US is 1000).

To find browse IDs at Amazon.com, the best way is to visit the "browse" area of the various product lines at our Web site. When you find a subject area that you would like to generate XML for, look at the web page URL. The browse ID should appear after the string "/tg/browse/-/". Here are some examples of URLs that contain browse IDs:

http://www.amazon.com/exec/obidos/tg/browse/-/30 (In this example, the browse ID = 30)
http://www.amazon.com/exec/obidos/tg/browse/-/467970 (In this example, the browse ID = 467970)
http://www.amazon.com/exec/obidos/tg/browse/-/602314 (In this example, the browse ID = 60231

Please be aware that some nodes cannot be used with a BrowseNodeSearch. (The vast majority of them can, but you may run across a few that simply will not work). It is also important to point out that from time to time, some browse nodes are deprecated or are changed without notice. Please see Appendix A for a list of commonly used browse nodes.

Call and Response

Request Format

http://xml.amazon.com/onca/xml3?t=webservices-20&dev-t=[Developer’s token goes here]&BrowseNodeSearch=[browse node goes here]&mode=[product line goes here]&type=[lite or heavy] &page=[page # goes here]&f=xml

Response

The BrowseNodeSearch request returns a ProductInfo node. The ProductInfo node contains an array of Detail nodes.

Example

To generate a "heavy" XML document listing top-selling books, the URL would look like this:

http://xml.amazon.com/onca/xml3?t=webservices-20&dev-t=[developer’s token goes here]&BrowseNodeSearch=1000&mode=books&type=heavy&page=1&f=xml

Browse Node Searches via SOAP

This section shows how to create a request for a browse node search.  This request will return a SOAP object containing the Lite or the Heavy form of the data.

Call and Response

Request Name

BrowseNodeSearchRequest

Request Format

browse_node string

page  string

mode  string

tag  string

type  string

sort  string  (optional)

devtag  string

Response

The BrowseNodeSearch request returns a ProductInfo node. The ProductInfo node contains an array of Detail nodes.

Filtering by Browse Results by Keyword

You can add a keywords parameter to your request to filter the results by that keyword. To filter by keyword, add the keyword parameter to your request as shown:

http://xml.amazon.com/onca/xml3?t=webservices-20&dev-t=[developer’s token goes here]&BrowseNodeSearch=1000&mode=books&type=heavy&page=1&keywords=dog&f=xml