Browse Node Properties

Browse nodes properties include the following elements:

Name Description
BrowseNodeId A BrowseNodeId is a unique ID assigned by Amazon that identifies a browse node which is a product category/sub-category. The BrowseNodeId is a positive Long. For more information, refer Browse Node IDs
DisplayName The display name of the BrowseNode as visible on the Amazon retail website.
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.
Children Nodes that are subset of the current node.
Ancestor Nodes that are supersets of the current node. The ancestor property lists all the ancestors of the current node in a ladder upto the root node. Intuitively, the last node in the ancestor ladder is the root node.
IsRoot Indicates if the current BrowseNode is a root node.

The following example response shows that the browse node ID for Family Life is 3045.

{
  "Id": "3045",
  "DisplayName": "Family Life",
  "ContextFreeName": "Children's Family Life Books",
  "IsRoot": false,
  "Children": [
    {
      "ContextFreeName": "Children's Adoption Books",
      "DisplayName": "Adoption",
      "Id": "3046"
    },
    {
      "ContextFreeName": "Children's Babysitting Books",
      "DisplayName": "Babysitting",
      "Id": "1084232"
    },
    {
      "ContextFreeName": "Children's Values Books",
      "DisplayName": "Values",
      "Id": "3163"
    }
  ],
  "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"
        }
      }
    }
  }
}
  • The Family Life Browse Node has 3 child nodes: Children's Adoption Books, Children's Babysitting Books and Children's Value Books.
  • The Ancestry Ladder of Family Life can be demonstrated as:
    _Family Life_ -> _Growing Up & Facts of Life_ -> _Children's Books_ -> _Subjects_ -> _Books_
    
  • Here, the root node of Family Life is Books as it is the last node in the ladder.

Browse Node IDs

Browse node IDs are positive Longs that uniquely identify product sets, such as Children's Books: (4), Babysitting: (1084232), Books: (283155), etc.

While top-level browse node values tend to remain the same, the values of other browse nodes change often. Browse nodes are created and eliminated without notification. As a best practice, do not hard-code browse node IDs in applications.

Browse node IDs are unique in one locale only. The same browse node ID can be used in two locales, but the names and purposes of those browse nodes can be unrelated. Browse node IDs are assigned internally by Amazon. There are no general rules for number assignments. For example, you can't assume that all IDs in the 2000s are related in any way.

If you have a browse node ID, you can find the name of the browse node by specifying the ID in one of the following URLs for each locale:

Locale BrowseNode URL
Australia https://www.amazon.com.au/exec/obidos/tg/browse/-/[BrowseNodeID]
Brazil https://www.amazon.com.br/exec/obidos/tg/browse/-/[BrowseNodeID]
Canada https://www.amazon.ca/exec/obidos/tg/browse/-/[BrowseNodeID]
France https://www.amazon.fr/exec/obidos/tg/browse/-/[BrowseNodeID]
Germany https://www.amazon.de/exec/obidos/tg/browse/-/[BrowseNodeID]
India https://www.amazon.in/exec/obidos/tg/browse/-/[BrowseNodeID]
Japan https://www.amazon.co.jp/exec/obidos/tg/browse/-/[BrowseNodeID]
Mexico https://www.amazon.com.mx/exec/obidos/tg/browse/-/[BrowseNodeID]
Italy https://www.amazon.it/exec/obidos/tg/browse/-/[BrowseNodeID]
Spain https://www.amazon.es/exec/obidos/tg/browse/-/[BrowseNodeID]
United Kingdom https://www.amazon.co.uk/exec/obidos/tg/browse/-/[BrowseNodeID]
United States https://www.amazon.com/exec/obidos/tg/browse/-/[BrowseNodeID]

results matching ""

    No results matching ""