Skills Data Science OpenEvidence Clinical API Examples

OpenEvidence Clinical API Examples

v20260423
openevidence-hello-world
This module provides minimal working examples for the OpenEvidence API, designed for clinical intelligence applications. Users can perform complex clinical queries to get treatment recommendations, check potential drug interactions based on patient context, and search for authoritative medical guidelines from major health organizations (e.g., ACC/AHA). Ideal for developing evidence-based healthcare decision support systems.
Get Skill
260 downloads
Overview

OpenEvidence Hello World

Overview

Minimal working examples demonstrating core OpenEvidence API functionality.

Instructions

Step 1: Clinical Query

const result = await client.query({
  question: 'What is the recommended treatment for acute migraine in adults?',
  context: 'emergency_department',
  evidence_level: 'high',  // Filter by evidence quality
  max_citations: 10
});

console.log('Answer:', result.answer);
console.log('Confidence:', result.confidence);
result.citations.forEach(c =>
  console.log(`  [${c.journal}] ${c.title} (${c.year}) — ${c.evidence_level}`)
);

Step 2: Drug Interaction Check

const interactions = await client.interactions.check({
  medications: ['metformin', 'lisinopril', 'atorvastatin'],
  patient_context: { age: 65, conditions: ['diabetes', 'hypertension'] }
});

interactions.forEach(i =>
  console.log(`${i.drug1} + ${i.drug2}: ${i.severity} — ${i.description}`)
);

Step 3: Guideline Lookup

const guidelines = await client.guidelines.search({
  condition: 'hypertension',
  source: ['ACC/AHA', 'ESC'],
  year_min: 2023
});
guidelines.forEach(g =>
  console.log(`${g.source}: ${g.title} (${g.year})`)
);

Error Handling

Error Cause Solution
Auth error Invalid credentials Check OPENEVIDENCE_API_KEY
Not found Invalid endpoint Verify API URL
Rate limit Too many requests Implement backoff

Resources

Next Steps

See openevidence-local-dev-loop.

Info
Category Data Science
Name openevidence-hello-world
Version v20260423
Size 1.93KB
Updated At 2026-04-28
Language