clinicaltrials_analyze_trends
Analyze clinical trial trends by aggregating data based on status, country, sponsor, or phase. Filter studies using specific parameters to refine insights and support data-driven decision-making.
Instructions
Performs a statistical analysis on a set of clinical trials, aggregating data by status, country, sponsor, or phase. Use specific query parameters to refine the analysis and filter the studies included in the analysis. The tool can handle up to 5000 studies per analysis.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| analysisType | Yes | A single analysis type or an array of types to perform on the study set. | |
| filter | No | A set of filters that narrow the search results without affecting ranking. | |
| query | No | A set of search terms that influence result ranking. |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"analysisType": {
"anyOf": [
{
"enum": [
"countByStatus",
"countByCountry",
"countBySponsorType",
"countByPhase"
],
"type": "string"
},
{
"items": {
"$ref": "#/properties/analysisType/anyOf/0"
},
"minItems": 1,
"type": "array"
}
],
"description": "A single analysis type or an array of types to perform on the study set."
},
"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"
},
"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"
}
},
"required": [
"analysisType"
],
"type": "object"
}