Prev Next

BrowseNodes Response Group

The BrowseNodes response group returns the browse node names and IDs associated with the items returned in the response. The response group also returns the names and IDs of the child and parent browse nodes of the items returned in the response.

It is possible for one item to belong to multiple browse nodes. So, it is common to see multiple hierarchies of browse nodes for a single item.

Some products, such as parent ASINs, do not return information in the BrowsesNodes response group.

This response group is similar to the BrowseNodeInfo response group. The difference is that the BrowseNodes response group is used with operations that are based on item attributes, search indices, and lists. These operations typically return multiple items. BrowseNodeInfo can only be used with BrowseNodeLookup and the search is always keyed on a browse node ID.

Availability

All locales.

Relevant Operations

Operations that can use this response group include:

Response Elements

The following table describes the elements returned by BrowseNodes. The elements on the left side of a slash mark are the parents of the elements on the right side of the slash mark.

Response ElementAncestryDefinition
BrowseNodeId BrowseNode/Ancestors/BrowseNode/BrowseNodeIdA positive integer that uniquely identifies a parent product category.
BrowseNodeId BrowseNode/BrowseNodeIdA positive integer that uniquely identifies a product category.
BrowseNodeId BrowseNode/Children/BrowseNode/BrowseNodeIdA positive integer that uniquely identifies a child product category.
IsCategoryRootBrowseNodeSearch results can return with items listed under multiple browse nodes. Some nodes, however, are more relevant that others. The IsCategoryRoot identifies which browse node is the most relevant for an item in a specific marketplace. This functionality will help vendors classify items for sale. The element applies to the marketplace specified in the request. So, it is possible for the IsCategoryRoot value to be different across marketplaces. Also, the IsCategoryRoot value is not useful in the Books search index.
Name BrowseNode/Ancestors/BrowseNode/NameThen name of a parent browsenode.
Name BrowseNode/Children/BrowseNode/NameThe name of a child browsenode.
Name BrowseNode/NameThe name of a browsenode.
TotalPages The total number of pages of items found. There are up to ten items per page.  
TotalResults Items/TotalResultsThe total number of items found.

Parent Response Group

The following response groups are parent response groups of BrowseNodes.

Child Response Group

The following response groups are child response groups of BrowseNodes.

Sample REST Use Case

All locales.

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[Access Key ID]&
Operation=BrowseNodeLookup&
SearchIndex=Books&
Keywords=Potter&
ResponseGroup=BrowseNodes

The following response snippet shows the elements returned by BrowseNodes. 

<Item>
  <ASIN>B000002ADT</ASIN>
  <BrowseNodes>
    <BrowseNode>
    <BrowseNodeId>63926</BrowseNodeId>
    <Name>General</Name>
    <Ancestors>
      <BrowseNode>
        <BrowseNodeId>34</BrowseNodeId>
        <Name>Jazz</Name>
        <Ancestors>
          <BrowseNode>
            <BrowseNodeId>301668</BrowseNodeId>
            <Name>Styles</Name>
          </BrowseNode>
        </Ancestors>
      </BrowseNode>
 </Ancestors>
</BrowseNode>
<BrowseNode>
  <BrowseNodeId>598176</BrowseNodeId>
  <Name>Hard Bop</Name>
  <Ancestors>
    <BrowseNode>
      <BrowseNodeId>598174</BrowseNodeId>
      <Name>Bebop</Name>
      <Ancestors>
        <BrowseNode>
          <BrowseNodeId>34</BrowseNodeId>
          <Name>Jazz</Name>
            <Ancestors>
              <BrowseNode>
                <BrowseNodeId>301668</BrowseNodeId>
                <Name>Styles</Name>
              </BrowseNode>
            </Ancestors>
          </BrowseNode>
        </Ancestors>
      </BrowseNode>
    </Ancestors>
  </BrowseNode>
</BrowseNodes>
</Item>
</Items>
Prev Copyright Information Next