Advanced Search

curl -X POST "https://api.omophub.com/v1/search/advanced" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "diabetes mellitus type 2",
    "page_size": 10
  }'

results = client.search.advanced_search(
    query="diabetes mellitus type 2",
    page_size=10
)

for concept in results.data:
    print(f"{concept.concept_id}: {concept.concept_name}")
    print(f"  Vocabulary: {concept.vocabulary_id}")
    print(f"  Score: {concept.search_score:.3f}")

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

const client = new OMOPHub();
const { data: results } = await client.search.advanced({
  query: 'diabetes mellitus type 2',
  pageSize: 10,
});

results?.forEach(concept => {
  console.log(`${concept.concept_id}: ${concept.concept_name}`);
  console.log(`  Vocabulary: ${concept.vocabulary_id}`);
  console.log(`  Score: ${concept.search_score?.toFixed(3)}`);
});

results <- advanced_search_concepts(client,
  query = "diabetes mellitus type 2",
  page_size = 10
)

for (i in 1:nrow(results$data$concepts)) {
  concept <- results$data$concepts[i, ]
  cat(paste(concept$concept_id, concept$concept_name, sep = ": "), "\n")
  cat(paste("  Vocabulary:", concept$vocabulary_id), "\n")
  cat(paste("  Score:", round(concept$search_score, 3)), "\n")
}

{
  "success": true,
  "data": {
    "concepts": [
      {
        "concept_id": 201826,
        "concept_name": "Type 2 diabetes mellitus",
        "concept_code": "44054006",
        "vocabulary_id": "SNOMED",
        "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
        "domain_id": "Condition",
        "concept_class_id": "Clinical Finding",
        "standard_concept": "S",
        "valid_start_date": "1970-01-01",
        "valid_end_date": "2099-12-31",
        "invalid_reason": null,
        "search_score": 0.843
      },
      {
        "concept_id": 435216,
        "concept_name": "Diabetes mellitus type 2 in obese",
        "concept_code": "E11.0",
        "vocabulary_id": "ICD10CM",
        "vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
        "domain_id": "Condition",
        "concept_class_id": "4-char billing code",
        "standard_concept": null,
        "valid_start_date": "2015-10-01",
        "valid_end_date": "2099-12-31",
        "invalid_reason": null,
        "search_score": 0.786
      }
    ],
    "facets": {
      "vocabularies": [
        {"vocabulary_id": "SNOMED", "vocabulary_name": "SNOMED CT", "count": 45},
        {"vocabulary_id": "ICD10CM", "vocabulary_name": "ICD-10-CM", "count": 23},
        {"vocabulary_id": "ICD9CM", "vocabulary_name": "ICD-9-CM", "count": 12}
      ],
      "domains": [
        {"domain_id": "Condition", "domain_name": "Condition", "count": 67},
        {"domain_id": "Observation", "domain_name": "Observation", "count": 13}
      ],
      "concept_classes": [
        {"concept_class_id": "Clinical Finding", "concept_class_name": "Clinical Finding", "count": 45},
        {"concept_class_id": "4-char billing code", "concept_class_name": "4-char billing code", "count": 23}
      ],
      "years": [
        {"year": 1970, "count": 45},
        {"year": 2015, "count": 23}
      ]
    },
    "facet_status": {
      "partial": false,
      "failed_facets": []
    },
    "search_metadata": {
      "query_time_ms": 127,
      "total_results": 80,
      "max_relevance_score": 10,
      "search_algorithm": "full_text_with_ranking"
    }
  },
  "meta": {
    "request_id": "req_adv_search_abc123",
    "timestamp": "2024-01-15T10:30:00Z",
    "vocab_release": "2025.1",
    "search": {
      "query": "diabetes mellitus type 2",
      "total_results": 80,
      "filters_applied": {
        "vocabulary_ids": [],
        "domain_ids": [],
        "standard_concepts_only": false,
        "include_invalid": true
      }
    },
    "pagination": {
      "page": 1,
      "page_size": 10,
      "total_items": 80,
      "total_pages": 8,
      "has_next": true,
      "has_previous": false
    }
  }
}

