Get Taxonomy Node

GET

entities

taxonomies

nodes

{node}

curl --request GET \
  --url https://api.mixpeek.com/v1/entities/taxonomies/nodes/{node}

{
  "node_id": "node_abc123def456gh",
  "taxonomy_id": "tax_xyz789",
  "parent_node_id": "node_123abc456def",
  "node_name": "electronics_accessories",
  "node_description": "Electronics accessories and peripherals category",
  "children": [
    {}
  ],
  "path_tokens": [
    "electronics",
    "accessories",
    "cables"
  ],
  "embedding_configs": [
    {
      "embedding_model": "text",
      "type": "text",
      "value": "electronics accessories"
    }
  ],
  "order": [
    1,
    2,
    3
  ],
  "depth": 1
}

Headers

Authorization

string | null

Bearer token authentication using your API key. Format: 'Bearer your_api_key'. To get an API key, create an account at mixpeek.com/start and generate a key in your account settings. Example: 'Bearer sk_1234567890abcdef'

X-Namespace

string | null

Optional namespace for data isolation. This can be a namespace name or namespace ID. Example: 'netflix_prod' or 'ns_1234567890'. To create a namespace, use the /namespaces endpoint.

Path Parameters

node

string

required

The ID or name of the node to find the taxonomy for

Response

200

application/json

Successful Response

taxonomy_id

string

required

ID of the taxonomy this node belongs to

node_name

string

required

Name of the taxonomy node (must be lowercase without spaces)

embedding_configs

object[]

required

List of embedding configurations defining how this node should be vectorized

node_id

string

Unique identifier for the taxonomy node

parent_node_id

string | null

ID of the parent node (None if root node)

node_description

string | null

Optional description of what this node represents

children

object[] | null

List of child nodes under this node

children.taxonomy_id

string

required

ID of the taxonomy this node belongs to

children.node_name

string

required

Name of the taxonomy node (must be lowercase without spaces)

children.embedding_configs

object[]

required

List of embedding configurations defining how this node should be vectorized

children.node_id

string

Unique identifier for the taxonomy node

children.parent_node_id

string | null

ID of the parent node (None if root node)

children.node_description

string | null

Optional description of what this node represents

children.children

object[] | null

List of child nodes under this node

children.children.taxonomy_id

string

required

ID of the taxonomy this node belongs to

children.children.node_name

string

required

Name of the taxonomy node (must be lowercase without spaces)

children.children.embedding_configs

object[]

required

List of embedding configurations defining how this node should be vectorized

children.children.node_id

string

Unique identifier for the taxonomy node

children.children.parent_node_id

string | null

ID of the parent node (None if root node)

children.children.node_description

string | null

Optional description of what this node represents

children.children.children

object[] | null

List of child nodes under this node

children.children.children.taxonomy_id

string

required

ID of the taxonomy this node belongs to

children.children.children.node_name

string

required

Name of the taxonomy node (must be lowercase without spaces)

children.children.children.embedding_configs

object[]

required

List of embedding configurations defining how this node should be vectorized

children.children.children.node_id

string

Unique identifier for the taxonomy node

children.children.children.parent_node_id

string | null

ID of the parent node (None if root node)

children.children.children.node_description

string | null

Optional description of what this node represents

children.children.children.children

object[] | null

List of child nodes under this node

children.children.children.path_tokens

string[]

List of node names representing the path from root to this node

children.children.children.order

integer[]

Order of the node in the taxonomy

children.children.children.depth

integer

default:

Depth of the node in the taxonomy

children.children.path_tokens

string[]

List of node names representing the path from root to this node

children.children.order

integer[]

Order of the node in the taxonomy

children.children.depth

integer

default:

Depth of the node in the taxonomy

children.path_tokens

string[]

List of node names representing the path from root to this node

children.order

integer[]

Order of the node in the taxonomy

children.depth

integer

default:

Depth of the node in the taxonomy

path_tokens

string[]

List of node names representing the path from root to this node

order

integer[]

Order of the node in the taxonomy

depth

integer

default:

Depth of the node in the taxonomy

Was this page helpful?

Suggest edits Raise issue

Update Taxonomy Update Node

curl --request GET \
  --url https://api.mixpeek.com/v1/entities/taxonomies/nodes/{node}

{
  "node_id": "node_abc123def456gh",
  "taxonomy_id": "tax_xyz789",
  "parent_node_id": "node_123abc456def",
  "node_name": "electronics_accessories",
  "node_description": "Electronics accessories and peripherals category",
  "children": [
    {}
  ],
  "path_tokens": [
    "electronics",
    "accessories",
    "cables"
  ],
  "embedding_configs": [
    {
      "embedding_model": "text",
      "type": "text",
      "value": "electronics accessories"
    }
  ],
  "order": [
    1,
    2,
    3
  ],
  "depth": 1
}

Health

Features

Ingest Assets

Entities

Assets

Collections

Namespaces

Feature Extractors

Tasks

Get Taxonomy Node

Headers

Path Parameters

Response