Health
Entities
Assets
Collections
Namespaces
Feature Extractors
List Taxonomies
Get all taxonomies for the current namespace
curl --request GET \
--url https://api.mixpeek.com/v1/entities/taxonomies{
"results": [
{
"taxonomy_id": "tax_abc123xyz",
"taxonomy_name": "electronics",
"nodes": [
{
"children": [],
"embedding_configs": [
{
"embedding_model": "text",
"type": "text",
"value": "electronics accessories"
}
],
"node_description": "Electronics accessories and peripherals category",
"node_id": "node_abc123def456gh",
"node_name": "electronics_accessories",
"path_tokens": [
"electronics_accessories"
]
}
]
}
],
"pagination": {
"total": 123,
"page": 123,
"page_size": 123,
"total_pages": 123,
"next_page": "<string>",
"previous_page": "<string>"
}
}Headers
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'
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.
Query Parameters
The offset id to start returning results from. Used for pagination
Response
List of fully populated taxonomies with nodes
Taxonomy name
Taxonomy nodes
ID of the taxonomy this node belongs to
Name of the taxonomy node (must be lowercase without spaces)
List of embedding configurations defining how this node should be vectorized
Type of the input
text, url, base64 Value of the input
Name of the embedding model to use
image, multimodal, text, video, keyword, naver-splade-v3, vertex-multimodal, openai-clip-vit-base-patch32, baai-bge-m3 Unique identifier for the taxonomy node
ID of the parent node (None if root node)
Optional description of what this node represents
List of child nodes under this node
ID of the taxonomy this node belongs to
Name of the taxonomy node (must be lowercase without spaces)
List of embedding configurations defining how this node should be vectorized
Type of the input
text, url, base64 Value of the input
Name of the embedding model to use
image, multimodal, text, video, keyword, naver-splade-v3, vertex-multimodal, openai-clip-vit-base-patch32, baai-bge-m3 Unique identifier for the taxonomy node
ID of the parent node (None if root node)
Optional description of what this node represents
List of child nodes under this node
ID of the taxonomy this node belongs to
Name of the taxonomy node (must be lowercase without spaces)
List of embedding configurations defining how this node should be vectorized
Unique identifier for the taxonomy node
ID of the parent node (None if root node)
Optional description of what this node represents
List of child nodes under this node
List of node names representing the path from root to this node
Order of the node in the taxonomy
Depth of the node in the taxonomy
List of node names representing the path from root to this node
Order of the node in the taxonomy
Depth of the node in the taxonomy
List of node names representing the path from root to this node
Order of the node in the taxonomy
Depth of the node in the taxonomy
Auto-generated taxonomy identifier
Was this page helpful?
curl --request GET \
--url https://api.mixpeek.com/v1/entities/taxonomies{
"results": [
{
"taxonomy_id": "tax_abc123xyz",
"taxonomy_name": "electronics",
"nodes": [
{
"children": [],
"embedding_configs": [
{
"embedding_model": "text",
"type": "text",
"value": "electronics accessories"
}
],
"node_description": "Electronics accessories and peripherals category",
"node_id": "node_abc123def456gh",
"node_name": "electronics_accessories",
"path_tokens": [
"electronics_accessories"
]
}
]
}
],
"pagination": {
"total": 123,
"page": 123,
"page_size": 123,
"total_pages": 123,
"next_page": "<string>",
"previous_page": "<string>"
}
}