Metadata-Version: 2.4
Name: citedhealth
Version: 0.2.0
Summary: Python client for the CITED Health evidence-based supplement API
Project-URL: Homepage, https://citedhealth.com
Project-URL: Documentation, https://citedhealth.com/developers/
Project-URL: Repository, https://github.com/citedhealth/citedhealth-python
Project-URL: API Reference, https://citedhealth.com/api/openapi.json
Author-email: "Cited Health Inc." <dev@citedhealth.com>
License-Expression: MIT
License-File: LICENSE
Keywords: api-client,evidence,health,pubmed,supplements
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Healthcare Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Description-Content-Type: text/markdown

# citedhealth

[![PyPI](https://img.shields.io/pypi/v/citedhealth)](https://pypi.org/project/citedhealth/)
[![Python](https://img.shields.io/pypi/pyversions/citedhealth)](https://pypi.org/project/citedhealth/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

Python client for the [CITED Health](https://citedhealth.com) 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](https://citedhealth.com)** — evidence grades for supplements like Biotin, Melatonin, and Ashwagandha.

## Table of Contents

- [Install](#install)
- [Quick Start](#quick-start)
- [What You Can Do](#what-you-can-do)
- [Evidence Grades](#evidence-grades)
- [API Reference](#api-reference)
- [Also Available](#also-available)
- [License](#license)

## Install

```bash
pip install citedhealth
```

## Quick Start

```python
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/](https://citedhealth.com/developers/)

## Also Available

| Platform | Package | Install |
|----------|---------|---------|
| **npm** | `citedhealth` | `npm install citedhealth` |
| **MCP** | `citedhealth-mcp` | `uvx citedhealth-mcp` |

## License

MIT — see [LICENSE](LICENSE).
