Hierarchical Classification

import requests

API_URL = "https://api.mixpeek.com"
headers = {"Authorization": "Bearer YOUR_API_KEY", "X-Namespace": "your-namespace"}

# Create hierarchical taxonomy
taxonomy = requests.post(f"{API_URL}/v1/taxonomies", headers=headers, json={
    "taxonomy_name": "content_classification",
    "taxonomy_type": "hierarchical",
    "retriever_id": "ret_classifier",
    "input_mappings": {
        "query_embedding": "mixpeek://multimodal_extractor@v1/embedding"
    },
    "hierarchy": [
        {
            "node_id": "safe",
            "collection_id": "col_safe_examples",
            "enrichment_fields": ["metadata.category"]
        },
        {
            "node_id": "educational",
            "parent_node_id": "safe",
            "collection_id": "col_educational_examples",
            "enrichment_fields": ["metadata.topic"]
        }
    ]
}).json()

# Apply taxonomy to collection
requests.post(
    f"{API_URL}/v1/collections/col_my_content/apply-taxonomy",
    headers=headers,
    json={"taxonomy_id": taxonomy["taxonomy_id"]}
)

# Search within taxonomy categories
results = requests.post(
    f"{API_URL}/v1/retrievers/taxonomy-search/execute",
    headers=headers,
    json={"query": {"text": "educational tutorial videos"}}
).json()

for doc in results["documents"]:
    print(f"Document: {doc['document_id']}")
    print(f"  Category: {doc.get('taxonomy_path', 'N/A')}")