BuyerTaxonomyNode

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "BuyerTaxonomyNode",
  "description": "A taxonomy node in the buyer taxonomy tree.",
  "$id": "https://raw.githubusercontent.com/api-evangelist/etsy/refs/heads/main/json-schema/open-api-v3-buyer-taxonomy-node-schema.json",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "The unique numeric ID of an Etsy taxonomy node, which is a metadata category for listings organized into the seller taxonomy hierarchy tree. For example, the \"shoes\" taxonomy node (ID: 1429, level: 1) is higher in the hierarchy than \"girls' shoes\" (ID: 1440, level: 2). The taxonomy nodes assigned to a listing support access to specific standardized product scales and properties. For example, listings assigned the taxonomy nodes \"shoes\" or \"girls' shoes\" support access to the \"EU\" shoe size scale with its associated property names and IDs for EU shoe sizes, such as property `value_id`:\"1394\", and `name`:\"38\".",
      "format": "int64",
      "minimum": 1,
      "example": 1
    },
    "level": {
      "type": "integer",
      "description": "The integer depth of this taxonomy node in the seller taxonomy tree, with roots at level 0.",
      "minimum": 0,
      "example": 1
    },
    "name": {
      "type": "string",
      "description": "The name string for this taxonomy node.",
      "example": "Handmade Ceramic Mug"
    },
    "parent_id": {
      "type": "integer",
      "description": "The numeric taxonomy ID of the parent of this node.",
      "format": "int64",
      "nullable": true,
      "minimum": 1,
      "default": null,
      "example": 1
    },
    "children": {
      "type": "array",
      "description": "An array of taxonomy nodes for all the direct children of this taxonomy node in the seller taxonomy tree.",
      "items": {
        "description": "An array of taxonomy nodes for all the direct children of this taxonomy node in the seller taxonomy tree.",
        "oneOf": [
          {
            "$ref": "#/components/schemas/BuyerTaxonomyNode"
          }
        ]
      }
    },
    "full_path_taxonomy_ids": {
      "type": "array",
      "description": "An array of `taxonomy_id`s including this node and all of its direct parents in the seller taxonomy tree up to a root node. They are listed in order from root to leaf.",
      "items": {
        "type": "integer",
        "format": "int64",
        "minimum": 1
      }
    }
  }
}