Etsy · JSON Structure

Open Api V3 Buyer Taxonomy Node Structure

A taxonomy node in the buyer taxonomy tree.

Type: object Properties: 6
MarketplaceE-CommerceHandmadeListingsOrderPaymentsReviewsShippingTaxonomyAuthentication

BuyerTaxonomyNode is a JSON Structure definition published by Etsy, describing 6 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

id level name parent_id children full_path_taxonomy_ids

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/etsy/refs/heads/main/json-structure/open-api-v3-buyer-taxonomy-node-structure.json",
  "name": "BuyerTaxonomyNode",
  "description": "A taxonomy node in the buyer taxonomy tree.",
  "type": "object",
  "properties": {
    "id": {
      "type": "int64",
      "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\".",
      "minimum": 1,
      "example": 1
    },
    "level": {
      "type": "int32",
      "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": "int64",
      "description": "The numeric taxonomy ID of the parent of this node.",
      "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": "int64",
        "minimum": 1
      }
    }
  }
}

Work with this as data

Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for json structure

4 MCP tools reach this
  • find_json_structuresBrowse and filter every JSON Structure in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Structure
curl "https://apis.io/api/v1/json-structures/open-api-v3-buyer-taxonomy-node-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.