curl -X POST "https://api.omophub.com/v1/search/advanced" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "hypertension",
    "vocabulary_ids": ["SNOMED", "ICD10CM"],
    "domain_ids": ["Condition"],
    "standard_concepts_only": true,
    "date_range": {
      "start_date": "2020-01-01",
      "end_date": "2024-12-31"
    },
    "page_size": 20
  }'

results = client.search.advanced_search(
    query="hypertension",
    vocabulary_ids=["SNOMED", "ICD10CM"],
    domain_ids=["Condition"],
    standard_concepts_only=True,
    date_range={
        "start_date": "2020-01-01",
        "end_date": "2024-12-31"
    },
    page_size=20
)

print(f"Found {results.meta.pagination.total_items} concepts")
print(f"Query executed in {results.data.search_metadata.query_time_ms}ms")

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

const client = new OMOPHub();
const { data: results, meta } = await client.search.advanced({
  query: 'hypertension',
  vocabularyIds: ['SNOMED', 'ICD10CM'],
  domainIds: ['Condition'],
  standardConceptsOnly: true,
  dateRange: {
    startDate: '2020-01-01',
    endDate: '2024-12-31',
  },
  pageSize: 20,
});

console.log(`Found ${meta?.pagination?.total_items} concepts`);

results <- advanced_search_concepts(client,
  query = "hypertension",
  vocabulary_ids = c("SNOMED", "ICD10CM"),
  domain_ids = c("Condition"),
  standard_concepts_only = TRUE,
  date_range = list(
    start_date = "2020-01-01",
    end_date = "2024-12-31"
  ),
  page_size = 20
)

cat(paste("Found", results$meta$pagination$total_items, "concepts\n"))
cat(paste("Query executed in", results$data$search_metadata$query_time_ms, "ms\n"))

curl -X POST "https://api.omophub.com/v1/search/advanced" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "insulin",
    "vocabulary_ids": ["RxNorm"],
    "domain_ids": ["Drug"],
    "relationship_filters": [
      {
        "relationship_id": "RxNorm has dose form",
        "target_concept_id": 19127776,
        "direction": "forward"
      }
    ],
    "concept_class_ids": ["Clinical Drug"],
    "page_size": 15
  }'

results = client.search.advanced_search(
    query="insulin",
    vocabulary_ids=["RxNorm"],
    domain_ids=["Drug"],
    relationship_filters=[
        {
            "relationship_id": "RxNorm has dose form",
            "target_concept_id": 19127776,
            "direction": "forward"
        }
    ],
    concept_class_ids=["Clinical Drug"],
    page_size=15
)

for concept in results.data:
    print(f"Drug: {concept.concept_name}")
    print(f"  Code: {concept.concept_code}")
    print(f"  Class: {concept.concept_class_id}")

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

const client = new OMOPHub();
const { data: results } = await client.search.advanced({
  query: 'insulin',
  vocabularyIds: ['RxNorm'],
  domainIds: ['Drug'],
  relationshipFilters: [
    {
      relationship_id: 'RxNorm has dose form',
      target_concept_id: 19127776,
      direction: 'forward',
    },
  ],
  conceptClassIds: ['Clinical Drug'],
  pageSize: 15,
});

results.data.forEach(concept => {
  console.log(`Drug: ${concept.concept_name}`);
  console.log(`  Code: ${concept.concept_code}`);
  console.log(`  Class: ${concept.concept_class_id}`);
});

results <- advanced_search_concepts(client,
  query = "insulin",
  vocabulary_ids = c("RxNorm"),
  domain_ids = c("Drug"),
  relationship_filters = list(
    list(
      relationship_id = "RxNorm has dose form",
      target_concept_id = 19127776,
      direction = "forward"
    )
  ),
  concept_class_ids = c("Clinical Drug"),
  page_size = 15
)

for (i in 1:nrow(results$data$concepts)) {
  concept <- results$data$concepts[i, ]
  cat(paste("Drug:", concept$concept_name), "\n")
  cat(paste("  Code:", concept$concept_code), "\n")
  cat(paste("  Class:", concept$concept_class_id), "\n")
}