Clinicaltrials Search Studies
clinicaltrials_search_studiesRead-onlyIdempotent
Search ClinicalTrials.gov for medical studies by condition, intervention, or location. Filter results by recruitment status, trial phase, and geography, select specific data fields to reduce payload size, and paginate through matches.
Instructions
Search for clinical trial studies from ClinicalTrials.gov. Supports full-text and field-specific queries, status/phase/geographic filters, pagination, sorting, and field selection. Use the fields parameter to reduce payload size — full study records are ~70KB each.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | General full-text search across all fields. | |
| conditionQuery | No | Condition/disease-specific search. E.g., "Type 2 Diabetes", "non-small cell lung cancer". | |
| interventionQuery | No | Intervention/treatment search. E.g., "pembrolizumab", "cognitive behavioral therapy". | |
| locationQuery | No | Location search — city, state, country, or facility name. | |
| sponsorQuery | No | Sponsor/collaborator name search. | |
| titleQuery | No | Search within study titles and acronyms only. | |
| outcomeQuery | No | Search within outcome measure fields. | |
| statusFilter | No | Filter by study status. Values: RECRUITING, COMPLETED, ACTIVE_NOT_RECRUITING, NOT_YET_RECRUITING, ENROLLING_BY_INVITATION, SUSPENDED, TERMINATED, WITHDRAWN, UNKNOWN, WITHHELD, NO_LONGER_AVAILABLE, AVAILABLE, APPROVED_FOR_MARKETING, TEMPORARILY_NOT_AVAILABLE. | |
| phaseFilter | No | Filter by trial phase. Values: EARLY_PHASE1, PHASE1, PHASE2, PHASE3, PHASE4, NA. | |
| advancedFilter | No | Advanced filter using AREA[] Essie syntax. E.g., "AREA[StudyType]INTERVENTIONAL", "AREA[EnrollmentCount]RANGE[100, 1000]". Combine with AND/OR/NOT and parentheses. | |
| geoFilter | No | Geographic proximity filter. Format: distance(lat,lon,radius). E.g., "distance(47.6062,-122.3321,50mi)" for studies within 50 miles of Seattle. | |
| nctIds | No | Filter to specific NCT IDs for batch lookups. | |
| fields | No | Fields to return (PascalCase piece names). Strongly recommended to reduce payload. Common: NCTId, BriefTitle, OverallStatus, Phase, LeadSponsorName, Condition, InterventionName, BriefSummary, EnrollmentCount, StartDate. | |
| sort | No | Sort order. Format: FieldName:asc or FieldName:desc. E.g., "LastUpdatePostDate:desc", "EnrollmentCount:desc". Max 2 fields comma-separated. | |
| pageSize | No | Results per page, 1–200. | |
| pageToken | No | Pagination cursor from a previous response. | |
| countTotal | No | Include total study count in response. Only computed on the first page. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| studies | Yes | Matching studies. | |
| totalCount | No | Total matching studies (first page only when countTotal=true). | |
| nextPageToken | No | Token for the next page. Absent on last page. | |
| searchCriteria | No | Echo of query/filter criteria used. Present when results are empty. | |
| noMatchHints | No | Suggestions for broadening the search when no results are found. |