43-wentorai-research-plugins-skills-domains-biomedical-clinicaltrials-api

brycewang-stanford/Auto-Empirical-Research-SkillsBiology Medicine and BioinformaticsAudit pendingSnapshot 02b9fdb012e5

Summary

This source did not publish a separate summary. Review SKILL.md before using the skill.

SKILL.md

ClinicalTrials API Guide

Overview

ClinicalTrials.gov is a registry and results database of publicly and privately supported clinical studies conducted around the world, maintained by the U.S. National Library of Medicine (NLM) at the National Institutes of Health (NIH). It contains registration records for over 500,000 clinical trials from more than 220 countries, making it the largest and most comprehensive clinical trial registry in the world.

The ClinicalTrials.gov API provides programmatic access to this vast repository of clinical trial data. Researchers can search for trials by condition, intervention, sponsor, location, phase, status, and many other criteria. The API returns detailed structured data including study design, eligibility criteria, outcome measures, enrollment information, study contacts, and results when available.

Clinical researchers, pharmaceutical companies, systematic reviewers, epidemiologists, public health officials, patient advocacy groups, and health policy analysts use the ClinicalTrials.gov API to monitor the clinical trial landscape, identify recruiting studies, conduct meta-analyses, analyze research trends, and ensure comprehensive evidence coverage in systematic reviews. The database is a critical resource for evidence-based medicine and regulatory compliance.

Authentication

No authentication required. The ClinicalTrials.gov API is freely accessible without any API key, token, or registration. All endpoints are publicly available. Users are expected to comply with the NCBI usage policies and make requests at a reasonable rate.

Core Endpoints

query/full_studies: Search Clinical Trials

Search the ClinicalTrials.gov database and retrieve full study records with comprehensive metadata about trial design, eligibility, interventions, and outcomes.

URL: GET https://clinicaltrials.gov/api/v2/studies
Parameters:

Parameter	Type	Required	Description

# Search for recruiting cancer immunotherapy trials
curl "https://clinicaltrials.gov/api/v2/studies?query.cond=cancer&query.intr=immunotherapy&filter.overallStatus=RECRUITING&pageSize=5"

# Search by sponsor
curl "https://clinicaltrials.gov/api/v2/studies?query.spons=NIH&filter.phase=PHASE3&pageSize=10"

Parameter	Type	Required	Description
nctId	string	Yes	NCT identifier (e.g., `NCT04280705`)

curl "https://clinicaltrials.gov/api/v2/studies/NCT04280705"

import requests

params = {
    "query.cond": "Alzheimer's Disease",
    "filter.overallStatus": "RECRUITING",
    "filter.phase": "PHASE3",
    "pageSize": 20
}
resp = requests.get("https://clinicaltrials.gov/api/v2/studies", params=params)
data = resp.json()

print(f"Found {data['totalCount']} recruiting Phase 3 Alzheimer's trials\n")
for study in data["studies"]:
    proto = study["protocolSection"]
    ident = proto["identificationModule"]
    status = proto["statusModule"]
    print(f"{ident['nctId']}: {ident['briefTitle']}")
    print(f"  Status: {status['overallStatus']}")
    print(f"  Start: {status.get('startDateStruct', {}).get('date', 'N/A')}")
    print()

import requests

all_studies = []
page_token = None

while True:
    params = {
        "query.cond": "type 2 diabetes",
        "query.intr": "metformin",
        "filter.overallStatus": "COMPLETED",
        "pageSize": 100
    }
    if page_token:
        params["pageToken"] = page_token

    resp = requests.get("https://clinicaltrials.gov/api/v2/studies", params=params)
    data = resp.json()
    all_studies.extend(data["studies"])

    page_token = data.get("nextPageToken")
    if not page_token:
        break

print(f"Total completed metformin trials for T2D: {len(all_studies)}")

import requests
from collections import Counter

params = {
    "query.cond": "COVID-19",
    "filter.phase": "PHASE3",
    "pageSize": 100
}
resp = requests.get("https://clinicaltrials.gov/api/v2/studies", params=params)
data = resp.json()

sponsors = Counter()
for study in data["studies"]:
    org = study["protocolSection"]["identificationModule"].get("organization", {})
    sponsors[org.get("fullName", "Unknown")] += 1

print("Top sponsors of Phase 3 COVID-19 trials:")
for sponsor, count in sponsors.most_common(10):
    print(f"  {sponsor}: {count} trials")

43-wentorai-research-plugins-skills-domains-biomedical-clinicaltrials-api

Summary

SKILL.md

ClinicalTrials API Guide

Overview

Authentication

Core Endpoints

query/full_studies: Search Clinical Trials

Single Study Retrieval

Rate Limits

Common Patterns

Monitor Recruiting Trials for a Condition

Systematic Review: Comprehensive Trial Search

Analyze Trial Characteristics

References

Related skills

query.term	string	No	Free-text search query across all fields
query.cond	string	No	Condition or disease filter
query.intr	string	No	Intervention or treatment filter
query.spons	string	No	Sponsor or collaborator filter
filter.overallStatus	string	No	Status filter: `RECRUITING`, `COMPLETED`, `ACTIVE_NOT_RECRUITING`
filter.phase	string	No	Phase filter: `PHASE1`, `PHASE2`, `PHASE3`, `PHASE4`
filter.geo	string	No	Geographic filter (distance:lat,lng)
sort	string	No	Sort field and direction
pageSize	int	No	Results per page (default 10, max 1000)
pageToken	string	No	Token for next page of results
format	string	No	Response format: `json` (default) or `csv`