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

• OpenEvidence API Docs

Next Steps

See openevidence-local-dev-loop.