clinicaltrials-database

Query ClinicalTrials.gov API v2 for trial data by condition, intervention, location, or status.

1|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/SciMate-AI/scicli --skill clinicaltrials-database-scimate-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clinicaltrials-database
Source: https://github.com/SciMate-AI/scicli/tree/main/internal/skills/bundled/claude-scientific-skills/skills/clinicaltrials-database
Command: npx skills add https://github.com/SciMate-AI/scicli --skill clinicaltrials-database-scimate-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

ClinicalTrials.gov API v2 provides centralized access to trial data; this skill enables researchers to programmatically search trials by condition, drug/intervention, location, sponsor, or status, and retrieve detailed results for integration into analyses and patient-matching pipelines.

Core Features & Use Cases

  • Search by Condition/Disease: Find trials matching medical conditions of interest.
  • Search by Intervention/Drug: Identify trials testing specific treatments.
  • Geographic and Sponsor Filters: Locate trials by location and sponsoring institutions.
  • Retrieve Detailed Study Information: Access eligibility, locations, contacts, and outcomes for a given NCT ID.
  • Data Export: Export results in JSON or CSV formats for downstream analysis and reporting.
  • Pagination and Bulk Retrieval: Efficiently handle large result sets with controlled paging.

Quick Start

Run the helper script in scripts/query_clinicaltrials.py to search trials by condition and export the results.

Frequently Asked Questions about clinicaltrials-database

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

FAQPage Schema
How do I query clinical trial data from ClinicalTrials.gov using Python?

Filter active clinical trials by passing the filter.overallStatus parameter to the ClinicalTrials.gov API v2 endpoint. You can retrieve and export trials matching specific recruitment statuses directly to JSON or CSV formats.

Does the ClinicalTrials.gov API require authentication to search trial summaries?

No authentication is required for public API access to search ClinicalTrials.gov trial summaries. You can query conditions, interventions, sponsors, and locations freely using the v2 studies endpoint.

Can I export clinical trial search results to CSV?

Yes, you can export clinical trial search results to CSV format. The query script supports both JSON and CSV data export formats, allowing you to retrieve trial summaries and integrate them into downstream reporting workflows.

What's the best way to handle large result sets when retrieving clinical trials?

Handle large clinical trial result sets by using controlled pagination with the pageSize parameter and pageToken returned in the JSON response. This allows efficient bulk retrieval of trial data without missing records.

How do I find clinical trials by location and sponsoring institution?

Find clinical trials by location and sponsor by using the query.locn and query.sponsor parameters in your ClinicalTrials.gov API v2 request. This filters trial data to specific geographic regions and sponsoring institutions.