Check the setup
- Python 3.10 or newer
- A notebook environment such as Jupyter or Google Colab
- An internet connection
Registered clinical study protocols, locations, recruitment states, and results for building trial finders and research-monitoring tools.
From source to product signal
ClinicalTrials.gov contains sponsor-submitted study protocols, recruitment states, locations, and results. Start with one condition, one country, and recruiting studies. Registration does not independently verify a study's claims, and locations, contacts, and results may be missing or outdated.
Install the packages, then run the notebook cell.
python -m pip install pandas requests
import pandas as pd
import requests
response = requests.get(
"https://clinicaltrials.gov/api/v2/studies",
params={
"query.cond": "asthma",
"filter.overallStatus": "RECRUITING",
"format": "json",
"pageSize": 50,
},
timeout=30,
)
response.raise_for_status()
studies = pd.json_normalize(response.json()["studies"])
columns = [
"protocolSection.identificationModule.nctId",
"protocolSection.identificationModule.briefTitle",
"protocolSection.statusModule.overallStatus",
]
print(studies[columns].head(20))Test a useful signal
Identify recruiting asthma studies and review whether they list usable locations.
U.S. National Library of Medicine is a government source. Last verified 2026-08-13. Temporal coverage: 2000-present.