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:

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 SalesRank element inside BrowseNodes. 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).

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"
      }
    ]
  }
}

results matching ""

    No results matching ""