BrowseNodeInfo
The BrowseNodeInfo Resource in any item operation returns BrowseNodes the item falls under and the ancestry of that browse node. The browse nodes returned contain several browse node properties like Id, DisplayName, ContextFreeName, Ancestor and IsRoot. Refer Organization of Items on Amazon, Browse Nodes Guide and Browse Nodes and SalesRank Guide for more information.
The browse node information returned as part of BrowseNodeInfo resource can further be utilized to:
- Make a browse node targeted search request using SearchItems Operation by supplying the desired BrowseNodeId.
- Navigate browse node tree to find more generic or specific browse nodes.
Availability
All locales.
Response Elements
| Name | Description |
|---|---|
| BrowseNodes | Container for BrowseNodes associated with the Item. The container includes BrowseNodeId, DisplayName, ContextFreeName, Ancestor, IsRoot and SalesRank information. For more information, refer BrowseNodes Response Element |
| WebsiteSalesRank | Container for Website Sales Rank associated with a product. Includes DisplayName, ContextFreeName and SalesRank information. For more information, refer WebsiteSalesRank Response Element |
This is how the response elements in BrowseNodeInfo resource maps to the information available on Amazon Detail Page:
- The top most line depicting Amazon Best Sellers Rank maps to the WebsiteSalesRank Response Element.
- WebsiteSalesRank is the sales rank of the item in the top level or the root browse node.
- Note that, not all items have top level sales rank information available and hence, BrowseNodeInfo might not contain WebsiteSalesRank information for all items.
- All the other browse nodes in the snapshot maps to the BrowseNodes Response Element.
- Each of these browse nodes have rank associated with them. This rank is returned under the
SalesRankelement insideBrowseNodes. The rank here denotes the selling rank of the item in that particular browse node. - Note that, the number of browse nodes returned for an item are usually greater than the number of browse nodes for which sales rank information is present. This is because, Amazon displays only Highly Relevant Sales Ranks (i.e. top most sales ranks).
- Each of these browse nodes have rank associated with them. This rank is returned under the
BrowseNodes Response Element
The structure of BrowseNodes container inside the high level BrowseNodeInfo Resource is as follows:
{
"BrowseNodes": [
{
"Ancestor": "Ancestry ladder of the BrowseNode up-to the root node",
"ContextFreeName": "Context Free Name of the BrowseNode",
"DisplayName": "Display Name of the BrowseNode",
"Id": "The BrowseNode ID",
"IsRoot": "Depicts whether the BrowseNode is a root node",
"SalesRank": "The sales rank of the item associated with the BrowseNode"
}
]
}
Refer following table for more information on each of the individual response elements of the BrowseNodes response element:
| Response Element | Description |
|---|---|
| Ancestor | Container for BrowseNode Ancestor information which includes BrowseNodeId, DisplayName, ContextFreeName and Ancestor information if one exists. The container is a ladder containing ancestor information up-to root browse node. That is, the last node in the ladder will be Root Node. Note that a root BrowseNode will not have any ancestor. |
| ContextFreeName | Indicates a displayable name for a BrowseNode that is fully context free. For e.g. DisplayName of BrowseNodeId: 3060 in US marketplace is Orphans & Foster Homes. One can not infer which root category this browse node belongs to unless we have the ancestry ladder for this browse node i.e. it requires a "context" for being intuitive. However, the ContextFreeName of this browse node is Children's Orphans & Foster Homes Books. Note that, for a BrowseNode whose DisplayName is already context free will have the same ContextFreeName as DisplayName. |
| DisplayName | The display name of the BrowseNode as visible on the Amazon retail website. |
| Id | Indicates the unique identifier of the BrowseNode |
| IsRoot | Indicates if the current BrowseNode is a root category. |
| SalesRank | Sales Rank of the item associated with the browse node. |
Each of these browse nodes have sales rank associated with them. The rank here denotes the selling rank of the item in that particular browse node. Note that, the number of browse nodes returned for an item are usually greater than the number of browse nodes for which sales rank information is present. This is because, Amazon displays only Highly Relevant Sales Ranks (i.e. top most sales ranks).
WebsiteSalesRank Response Element
The structure of WebsiteSalesRank container inside the high level BrowseNodeInfo Resource is as follows:
{
"WebsiteSalesRank": {
"ContextFreeName": "Context Free Name of the BrowseNode",
"DisplayName": "Display Name of the BrowseNode",
"SalesRank": "The website sales rank of the item"
}
}
Note that, not all items have top level sales rank information available and hence, BrowseNodeInfo might not contain WebsiteSalesRank information for all items.
Relevant Operations
Operations that can use these resources include:
Resources
Add the resource name in the request payload to get the corresponding data in the API response.
| Name | Description |
|---|---|
| BrowseNodeInfo.BrowseNodes | Get the browse nodes associated with the item. Using this resource only will return Id, DisplayName, ContextFreeName and IsRoot information associated with each browse node. |
| BrowseNodeInfo.BrowseNodes.Ancestor | Get the Ancestry ladder associated with each of the browse nodes the item falls under. Using this resource only will return ancestry ladder along with Id, DisplayName, ContextFreeName and IsRoot information associated with each browse node. |
| BrowseNodeInfo.BrowseNodes.SalesRank | Get the SalesRank information with each of the browse nodes the item falls under. Using this resource only will return sales rank along with Id, DisplayName, ContextFreeName and IsRoot information associated with each browse node. |
| BrowseNodeInfo.WebsiteSalesRank | Get WebsiteSalesRank information associated with the item. Using this resource only will return the WebsiteSalesRank Container for the item. |
BrowseNodeInfo.BrowseNodes
Requesting this resource returns browse nodes associated with the item. For each of the browse nodes returned, Id, DisplayName, ContextFreeName and IsRoot information is returned.
Sample Response
The following response snippet assumes GetItems Request for the ItemId:059035342X
{
"ItemsResult": {
"Items": [
{
"ASIN": "059035342X",
"BrowseNodeInfo": {
"BrowseNodes": [
{
"Id": "3060",
"DisplayName": "Orphans & Foster Homes",
"ContextFreeName": "Children's Orphans & Foster Homes Books",
"IsRoot": false
},
{
"Id": "3153",
"DisplayName": "Friendship",
"ContextFreeName": "Children's Friendship Books",
"IsRoot": false
},
{
"Id": "15356791",
"DisplayName": "School",
"ContextFreeName": "Children's School Issues",
"IsRoot": false
}
]
}
}
]
}
}
BrowseNodeInfo.BrowseNodes.Ancestors
Requesting this resource returns ancestry ladder along with Id, DisplayName, ContextFreeName and IsRoot information associated with each browse node.
Sample Response
The following response snippet assumes GetItems Request for the ItemId:059035342X
{
"ItemsResult": {
"Items": [
{
"ASIN": "059035342X",
"BrowseNodeInfo": {
"BrowseNodes": [
{
"Id": "3060",
"DisplayName": "Orphans & Foster Homes",
"ContextFreeName": "Children's Orphans & Foster Homes Books",
"IsRoot": false,
"Ancestor": {
"Id": "3045",
"DisplayName": "Family Life",
"ContextFreeName": "Children's Family Life Books",
"Ancestor": {
"Id": "1084192",
"DisplayName": "Growing Up & Facts of Life",
"ContextFreeName": "Children's Growing Up & Facts of Life Books",
"Ancestor": {
"Id": "4",
"DisplayName": "Children's Books",
"ContextFreeName": "Children's Books",
"Ancestor": {
"Id": "1000",
"DisplayName": "Subjects",
"ContextFreeName": "Subjects",
"Ancestor": {
"Id": "283155",
"DisplayName": "Books",
"ContextFreeName": "Books"
}
}
}
}
}
},
{
"Id": "3153",
"DisplayName": "Friendship",
"ContextFreeName": "Children's Friendship Books",
"IsRoot": false,
"Ancestor": {
"Id": "7009087011",
"DisplayName": "Friendship, Social Skills & School Life",
"ContextFreeName": "Children's Friendship & Social Skills Books",
"Ancestor": {
"Id": "1084192",
"DisplayName": "Growing Up & Facts of Life",
"ContextFreeName": "Children's Growing Up & Facts of Life Books",
"Ancestor": {
"Id": "4",
"DisplayName": "Children's Books",
"ContextFreeName": "Children's Books",
"Ancestor": {
"Id": "1000",
"DisplayName": "Subjects",
"ContextFreeName": "Subjects",
"Ancestor": {
"Id": "283155",
"DisplayName": "Books",
"ContextFreeName": "Books"
}
}
}
}
}
},
{
"Id": "15356791",
"DisplayName": "School",
"ContextFreeName": "Children's School Issues",
"IsRoot": false,
"Ancestor": {
"Id": "7009087011",
"DisplayName": "Friendship, Social Skills & School Life",
"ContextFreeName": "Children's Friendship & Social Skills Books",
"Ancestor": {
"Id": "1084192",
"DisplayName": "Growing Up & Facts of Life",
"ContextFreeName": "Children's Growing Up & Facts of Life Books",
"Ancestor": {
"Id": "4",
"DisplayName": "Children's Books",
"ContextFreeName": "Children's Books",
"Ancestor": {
"Id": "1000",
"DisplayName": "Subjects",
"ContextFreeName": "Subjects",
"Ancestor": {
"Id": "283155",
"DisplayName": "Books",
"ContextFreeName": "Books"
}
}
}
}
}
}
]
}
}
]
}
}
BrowseNodeInfo.BrowseNodes.SalesRank
Requesting this resource returns sales rank information along with Id, DisplayName, ContextFreeName and IsRoot information associated with each browse node.
Sample Response
The following response snippet assumes GetItems Request for the ItemId:059035342X
{
"ItemsResult": {
"Items": [
{
"ASIN": "059035342X",
"BrowseNodeInfo": {
"BrowseNodes": [
{
"Id": "3060",
"DisplayName": "Orphans & Foster Homes",
"ContextFreeName": "Children's Orphans & Foster Homes Books",
"IsRoot": false,
"SalesRank": 2
},
{
"Id": "3153",
"DisplayName": "Friendship",
"ContextFreeName": "Children's Friendship Books",
"IsRoot": false,
"SalesRank": 4
},
{
"Id": "15356791",
"DisplayName": "School",
"ContextFreeName": "Children's School Issues",
"IsRoot": false,
"SalesRank": 15
}
]
}
}
]
}
}
BrowseNodeInfo.WebsiteSalesRank
Requesting this resource returns website sales rank information associated with the item.
Sample Response
The following response snippet assumes GetItems Request for the ItemId:059035342X
{
"ItemsResult": {
"Items": [
{
"ASIN": "059035342X",
"BrowseNodeInfo": {
"WebsiteSalesRank": {
"DisplayName": "Books",
"ContextFreeName": "Books",
"SalesRank": 197
}
}
}
]
}
}
Sample Use Cases
Example 1
Get WebsiteSalesRank for an Item:
Request Payload
{
"ItemIds": ["059035342X"],
"ItemIdType": "ASIN",
"Marketplace": "www.amazon.com",
"PartnerTag": "associate-tag-20",
"PartnerType": "Associates",
"Resources": ["BrowseNodeInfo.WebsiteSalesRank"]
}
Response
{
"ItemsResult": {
"Items": [
{
"ASIN": "059035342X",
"BrowseNodeInfo": {
"WebsiteSalesRank": {
"DisplayName": "Books",
"ContextFreeName": "Books",
"SalesRank": 197
}
},
"DetailPageURL": "https://www.amazon.com/dp/059035342X?tag=associate-tag-20&linkCode=ogi&th=1&psc=1"
}
]
}
}
Example 2
Get all BrowseNodes associated with the item without the ancestry and sales rank information.
Request Payload
{
"ItemIds": ["059035342X"],
"ItemIdType": "ASIN",
"Marketplace": "www.amazon.com",
"PartnerTag": "associate-tag-20",
"PartnerType": "Associates",
"Resources": ["BrowseNodeInfo.BrowseNodes"]
}
Response
{
"ItemsResult": {
"Items": [
{
"ASIN": "059035342X",
"BrowseNodeInfo": {
"BrowseNodes": [
{
"Id": "3060",
"DisplayName": "Orphans & Foster Homes",
"ContextFreeName": "Children's Orphans & Foster Homes Books",
"IsRoot": false
},
{
"Id": "3153",
"DisplayName": "Friendship",
"ContextFreeName": "Children's Friendship Books",
"IsRoot": false
},
{
"Id": "15356791",
"DisplayName": "School",
"ContextFreeName": "Children's School Issues",
"IsRoot": false
}
]
},
"DetailPageURL": "https://www.amazon.com/dp/059035342X?tag=associate-tag-20&linkCode=ogi&th=1&psc=1"
}
]
}
}
Example 3
Get all BrowseNodeInfo information for an item
Request Payload
{
"ItemIds": ["059035342X"],
"ItemIdType": "ASIN",
"Marketplace": "www.amazon.com",
"PartnerTag": "associate-tag-20",
"PartnerType": "Associates",
"Resources": ["BrowseNodeInfo.BrowseNodes", "BrowseNodeInfo.BrowseNodes.Ancestor", "BrowseNodeInfo.BrowseNodes.SalesRank", "BrowseNodeInfo.WebsiteSalesRank"]
}
Response
{
"ItemsResult": {
"Items": [
{
"ASIN": "059035342X",
"BrowseNodeInfo": {
"WebsiteSalesRank": {
"DisplayName": "Books",
"ContextFreeName": "Books",
"SalesRank": 197
},
"BrowseNodes": [
{
"Id": "3060",
"DisplayName": "Orphans & Foster Homes",
"ContextFreeName": "Children's Orphans & Foster Homes Books",
"IsRoot": false,
"SalesRank": 2,
"Ancestor": {
"Id": "3045",
"DisplayName": "Family Life",
"ContextFreeName": "Children's Family Life Books",
"Ancestor": {
"Id": "1084192",
"DisplayName": "Growing Up & Facts of Life",
"ContextFreeName": "Children's Growing Up & Facts of Life Books",
"Ancestor": {
"Id": "4",
"DisplayName": "Children's Books",
"ContextFreeName": "Children's Books",
"Ancestor": {
"Id": "1000",
"DisplayName": "Subjects",
"ContextFreeName": "Subjects",
"Ancestor": {
"Id": "283155",
"DisplayName": "Books",
"ContextFreeName": "Books"
}
}
}
}
}
},
{
"Id": "3153",
"DisplayName": "Friendship",
"ContextFreeName": "Children's Friendship Books",
"IsRoot": false,
"SalesRank": 5,
"Ancestor": {
"Id": "7009087011",
"DisplayName": "Friendship, Social Skills & School Life",
"ContextFreeName": "Children's Friendship & Social Skills Books",
"Ancestor": {
"Id": "1084192",
"DisplayName": "Growing Up & Facts of Life",
"ContextFreeName": "Children's Growing Up & Facts of Life Books",
"Ancestor": {
"Id": "4",
"DisplayName": "Children's Books",
"ContextFreeName": "Children's Books",
"Ancestor": {
"Id": "1000",
"DisplayName": "Subjects",
"ContextFreeName": "Subjects",
"Ancestor": {
"Id": "283155",
"DisplayName": "Books",
"ContextFreeName": "Books"
}
}
}
}
}
},
{
"Id": "15356791",
"DisplayName": "School",
"ContextFreeName": "Children's School Issues",
"IsRoot": false,
"SalesRank": 4,
"Ancestor": {
"Id": "7009087011",
"DisplayName": "Friendship, Social Skills & School Life",
"ContextFreeName": "Children's Friendship & Social Skills Books",
"Ancestor": {
"Id": "1084192",
"DisplayName": "Growing Up & Facts of Life",
"ContextFreeName": "Children's Growing Up & Facts of Life Books",
"Ancestor": {
"Id": "4",
"DisplayName": "Children's Books",
"ContextFreeName": "Children's Books",
"Ancestor": {
"Id": "1000",
"DisplayName": "Subjects",
"ContextFreeName": "Subjects",
"Ancestor": {
"Id": "283155",
"DisplayName": "Books",
"ContextFreeName": "Books"
}
}
}
}
}
}
]
},
"DetailPageURL": "https://www.amazon.com/dp/059035342X?tag=associate-tag-20&linkCode=ogi&th=1&psc=1"
}
]
}
}