Navigate BrowseNode Tree

Use the GetBrowseNodes Operation to navigate the browse node tree. With every response, use the browse node IDs to refine your search until you find the browse node you want. The operation returns ancestry ladder and immediate children of the requested browse node Id which helps in navigating up/down the browse node tree.

Find a browse node ID that is similar to the one you want and use the BrowseNodeLookup operation to investigate its child and ancestor browse nodes. For more information, see Browse Nodes Guide.

In this tutorial, we'll try finding a specific type of children's book browse node, given we already have BrowseNode Id for the Children's Books browse node that is 4.

Request

As we want a more "specific" type of Children's Book category, we'll request only BrowseNodes.Children resource.

{
   "PartnerTag": "associate-tag-20",
   "PartnerType": "Associates",
   "BrowseNodeIds": ["4"]
   "Resources": ["BrowseNodes.Children"]
}

Response

{
  "BrowseNodesResult": {
    "BrowseNodes": [
      {
        "ContextFreeName": "Children's Books",
        "DisplayName": "Children's Books",
        "Id": "4",
        "IsRoot": false,
        "Children": [
          {
            "ContextFreeName": "Children's Action & Adventure Books",
            "DisplayName": "Action & Adventure",
            "Id": "2967"
          },
          {
            "ContextFreeName": "Children's Activities, Crafts & Games Books",
            "DisplayName": "Activities, Crafts & Games",
            "Id": "3371"
          },
          {
            "ContextFreeName": "Children's Animals Books",
            "DisplayName": "Animals",
            "Id": "2787"
          },
          {
            "ContextFreeName": "Children's Arts, Music & Photography Books",
            "DisplayName": "Arts, Music & Photography",
            "Id": "2870"
          },
          {
            "ContextFreeName": "Children's Biographies",
            "DisplayName": "Biographies",
            "Id": "2351"
          },
          {
            "ContextFreeName": "Children's Transportation Books",
            "DisplayName": "Cars, Trains & Things That Go",
            "Id": "3284"
          },
          {
            "ContextFreeName": "Children's Cookbooks",
            "DisplayName": "Children's Cookbooks",
            "Id": "2655476011"
          },
          {
            "ContextFreeName": "Children's Classics",
            "DisplayName": "Classics",
            "Id": "2970"
          },
          {
            "ContextFreeName": "Children's Comics & Graphic Novels",
            "DisplayName": "Comics & Graphic Novels",
            "Id": "3014"
          },
          {
            "ContextFreeName": "Children's Computers & Technology Books",
            "DisplayName": "Computers & Technology",
            "Id": "2909"
          },
          {
            "ContextFreeName": "Children's Early Learning Books",
            "DisplayName": "Early Learning",
            "Id": "7009080011"
          },
          {
            "ContextFreeName": "Children's Reference & Nonfiction",
            "DisplayName": "Education & Reference",
            "Id": "3176"
          },
          {
            "ContextFreeName": "Children's Folk Tales & Myths",
            "DisplayName": "Fairy Tales, Folk Tales & Myths",
            "Id": "2977"
          },
          {
            "ContextFreeName": "Children's Geography & Cultures Books",
            "DisplayName": "Geography & Cultures",
            "Id": "3344091011"
          },
          {
            "ContextFreeName": "Children's Growing Up & Facts of Life Books",
            "DisplayName": "Growing Up & Facts of Life",
            "Id": "1084192"
          },
          {
            "ContextFreeName": "Children's History",
            "DisplayName": "History",
            "Id": "2917"
          },
          {
            "ContextFreeName": "Children's Holiday Books",
            "DisplayName": "Holidays & Celebrations",
            "Id": "3069"
          },
          {
            "ContextFreeName": "Children's Humor",
            "DisplayName": "Humor",
            "Id": "3003"
          },
          {
            "ContextFreeName": "Children's Literature",
            "DisplayName": "Literature & Fiction",
            "Id": "2966"
          },
          {
            "ContextFreeName": "Children's Mystery, Detective, & Spy",
            "DisplayName": "Mysteries & Detectives",
            "Id": "3016"
          },
          {
            "ContextFreeName": "Children's Religion Books",
            "DisplayName": "Religions",
            "Id": "3101"
          },
          {
            "ContextFreeName": "Children's Science Fiction & Fantasy",
            "DisplayName": "Science Fiction & Fantasy",
            "Id": "3013"
          },
          {
            "ContextFreeName": "Children's Science & Nature Books",
            "DisplayName": "Science, Nature & How It Works",
            "Id": "3207"
          },
          {
            "ContextFreeName": "Children's Sports & Outdoors Books",
            "DisplayName": "Sports & Outdoors",
            "Id": "3400"
          }
        ]
      }
    ]
  }
}

Response Analysis

• The GetBrowseNodes Operation returned 24 children of the Children's Books browse node. Now suppose we're looking for the religious specific children's books, we have Religions (Id: 3101) as one of the child.
• To further specialize the Religions browse node, repeat the step again with 3101 as the BrowseNodeId.
  • If a requested browse node Id has no children, this depicts that the browse node is a leaf node. For more information, refer Browse Nodes Guide.