clinicaltrials_search_studies
Search and filter clinical studies by conditions, interventions, locations, statuses, or IDs. Retrieve sorted, paginated results with specific fields for targeted research on ClinicalTrials.gov.
Instructions
Searches for clinical studies using a combination of query terms and filters. Supports pagination, sorting, and geographic filtering.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fields | No | A list of specific top-level fields to include in the response. | |
| filter | No | A set of filters that narrow the search results without affecting ranking. | |
| pageSize | No | The number of studies to return per page (1-200). Defaults to 10. | |
| pageToken | No | A token used to retrieve the next page of results. | |
| query | No | A set of search terms that influence result ranking. | |
| sort | No | Specify the sort order for the results. |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"fields": {
"description": "A list of specific top-level fields to include in the response.",
"items": {
"type": "string"
},
"type": "array"
},
"filter": {
"additionalProperties": false,
"description": "A set of filters that narrow the search results without affecting ranking.",
"properties": {
"advanced": {
"description": "Apply an advanced filter using Essie expression syntax.",
"type": "string"
},
"geo": {
"additionalProperties": false,
"description": "Filter results to a geographic area by providing a point and radius.",
"properties": {
"latitude": {
"maximum": 90,
"minimum": -90,
"type": "number"
},
"longitude": {
"maximum": 180,
"minimum": -180,
"type": "number"
},
"radius": {
"exclusiveMinimum": 0,
"type": "number"
},
"unit": {
"default": "km",
"enum": [
"km",
"mi"
],
"type": "string"
}
},
"required": [
"latitude",
"longitude",
"radius"
],
"type": "object"
},
"ids": {
"description": "Return only studies with the specified NCT IDs.",
"items": {
"type": "string"
},
"type": "array"
},
"overallStatus": {
"description": "Filter results by one or more study statuses.",
"items": {
"enum": [
"ACTIVE_NOT_RECRUITING",
"COMPLETED",
"ENROLLING_BY_INVITATION",
"NOT_YET_RECRUITING",
"RECRUITING",
"SUSPENDED",
"TERMINATED",
"WITHDRAWN",
"UNKNOWN"
],
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"pageSize": {
"default": 10,
"description": "The number of studies to return per page (1-200). Defaults to 10.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"pageToken": {
"description": "A token used to retrieve the next page of results.",
"type": "string"
},
"query": {
"additionalProperties": false,
"description": "A set of search terms that influence result ranking.",
"properties": {
"cond": {
"description": "Search for conditions or diseases.",
"type": "string"
},
"id": {
"description": "Search for study identifiers (e.g., NCT ID).",
"type": "string"
},
"intr": {
"description": "Search for specific interventions or treatments.",
"type": "string"
},
"locn": {
"description": "Search for study locations.",
"type": "string"
},
"outc": {
"description": "Search for specific outcome measures.",
"type": "string"
},
"spons": {
"description": "Search for sponsors or collaborators.",
"type": "string"
},
"term": {
"description": "Search for other terms like interventions, outcomes, or sponsors.",
"type": "string"
},
"titles": {
"description": "Search within study titles or acronyms.",
"type": "string"
}
},
"type": "object"
},
"sort": {
"description": "Specify the sort order for the results.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
}