citedhealth 0.2.0

Python client for the CITED Health evidence-based supplement API

citedhealth

Python client for the CITED Health evidence-based supplement API. Query 74 ingredients, 30 conditions, 152 evidence links, and 2,881 PubMed papers — every health claim backed by peer-reviewed research.

Try it live at citedhealth.com — evidence grades for supplements like Biotin, Melatonin, and Ashwagandha.

Table of Contents

• Install
• Quick Start
• What You Can Do
• Evidence Grades
• API Reference
• Also Available
• License

Install

pip install citedhealth

Quick Start

from citedhealth import CitedHealth

client = CitedHealth()

# Search ingredients
ingredients = client.search_ingredients("biotin")
print(ingredients[0].name)  # "Biotin"

# Get evidence grade
evidence = client.get_evidence("biotin", "hair-loss")
print(f"Grade: {evidence.grade} — {evidence.grade_label}")
# Grade: A — Strong Evidence

# Search PubMed papers
papers = client.search_papers("biotin hair loss")
print(f"{len(papers)} papers found")

What You Can Do

Search Supplement Ingredients

Find ingredients by name or keyword. Each ingredient includes category, mechanism of action, recommended dosage, and available forms.

Look Up Evidence Grades

Every ingredient-condition pair has an A-F evidence grade calculated from peer-reviewed studies:

Grade	Label	Criteria
A	Strong Evidence	Multiple RCTs/meta-analyses, consistent positive results
B	Good Evidence	At least one RCT, mostly consistent
C	Some Evidence	Small studies, some positive signals
D	Very Early Research	In vitro, case reports, pilot studies
F	Evidence Against	<30% of studies show positive effects

Search PubMed Papers

Access 2,881 indexed papers with citation data from Semantic Scholar.

API Reference

Method	Description
search_ingredients(query)	Search ingredients by name
get_ingredient(slug)	Get ingredient by slug
get_evidence(ingredient, condition)	Get evidence links
get_evidence_by_id(pk)	Get evidence link by ID
search_papers(query)	Search papers
get_paper(pmid)	Get paper by PubMed ID

Full API documentation: citedhealth.com/developers/

Also Available

Platform	Package	Install
npm	citedhealth	npm install citedhealth
MCP	citedhealth-mcp	uvx citedhealth-mcp

License

MIT — see LICENSE.