citedhealth

gem "citedhealth"

require "citedhealth"

client = CitedHealth::Client.new

# Search for ingredients related to hair health
ingredients = client.search_ingredients(query: "biotin")
puts ingredients.first.name        # => "Biotin"
puts ingredients.first.category    # => "Vitamins"

# Get detailed ingredient information
vitamin_d = client.get_ingredient("vitamin-d")
puts vitamin_d.mechanism           # => "Fat-soluble vitamin..."
puts vitamin_d.recommended_dosage  # => {"general" => "1000-4000 IU"}

# Look up evidence linking an ingredient to a condition
evidence = client.get_evidence(
  ingredient_slug: "vitamin-d",
  condition_slug: "nutritional-deficiency-hair-loss"
)
puts evidence.grade        # => "B"
puts evidence.grade_label  # => "Good"
puts evidence.summary      # => "Moderate evidence supports..."

# Search research papers from PubMed
papers = client.search_papers(query: "melatonin sleep", year: 2024)
puts papers.first.title    # Paper title
puts papers.first.journal  # Journal name

client = CitedHealth::Client.new

# Search by keyword — returns matching ingredients
results = client.search_ingredients(query: "vitamin", category: "Vitamins")
results.each { |i| puts "#{i.name} (#{i.category})" }

# Get a specific ingredient with full details
magnesium = client.get_ingredient("magnesium")
puts magnesium.mechanism           # "Essential mineral cofactor..."
puts magnesium.recommended_dosage  # {"general" => "200-400mg"}
puts magnesium.forms               # ["Glycinate", "Citrate", ...]

client = CitedHealth::Client.new

# Get evidence for a specific ingredient-condition pair
evidence = client.get_evidence(
  ingredient_slug: "melatonin",
  condition_slug: "insomnia"
)
puts "Grade #{evidence.grade}: #{evidence.total_studies} studies"
# Grade A: 15 studies

# Evidence includes direction of effect
puts evidence.direction    # "positive" | "negative" | "neutral" | "mixed"
puts evidence.summary      # Human-readable summary

# Fetch by ID if you already know it
ev = client.get_evidence_by_id(42)
puts "#{ev.ingredient.name} for #{ev.condition.name}"

client = CitedHealth::Client.new

# Search papers by title/abstract keyword
papers = client.search_papers(query: "collagen skin")
papers.each do |paper|
  # Each paper includes PMID, journal, citation count, open access status
  puts "[PMID #{paper.pmid}] #{paper.title} (#{paper.publication_year})"
  puts "  #{paper.citation_count} citations — #{paper.pubmed_link}"
end

# Filter by publication year
recent = client.search_papers(query: "ashwagandha", year: 2025)

# Fetch a specific paper by PubMed ID
paper = client.get_paper("12345678")
puts paper.journal     # Journal name
puts paper.study_type  # "RCT", "Meta-Analysis", etc.

begin
  client.get_ingredient("nonexistent")
rescue CitedHealth::NotFoundError => e
  puts "Not found: #{e.message}"
rescue CitedHealth::RateLimitError => e
  puts "Rate limited. Retry after #{e.retry_after} seconds"
rescue CitedHealth::Error => e
  puts "API error: #{e.message}"
end

# Default client
client = CitedHealth::Client.new

# Custom base URL and timeout
client = CitedHealth::Client.new(
  base_url: "https://citedhealth.com",
  timeout: 30
)