Menu
Product Advertising API
Developer Guide (API Version 2013-08-01)

BrowseNodeInfo

For a given browse node ID, the BrowseNodeInfo response group returns the browse node name and ID of the child and parent browse nodes.

One application of this information is to use the child and parent browse nodes to traverse the browse node hierarchy to either refine a search (child nodes) or to generalize a search (parent nodes). You do that using BrowseNodeLookup one or more times. Refining a search enables you to return more highly targeted results. Generalizing a response enables you to find what product category a browse node belongs to.

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

Relevant Operations

Operations that can use this response group include:

Response Elements

The following table describes the elements returned by BrowseNodeInfo.

BrowseNodeInfo returns the identity of child and parent browse nodes. That information is typically used with BrowseNodeLookup to traverse the browse node hierarchy.

Parent Response Group

The following response groups are parent response groups of BrowseNodeInfo.

  • None

Child Response Group

The following response groups are child response groups of BrowseNodeInfo.

  • None

Sample REST Use Case

The following request uses the BrowseNodeInfo response group.

Copy
http://webservices.amazon.com/onca/xml? Service=AWSECommerceService& AWSAccessKeyId=[AWS Access Key ID]& AssociateTag=[Associate ID]& Operation=BrowseNodeLookup& BrowseNodeId=11232& ResponseGroup=BrowseNodeInfo& Version=2013-08-01 &Timestamp=[YYYY-MM-DDThh:mm:ssZ] &Signature=[Request Signature]

Sample Response Snippet

The following response snippet shows the elements returned by BrowseNodeInfo.

Copy
<BrowseNodes> <Request> <IsValid>True</IsValid> <BrowseNodeLookupRequest> <BrowseNodeId>11232</BrowseNodeId> <ResponseGroup>BrowseNodeInfo</ResponseGroup> </BrowseNodeLookupRequest> </Request> <BrowseNode> <BrowseNodeId>11232</BrowseNodeId> <Name>Social Sciences</Name> <Children> <BrowseNode> <BrowseNodeId>3048861</BrowseNodeId> <Name>Children's Studies</Name> </BrowseNode> <BrowseNode> <BrowseNodeId>13022421</BrowseNodeId> <Name>Communication & Media Studies</Name> </BrowseNode> <BrowseNode> <BrowseNodeId>11005</BrowseNodeId> <Name>Criminology</Name> </BrowseNode> <BrowseNode> <BrowseNodeId>11244</BrowseNodeId> <Name>Customs & Traditions</Name> </BrowseNode> <BrowseNode> <BrowseNodeId>11247</BrowseNodeId> <Name>Demography</Name> </BrowseNode> ....more browse nodes </Children> <Ancestors> <BrowseNode> <BrowseNodeId>3377866011</BrowseNodeId> <Name>Politics & Social Sciences</Name> <Ancestors> <BrowseNode> <BrowseNodeId>1000</BrowseNodeId> <Name>Subjects</Name> <IsCategoryRoot>1</IsCategoryRoot> <Ancestors> <BrowseNode> <BrowseNodeId>283155</BrowseNodeId> <Name>Books</Name> </BrowseNode> </Ancestors> </BrowseNode> </Ancestors> </BrowseNode> </Ancestors> </BrowseNode> </BrowseNodes>

Notice in this response snippet that the child nodes are all at the same level in the hierarchical browse node tree, which is the level directly beneath the browse node in the request, 11232, Social Science. The parent nodes, however, show the entire lineage of browse nodes from Social Science all the way up the browse node tree to the root browse node, Books, 283155. Only one lineage, however, is returned. If a single node has multiple parents, only one of those parents is returned.