Metadata-Version: 2.4
Name: clinical-trials-gov
Version: 1.0.0
Summary: Python client for the ClinicalTrials.gov API v2. Search recruiting trials by condition, location, and status.
License: MIT
Project-URL: Homepage, https://hellostudys.com
Project-URL: Repository, https://github.com/neverpeakev/clinical-trials-open-data
Project-URL: Documentation, https://github.com/neverpeakev/clinical-trials-open-data#readme
Project-URL: Bug Tracker, https://github.com/neverpeakev/clinical-trials-open-data/issues
Keywords: clinical-trials,clinicaltrials-gov,medical,health,api,healthcare
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Healthcare Industry
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# clinical-trials-gov

Python client for the [ClinicalTrials.gov API v2](https://clinicaltrials.gov/data-api/api). Zero dependencies.

## Install

```bash
pip install clinical-trials-gov
```

## Usage

```python
from clinical_trials_gov import fetch_trials, get_study, search_trials

# Find recruiting breast cancer trials
data = fetch_trials(condition="breast cancer")
print(f"Found {len(data['studies'])} trials")

# Find trials in a specific city
local = fetch_trials(condition="diabetes", location="New York")

# Get a specific study
study = get_study("NCT05382442")

# Free-text search
results = search_trials("immunotherapy lung cancer")
```

### Using the client class

```python
from clinical_trials_gov import ClinicalTrialsClient

client = ClinicalTrialsClient()
data = client.fetch_trials(condition="psoriasis", location="Boston")
```

## See Also

- [HelloStudys](https://hellostudys.com) — Free AI-powered clinical trial matching for patients
- [ClinicalTrials.gov](https://clinicaltrials.gov/) — Official registry
- [awesome-clinical-trials](https://github.com/neverpeakev/awesome-clinical-trials) — Curated resource list

## License

MIT
