skills.rest
nguyenhungtran18
nguyenhungtran18COMMUNITY
Explore all skills by this author →
GitHub

clinical-trials-database

Query ClinicalTrials.gov API v2 to search, filter, and retrieve clinical trial records.

1|Updated Aug 31, 2026
Search Tags:#API#clinical trials#medical research#eligibility criteria#ClinicalTrials.gov#trial search#essie
One-click install
npx skills add https://github.com/nguyenhungtran18/skill-and-tool-tracker --skill clinical-trials-database-nguyenhungtran18
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clinical-trials-database
Source: https://github.com/nguyenhungtran18/skill-and-tool-tracker/tree/main/skills/clinical_trials_database
Command: npx skills add https://github.com/nguyenhungtran18/skill-and-tool-tracker --skill clinical-trials-database-nguyenhungtran18

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires polite-http, and includes scripts (resource) and references (resource) components.

What problem does it solve? Finding and analyzing clinical trial information on ClinicalTrials.gov requires constructing complex API queries and handling large JSON responses. This Skill wraps the ClinicalTrials.gov API v2 in a CLI that handles filtering, pagination, field selection, and rate limiting so you can search trials, check eligibility criteria, and count studies without writing raw API requests. ## Core Features & Use Cases - Filtered Trial Search: Search trials by condition, intervention, phase, recruitment status, age group, sponsor, and geography, with all filters combined via AND logic. - Trial Detail & Eligibility Retrieval: Fetch full study details by NCT ID or pull just the inclusion/exclusion criteria for patient-matching tasks. - Landscape Counting & Pagination: Count matching studies before fetching records and iterate large result sets with page tokens. - Use Case: A research coordinator needs recruiting Phase 3 pediatric cystic fibrosis trials in New York. Run one search command with condition, phase, age-group, status, and location filters to get a compact JSON list of matching NCT IDs and titles. ## Quick Start Ask the AI to find currently recruiting Phase 3 trials for a specific condition using the clinical trials database skill and save the results to a JSON file.

Frequently Asked Questions about clinical-trials-database

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search ClinicalTrials.gov for trials by condition and phase?▼

Run the search command with --condition for the disease and --phase for the trial phase, such as PHASE3. Add --status RECRUITING and --fields to limit the response to fields like NCTId, BriefTitle, and OverallStatus.

How to get eligibility criteria for a clinical trial by NCT ID?▼

Use the get-eligibility command followed by the NCT ID and an --output path. It returns the trial title plus the full eligibility module, including inclusion and exclusion criteria, age range, and sex requirements.

Can I filter clinical trials by country or city?▼

Yes, use the --advanced flag with an Essie AREA expression such as AREA[LocationCountry]United States or AREA[LocationCity]New York. This combines with other filters like condition and status via AND logic.

Why should I use --fields when querying the ClinicalTrials.gov API?▼

Trial JSON records can be very large, so --fields restricts the response to only the data points you need, such as NCTId and BriefTitle. This keeps outputs small and avoids loading unnecessary data into context.

How do I handle pagination for large clinical trial search results?▼

Set --limit for page size and include --count-total to see total matches. When the response contains a nextPageToken, pass it verbatim with --page-token to fetch the next page of results.

What are the limitations of the ClinicalTrials.gov API v2 CLI?▼

The wrapper enforces a 1 request-per-second rate limit and returns at most 1000 records per page. Filters not covered by dedicated flags require raw Essie expressions via --advanced or the raw-query escape hatch.

Related Skills

Explore More Education & Research Skills→
omar-A-hassanomar-A-hassan
18

pubmed

Search PubMed for biomedical papers and retrieve abstracts, PMIDs, and MeSH terms.

Community
Basic
maziyarpanahimaziyarpanahi
5.0k

searching-clinicaltrials

Find ClinicalTrials.gov studies by condition, intervention, and recruitment status.

Community
Advanced
0xmariowu0xmariowu
40

pubmed

Queries PubMed biomedical literature and returns structured evidence summaries with DOI or page URLs.

Community
Intermediate
ClawBioClawBio
1.1k

clinical-trial-finder

Find clinical trials by gene, variant, or condition from ClinicalTrials.gov with FHIR R4 output.

Official
Advanced