curl -X GET "https://api.omophub.com/v1/search/facets?query=diabetes&vocabulary_ids=SNOMED,ICD10CM&bucket_limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

import { OMOPHub } from '@omophub/omophub-node';

// Not yet exposed as a dedicated SDK method - use the typed low-level helper.
const client = new OMOPHub();
const { data } = await client.get<unknown>('/search/facets', {
  query: {
    query: 'diabetes',
    vocabulary_ids: 'SNOMED,ICD10CM',
    bucket_limit: 20,
  },
});

import requests

response = requests.get(
    "https://api.omophub.com/v1/search/facets",
    params={
        "query": "diabetes",
        "vocabulary_ids": "SNOMED,ICD10CM",
        "bucket_limit": 20
    },
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

{
  "success": true,
  "data": {
    "query": "diabetes",
    "total_items": 312,
    "facets": {
      "vocabularies": [
        {
          "vocabulary_id": "SNOMED",
          "vocabulary_name": "SNOMED CT",
          "count": 245
        },
        {
          "vocabulary_id": "ICD10CM",
          "vocabulary_name": "ICD-10-CM",
          "count": 67
        }
      ],
      "domains": [
        { "domain_id": "Condition", "domain_name": "Condition", "count": 198 },
        {
          "domain_id": "Observation",
          "domain_name": "Observation",
          "count": 87
        },
        { "domain_id": "Drug", "domain_name": "Drug", "count": 27 }
      ],
      "concept_classes": [
        {
          "concept_class_id": "Clinical Finding",
          "concept_class_name": "Clinical Finding",
          "count": 156
        },
        {
          "concept_class_id": "Disorder",
          "concept_class_name": "Disorder",
          "count": 87
        },
        {
          "concept_class_id": "Procedure",
          "concept_class_name": "Procedure",
          "count": 42
        }
      ],
      "years": [
        { "year": 2025, "count": 245 },
        { "year": 2024, "count": 67 }
      ]
    },
    "facet_metadata": {
      "vocabularies": {
        "total_buckets": 2,
        "returned_buckets": 2,
        "returned_count": 312,
        "other_count": 0
      },
      "domains": {
        "total_buckets": 3,
        "returned_buckets": 3,
        "returned_count": 312,
        "other_count": 0
      },
      "concept_classes": {
        "total_buckets": 4,
        "returned_buckets": 3,
        "returned_count": 285,
        "other_count": 27
      },
      "years": {
        "total_buckets": 2,
        "returned_buckets": 2,
        "returned_count": 312,
        "other_count": 0
      }
    },
    "facet_status": {
      "partial": false,
      "failed_facets": []
    }
  },
  "meta": {
    "request_id": "req_abc123",
    "vocab_release": "2025.1"
  }
}