curl -X GET "https://api.omophub.com/v1/search/suggest?query=hart%20atack&vocabulary_ids=SNOMED,ICD10CM&suggestion_types=spelling,synonym,related&medical_context=cardiology&include_explanations=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

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/suggest', {
  query: {
    query: 'diabetis',
    user_context: 'physician',
    include_corrections: true,
    include_alternatives: true,
    include_related: true,
    include_hierarchical: true,
  },
});

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}

params = {
    'query': 'chest pain breathing problems',
    'vocabulary_ids': 'SNOMED,ICD10CM',
    'domain_ids': 'Condition,Procedure',
    'suggestion_types': 'spelling,synonym,related,broader,narrower',
    'medical_context': 'emergency_medicine',
    'user_context': 'physician',
    'search_intent': 'diagnostic',
    'include_corrections': 'true',
    'include_alternatives': 'true',
    'include_related': 'true',
    'include_hierarchical': 'true',
    'include_trending': 'true',
    'include_explanations': 'true',
    'complexity_level': 'advanced',
    'page_size': 30,
    'relevance_threshold': 0.7
}

response = requests.get(
    'https://api.omophub.com/v1/search/suggest',
    headers=headers,
    params=params
)

data = response.json()

{
  "success": true,
  "data": {
    "query": "hart atack",
    "query_analysis": {
      "detected_intent": "diagnostic",
      "confidence": 0.89,
      "query_quality": "Poor",
      "medical_concepts": [
        {
          "concept": "heart attack",
          "confidence": 0.85,
          "issues": ["spelling error in 'hart'", "spelling error in 'atack'"]
        }
      ],
      "potential_issues": [
        "Multiple spelling errors detected",
        "Informal terminology used",
        "Could be more specific"
      ],
      "improvement_opportunities": [
        "Use correct spelling: 'heart attack'",
        "Consider medical terminology: 'myocardial infarction'",
        "Specify type: 'acute myocardial infarction'"
      ]
    },
    "suggestions": {
      "spelling_corrections": [
        {
          "original": "hart",
          "correction": "heart",
          "confidence": 0.95,
          "correction_type": "spelling",
          "explanation": "Common misspelling of 'heart' in medical queries"
        },
        {
          "original": "atack",
          "correction": "attack", 
          "confidence": 0.92,
          "correction_type": "spelling",
          "explanation": "Missing 't' in 'attack' - common typo"
        }
      ],
      "synonyms": [
        {
          "original_term": "heart attack",
          "synonym": "myocardial infarction",
          "relevance_score": 0.98,
          "concept_id": 22298006,
          "vocabulary_id": "SNOMED",
          "usage_context": "Clinical documentation",
          "formality_level": "Technical",
          "explanation": "Standard medical terminology for heart attack, preferred in clinical settings"
        },
        {
          "original_term": "heart attack",
          "synonym": "MI",
          "relevance_score": 0.92,
          "concept_id": 22298006,
          "vocabulary_id": "SNOMED",
          "usage_context": "Clinical abbreviation",
          "formality_level": "Clinical",
          "explanation": "Common clinical abbreviation for myocardial infarction"
        },
        {
          "original_term": "heart attack",
          "synonym": "acute coronary syndrome",
          "relevance_score": 0.85,
          "concept_id": 394659003,
          "vocabulary_id": "SNOMED",
          "usage_context": "Emergency medicine",
          "formality_level": "Clinical",
          "explanation": "Broader clinical term encompassing heart attacks and related conditions"
        }
      ],
      "related_concepts": [
        {
          "suggested_term": "angina pectoris",
          "relationship_type": "related_condition",
          "relevance_score": 0.87,
          "concept_id": 194828000,
          "vocabulary_id": "SNOMED",
          "domain_id": "Condition",
          "clinical_context": "Precursor or related chest pain condition",
          "explanation": "Related cardiac condition that can precede or mimic heart attack"
        },
        {
          "suggested_term": "coronary artery disease",
          "relationship_type": "underlying_cause",
          "relevance_score": 0.82,
          "concept_id": 53741008,
          "vocabulary_id": "SNOMED", 
          "domain_id": "Condition",
          "clinical_context": "Underlying pathology leading to heart attack",
          "explanation": "Primary underlying condition that causes most heart attacks"
        },
        {
          "suggested_term": "cardiac arrest",
          "relationship_type": "potential_complication",
          "relevance_score": 0.79,
          "concept_id": 410429000,
          "vocabulary_id": "SNOMED",
          "domain_id": "Condition",
          "clinical_context": "Serious complication of heart attack",
          "explanation": "Potential life-threatening complication of myocardial infarction"
        }
      ],
      "broader_concepts": [
        {
          "suggested_term": "cardiovascular disease",
          "hierarchy_level": 2,
          "relevance_score": 0.76,
          "concept_id": 49601007,
          "vocabulary_id": "SNOMED",
          "generalization_type": "system",
          "use_case": "For broader cardiovascular condition searches"
        },
        {
          "suggested_term": "heart disease",
          "hierarchy_level": 1,
          "relevance_score": 0.81,
          "concept_id": 56265001,
          "vocabulary_id": "SNOMED",
          "generalization_type": "category",
          "use_case": "For general cardiac condition searches"
        }
      ],
      "narrower_concepts": [
        {
          "suggested_term": "ST elevation myocardial infarction",
          "hierarchy_level": 1,
          "relevance_score": 0.89,
          "concept_id": 401314000,
          "vocabulary_id": "SNOMED",
          "specialization_type": "subtype",
          "clinical_specificity": "High - specific type based on ECG findings"
        },
        {
          "suggested_term": "non-ST elevation myocardial infarction",
          "hierarchy_level": 1,
          "relevance_score": 0.87,
          "concept_id": 401303003,
          "vocabulary_id": "SNOMED",
          "specialization_type": "subtype",
          "clinical_specificity": "High - specific type based on ECG findings"
        },
        {
          "suggested_term": "acute anterior myocardial infarction",
          "hierarchy_level": 1,
          "relevance_score": 0.84,
          "concept_id": 54329005,
          "vocabulary_id": "SNOMED",
          "specialization_type": "anatomical_location",
          "clinical_specificity": "Very High - location-specific type"
        }
      ],
      "alternative_phrasings": [
        {
          "alternative_query": "heart attack",
          "phrasing_type": "corrected_lay",
          "appropriateness_score": 0.95,
          "target_audience": "General public, patients",
          "expected_results": 234,
          "advantages": [
            "Correct spelling",
            "Widely understood",
            "Patient-friendly"
          ]
        },
        {
          "alternative_query": "myocardial infarction",
          "phrasing_type": "medical_technical",
          "appropriateness_score": 0.92,
          "target_audience": "Healthcare professionals",
          "expected_results": 187,
          "advantages": [
            "Precise medical terminology",
            "Preferred in clinical documentation",
            "Standardized term"
          ]
        },
        {
          "alternative_query": "acute MI",
          "phrasing_type": "clinical_abbreviation",
          "appropriateness_score": 0.87,
          "target_audience": "Clinical staff",
          "expected_results": 156,
          "advantages": [
            "Efficient clinical communication",
            "Commonly used abbreviation",
            "Time-saving"
          ]
        }
      ],
      "trending_suggestions": [
        {
          "suggested_term": "troponin elevation",
          "trend_score": 0.78,
          "trend_context": "diagnostic_biomarker",
          "relevance_to_query": 0.82,
          "trend_duration": "6 months",
          "specialty_focus": [
            "emergency_medicine",
            "cardiology"
          ]
        }
      ],
      "popular_suggestions": [
        {
          "suggested_term": "chest pain",
          "popularity_score": 0.94,
          "search_volume": "High",
          "user_base": "Healthcare professionals and patients",
          "seasonal_pattern": "Stable year-round",
          "stability": "Stable"
        },
        {
          "suggested_term": "cardiac symptoms",
          "popularity_score": 0.86,
          "search_volume": "Medium",
          "user_base": "Healthcare professionals",
          "seasonal_pattern": "None",
          "stability": "Stable"
        }
      ]
    },
    "contextual_recommendations": {
      "search_strategy": "Start with corrected spelling, then explore specific types if needed",
      "vocabulary_recommendations": [
        {
          "vocabulary": "SNOMED",
          "reason": "Comprehensive cardiac terminology",
          "priority": "High"
        },
        {
          "vocabulary": "ICD10CM",
          "reason": "Administrative coding and billing",
          "priority": "Medium"
        }
      ],
      "domain_focus": [
        "Condition",
        "Observation"
      ],
      "filter_suggestions": [
        {
          "filter": "domain=Condition",
          "reason": "Focus on diagnostic conditions"
        },
        {
          "filter": "specialty=cardiology",
          "reason": "Cardiac-specific context"
        }
      ],
      "search_tips": [
        "Use correct spelling for better results",
        "Try both lay terms and medical terminology",
        "Consider specific types (STEMI, NSTEMI) for detailed information",
        "Include related symptoms (chest pain, shortness of breath) for broader context"
      ]
    },
    "personalization_insights": null
  },
  "meta": {
    "request_id": "req_search_suggest_123",
    "timestamp": "2024-01-15T10:30:00Z",
    "suggestion_engine_version": "v3.1.0",
    "total_suggestions": 45,
    "processing_time_ms": 178,
    "personalization_applied": false,
    "context_factors": [
      "medical_context: cardiology",
      "spelling_errors_detected",
      "intent: diagnostic",
      "formality: mixed"
    ],
    "vocab_release": "2024.2"
  }
}