HomeDocumentationCode SamplesAPI ReferenceAnnouncementsModelsRelease NotesFAQGitHubVideos
Developer HubAPI StatusSupport
Documentation
Developer HubAPI StatusSupport

Get recommended browse nodes or item type keywords

Learn how to get Amazon recommended browse nodes and item type keywords values using the Product Type Definitions API.

Learn how to get Amazon recommended browse nodes and item type keywords values using the Product Type Definitions API for a product type in a given Amazon marketplace.

Prerequisites

To complete this tutorial, you need:

Get recommended browse nodes or item type keywords

Call the getDefinitionsProductType operation to retrieve updated schemas for a product type from the Product Type Definitions API.

Example of item type keyword in the US Marketplace for LUGGAGE product type

{
  "item_type_keyword": {
    "title": "Item Type Keyword",
    "description": "Item type keywords are used to place new ASINs in the appropriate place(s) within the graph. Select the most specific accurate term for optimal placement.",
    "examples": [
      "Luggage garment bags"
    ],
    "type": "array",
    "minItems": 1,
    "minUniqueItems": 1,
    "maxUniqueItems": 1,
    "selectors": [
      "marketplace_id"
    ],
    "items": {
      "type": "object",
      "required": [
        "value"
      ],
      "properties": {
        "value": {
          "title": "Item Type Keyword",
          "description": "Item type keywords are used to place new ASINs in the appropriate place(s) within the graph. Select the most specific accurate term for optimal placement.",
          "editable": true,
          "hidden": false,
          "examples": [
            "Luggage garment bags"
          ],
          "type": "string",
          "minLength": 1,
          "maxLength": 500,
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "string",
              "enum": [
                "luggage",
                "travel-garment-bags",
                "luggage-accessories",
                "luggage-handle-wraps",
                "luggage-tag-and-handle-wrap-sets"
              ],
              "enumNames": [
                "Clothing, Shoes & Jewelry > Luggage & Travel Gear > Luggage",
                "Clothing, Shoes & Jewelry > Luggage & Travel Gear > Luggage > Garment Bags",
                "Clothing, Shoes & Jewelry > Luggage & Travel Gear > Travel Accessories",
                "Clothing, Shoes & Jewelry > Luggage & Travel Gear > Travel Accessories > Luggage Tags & Handle Wraps > Luggage Handle Wraps",
                "Clothing, Shoes & Jewelry > Luggage & Travel Gear > Travel Accessories > Luggage Tags & Handle Wraps > Tag & Handle Wrap Sets"
              ]
            }
          ]
        },
        "marketplace_id": {
          "$ref": "#/$defs/marketplace_id"
        }
      },
      "additionalProperties": false
    }
  }
}

Example of recommended_browse_nodes in the CA Marketplace for LUGGAGE product type

{
  "recommended_browse_nodes": {
    "title": "Recommended Browse Nodes",
    "description": "Indicate the browse node or section of the Amazon website where the product will be assigned. This allows customers to find the product on the website easily. If you don't provide a node or if you provide an incorrect node, customers may not be able to find your product.",
    "type": "array",
    "minItems": 1,
    "minUniqueItems": 1,
    "maxUniqueItems": 232,
    "selectors": [
      "marketplace_id"
    ],
    "items": {
      "type": "object",
      "required": [
        "value"
      ],
      "properties": {
        "value": {
          "title": "Recommended Browse Nodes",
          "description": "Indicate the browse node or section of the Amazon website where the product will be assigned. This allows customers to find the product on the website easily. If you don't provide a node or if you provide an incorrect node, customers may not be able to find your product.",
          "editable": true,
          "hidden": false,
          "examples": [
            "Diet Bars"
          ],
          "type": "string",
          "minLength": 1,
          "maxLength": 15,
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "string",
              "enum": [
                "21353448011",
                "6303814011",
                "7698694011",
                "6303805011",
                "6303807011"
              ],
              "enumNames": [
                "Clothing, Shoes & Accessories > Luggage & Travel Gear",
                "Clothing, Shoes & Accessories > Luggage & Travel Gear > Accessories > Travel Accessories",
                "Clothing, Shoes & Accessories > Luggage & Travel Gear > Business & Laptop Bags > Laptop Bags",
                "Clothing, Shoes & Accessories > Luggage & Travel Gear > Luggage",
                "Clothing, Shoes & Accessories > Luggage & Travel Gear > Luggage > Garment Bags"
              ]
            }
          ]
        },
        "marketplace_id": {
          "$ref": "#/$defs/marketplace_id"
        }
      },
      "additionalProperties": false
    }
  }
}

The enumerated values correspond to the category browse paths found in the Browse Tree Guide and visible in Seller Central create product page.

Item type keyword.

Updated about 3 hours ago