# ClinicalTrials.gov Scraper (`solidcode/clinicaltrials-gov-scraper`) Actor

\[💰 $2.5 / 1K] Extract clinical trials from ClinicalTrials.gov: titles, conditions, interventions, sponsors, status, phase, eligibility, locations, dates, and results. Search by condition, treatment, sponsor, or location.

- **URL**: https://apify.com/solidcode/clinicaltrials-gov-scraper.md
- **Developed by:** [SolidCode](https://apify.com/solidcode) (community)
- **Categories:** Automation, Developer tools, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## ClinicalTrials.gov Scraper

Pull complete study records from ClinicalTrials.gov at scale — titles, sponsors, conditions, interventions, eligibility criteria, every trial site, outcome measures, and registry dates, structured into one clean row per trial. Search the full 587,000+ -study US registry by condition, treatment, sponsor, or location, or fetch exact trials by NCT ID. Built for medical researchers, pharma competitive-intelligence teams, and patient-recruitment analysts who need a structured clinical-trials dataset without copying records off the registry one page at a time.

### Why This Scraper?

- **Covers the entire 587,000+ -study registry** — search every interventional, observational, and expanded-access trial ClinicalTrials.gov holds, or pull the whole database in one run with `maxResults: 0`.
- **Filter across all 14 recruitment statuses** — Recruiting, Not yet recruiting, Enrolling by invitation, Active not recruiting, Completed, Suspended, Terminated, Withdrawn, and six more, shown as plain-English labels instead of raw registry codes.
- **Six-bucket phase filter including NA** — Early Phase 1 through Phase 4, plus the Not-applicable bucket that captures observational and behavioral studies most tools miss.
- **Five free-text search axes that combine** — keyword, condition, treatment/intervention, sponsor, and location work together to narrow a search instead of forcing one query box.
- **Full eligibility detail on every trial** — minimum and maximum age, eligible sex, healthy-volunteer flag, and the complete inclusion/exclusion criteria text.
- **Every trial site, not just a count** — facility name, city, state, ZIP, country, and per-site recruitment status for each location, plus enrollment count.
- **Primary and secondary outcome measures** — each with its measure name, description, and time frame, alongside official + brief titles, lead sponsor, sponsor class, and collaborating organizations.
- **Direct fetch by NCT ID or study URL** — paste known trials (e.g. `NCT04368728`) to skip search and pull exact records, with results-availability flag on each.

### Use Cases

**Medical & Academic Research**
- Build structured datasets for systematic reviews and meta-analyses
- Track every trial for a condition across phase, sponsor, and status
- Capture full inclusion/exclusion criteria for evidence synthesis
- Pull primary and secondary outcome measures across a therapeutic area

**Pharma Competitive Intelligence**
- Monitor a competitor's pipeline by sponsor and phase
- Map the trial landscape for a drug, device, or mechanism of action
- Track new registrations sorted by most-recently-posted date
- Compare enrollment counts and collaborators across rival programs

**Patient Recruitment & CRO Operations**
- Find recruiting trials near a site by combining condition and location
- Filter to trials accepting healthy volunteers for early-phase recruitment
- Surface sites by facility, city, and state for feasibility outreach
- Identify Not-yet-recruiting trials to plan upcoming enrollment

**Investment & Market Due Diligence**
- Size a market by counting trials per condition, phase, and sponsor class
- Track a biotech's active programs and completion dates
- Flag trials with posted results for outcome-readiness signals
- Watch the most-recently-updated trials for pipeline movement

### Getting Started

#### Search by Condition

The simplest way to start — one disease and a result cap:

```json
{
    "condition": "breast cancer",
    "maxResults": 100
}
````

#### Recruiting Trials Near a Location

Combine a condition, a recruitment status, and a place:

```json
{
    "condition": "diabetes",
    "location": "Boston",
    "status": ["RECRUITING"],
    "maxResults": 200
}
```

#### Fetch Specific Trials by NCT ID

Already know the trials you want? Paste IDs or study URLs:

```json
{
    "studyUrls": [
        "NCT04368728",
        "https://clinicaltrials.gov/study/NCT04280705"
    ]
}
```

#### Full-Featured Search

Most filters populated, sorted by newest registration:

```json
{
    "searchTerm": "immunotherapy melanoma",
    "intervention": "pembrolizumab",
    "sponsor": "Merck",
    "status": ["RECRUITING", "ACTIVE_NOT_RECRUITING"],
    "studyType": ["INTERVENTIONAL"],
    "phase": ["PHASE2", "PHASE3"],
    "sex": "ALL",
    "sortBy": "first_posted",
    "maxResults": 500
}
```

### Input Reference

#### What to Search

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `searchTerm` | string | `""` | Free-text keyword search across the whole trial record (e.g. "immunotherapy melanoma"). |
| `condition` | string | `""` | Medical condition or disease studied (e.g. "diabetes", "breast cancer"). |
| `intervention` | string | `""` | Treatment, drug, device, or procedure being tested (e.g. "aspirin", "insulin"). |
| `sponsor` | string | `""` | Organization running the trial (e.g. "Pfizer", "National Cancer Institute"). |
| `location` | string | `""` | Where the trial takes place — a city, state, or country (e.g. "Boston", "Germany"). |

#### Or Fetch Specific Trials

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `studyUrls` | string\[] | `[]` | Study URLs or NCT IDs to fetch directly (e.g. `NCT04368728`). When set, the search filters are ignored. |

#### Filters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `status` | string\[] | `[]` | Recruitment status — choose any of 14 (Recruiting, Completed, Terminated, etc.). Empty includes every status. |
| `studyType` | string\[] | `[]` | Interventional, Observational, or Expanded access. Empty includes all types. |
| `phase` | string\[] | `[]` | Early Phase 1, Phase 1–4, or Not applicable. Empty includes all phases. |
| `sex` | select | `Any` | Eligible sex: Any, Female, or Male. |
| `healthyVolunteers` | boolean | `false` | When on, only trials that accept healthy volunteers. |

#### Output Options

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `sortBy` | select | `Best match (relevance)` | Order results by relevance, most recently updated, most recently posted, or largest enrollment. |
| `maxResults` | integer | `100` | Most trials to return. Set to `0` to return every matching trial (can be hundreds of thousands — use with care). |

### Output

Each row is one complete trial record. Here's a representative result:

```json
{
    "nctId": "NCT04368728",
    "briefTitle": "Study of a Candidate Vaccine Against COVID-19",
    "officialTitle": "A Phase 3, Randomized, Observer-Blind Study to Evaluate Efficacy of a Candidate Vaccine",
    "acronym": "COVE",
    "organization": "ModernaTX, Inc.",
    "overallStatus": "COMPLETED",
    "studyType": "INTERVENTIONAL",
    "phases": ["PHASE3"],
    "enrollmentCount": 30420,
    "leadSponsor": "ModernaTX, Inc.",
    "sponsorClass": "INDUSTRY",
    "collaborators": ["National Institute of Allergy and Infectious Diseases (NIAID)"],
    "conditions": ["COVID-19", "SARS-CoV-2 Infection"],
    "interventions": [
        { "type": "BIOLOGICAL", "name": "mRNA-1273", "description": "Two injections, 28 days apart" }
    ],
    "briefSummary": "This study evaluates the efficacy, safety, and immunogenicity of the candidate vaccine.",
    "sex": "ALL",
    "minimumAge": "18 Years",
    "maximumAge": null,
    "healthyVolunteers": true,
    "eligibilityCriteria": "Inclusion Criteria: Adults 18 years and older...",
    "startDate": "2020-07-27",
    "completionDate": "2022-10-20",
    "primaryCompletionDate": "2021-11-25",
    "firstPostedDate": "2020-04-30",
    "lastUpdatePostedDate": "2023-01-15",
    "locations": [
        { "facility": "Clinical Research Site", "city": "Atlanta", "state": "Georgia", "country": "United States", "status": "COMPLETED" }
    ],
    "primaryOutcomes": [
        { "measure": "Vaccine efficacy against COVID-19", "timeFrame": "Up to 2 years" }
    ],
    "secondaryOutcomes": [
        { "measure": "Number of participants with adverse events", "timeFrame": "Up to 28 days" }
    ],
    "hasResults": true,
    "url": "https://clinicaltrials.gov/study/NCT04368728",
    "scrapedAt": "2026-06-02T14:30:00Z"
}
```

#### Identity & Status

| Field | Type | Description |
|-------|------|-------------|
| `nctId` | string | NCT identifier (unique trial ID) |
| `briefTitle` | string | Short public title |
| `officialTitle` | string | Full official title |
| `acronym` | string | Study acronym |
| `organization` | string | Sponsoring organization name |
| `overallStatus` | string | Current recruitment status |
| `studyType` | string | Interventional, Observational, or Expanded access |
| `phases` | string\[] | Trial phase(s) |
| `url` | string | Public study page URL |
| `scrapedAt` | string | ISO timestamp of extraction |

#### Conditions, Interventions & Sponsors

| Field | Type | Description |
|-------|------|-------------|
| `conditions` | string\[] | Conditions or diseases studied |
| `interventions` | object\[] | Interventions — type, name, description, arm-group labels, and other names |
| `leadSponsor` | string | Lead sponsor name |
| `sponsorClass` | string | Sponsor class (NIH, INDUSTRY, OTHER, etc.) |
| `collaborators` | string\[] | Collaborating organizations |
| `enrollmentCount` | integer | Number of participants enrolled |

#### Eligibility & Description

| Field | Type | Description |
|-------|------|-------------|
| `sex` | string | Eligible sex (ALL, FEMALE, MALE) |
| `minimumAge` | string | Minimum eligible age (e.g. "18 Years") |
| `maximumAge` | string | Maximum eligible age |
| `healthyVolunteers` | boolean | Whether the trial accepts healthy volunteers |
| `eligibilityCriteria` | string | Full inclusion/exclusion criteria text |
| `briefSummary` | string | Brief plain-language summary |
| `detailedDescription` | string | Detailed description (when present) |

#### Locations & Outcomes

| Field | Type | Description |
|-------|------|-------------|
| `locations` | object\[] | Trial sites — facility, city, state, ZIP, country, and per-site status |
| `primaryOutcomes` | object\[] | Primary outcome measures — measure, description, time frame |
| `secondaryOutcomes` | object\[] | Secondary outcome measures — measure, description, time frame |
| `hasResults` | boolean | Whether study results have been posted |

#### Dates

| Field | Type | Description |
|-------|------|-------------|
| `startDate` | string | Study start date |
| `completionDate` | string | Study completion date |
| `primaryCompletionDate` | string | Primary completion date |
| `firstPostedDate` | string | Date first posted on the registry |
| `lastUpdatePostedDate` | string | Date last updated on the registry |

### Tips for Best Results

- **Start small** — set `maxResults` to 50–100 on your first run to confirm the data matches your needs, then scale up or set `0` for everything.
- **Combine condition and location to find recruiting trials near a site** — pair `condition`, `location`, and `status: ["RECRUITING"]` for ready-to-contact feasibility lists.
- **Use the Not-applicable phase to capture observational studies** — phase filters apply to interventional drug and biologic trials, so include `NA` (Not applicable) to keep observational and behavioral studies in your results.
- **Sort by most recently posted for pipeline monitoring** — `"sortBy": "first_posted"` surfaces brand-new registrations first, ideal for competitive-intelligence alerts.
- **Filter by sponsor class through the sponsor field** — search a funder name like "National Cancer Institute" to isolate government-funded work, or a pharma name to map an industry pipeline.
- **Skip search entirely for known trials** — paste NCT IDs into `studyUrls` to pull exact records; the search filters are ignored in that mode.
- **Layer filters to narrow large conditions** — broad terms like "cancer" return tens of thousands of trials, so add phase, status, or study-type filters to focus the dataset.

### Pricing

**From $2.5 per 1,000 results** — undercuts the going rate for full-registry clinical-trials extraction. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier.

| Results | No discount | Bronze | Silver | Gold |
|---------|-------------|--------|--------|------|
| 100 | $0.30 | $0.28 | $0.27 | $0.25 |
| 1,000 | $3.00 | $2.80 | $2.65 | $2.50 |
| 10,000 | $30.00 | $28.00 | $26.50 | $25.00 |
| 100,000 | $300.00 | $280.00 | $265.00 | $250.00 |

A "result" is any trial row in the output dataset. No compute or time-based charges — you pay per result, plus a small fixed per-run start fee.

### Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

- **Zapier** / **Make** / **n8n** — Workflow automation
- **Google Sheets** — Direct spreadsheet export
- **Slack** / **Email** — Notifications on new results
- **Webhooks** — Trigger custom workflows on run completion
- **Apify API** — Full programmatic access

### Legal & Ethical Use

ClinicalTrials.gov is a public information resource provided by the U.S. National Library of Medicine, and the trial records it holds are public U.S. government data. This actor is designed for legitimate medical research, competitive analysis, patient-recruitment, and due-diligence use. You are responsible for complying with applicable laws and the ClinicalTrials.gov terms of use. Always verify clinical details against the official record before relying on them for medical or regulatory decisions.

# Actor input Schema

## `searchTerm` (type: `string`):

Free-text search across the whole trial record. Example: 'immunotherapy melanoma'. Leave empty to browse without a keyword.

## `condition` (type: `string`):

Filter by the medical condition or disease being studied. Examples: 'diabetes', 'breast cancer', 'alzheimer'.

## `intervention` (type: `string`):

Filter by the treatment, drug, device, or procedure being tested. Examples: 'aspirin', 'insulin', 'physical therapy'.

## `sponsor` (type: `string`):

Filter by the organization running the trial. Examples: 'Pfizer', 'Moderna', 'National Cancer Institute'.

## `location` (type: `string`):

Filter by where the trial takes place — a city, state, or country. Examples: 'Boston', 'California', 'Germany'.

## `studyUrls` (type: `array`):

Fetch exact trials directly instead of searching. Paste ClinicalTrials.gov study URLs (e.g. https://clinicaltrials.gov/study/NCT04368728) or NCT IDs (e.g. NCT04368728). When provided, the search filters above are ignored.

## `status` (type: `array`):

Only include trials with these statuses. Leave empty to include every status.

## `studyType` (type: `array`):

Only include these kinds of studies. Leave empty to include all types.

## `phase` (type: `array`):

Only include trials in these phases. Applies mainly to interventional drug and biologic trials. Leave empty to include all phases.

## `sex` (type: `string`):

Only include trials open to this sex. Leave as 'Any' to include all.

## `healthyVolunteers` (type: `boolean`):

When on, only include trials that accept healthy volunteers.

## `sortBy` (type: `string`):

Choose the order results are returned in.

## `maxResults` (type: `integer`):

The most trials to return. Set to 0 to return every matching trial (can be hundreds of thousands — use with care).

## Actor input object example

```json
{
  "studyUrls": [],
  "status": [],
  "studyType": [],
  "phase": [],
  "sex": "ALL",
  "healthyVolunteers": false,
  "sortBy": "relevance",
  "maxResults": 100
}
```

# Actor output Schema

## `overview` (type: `string`):

Table of extracted clinical trials with key fields.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchTerm": "",
    "condition": "",
    "intervention": "",
    "sponsor": "",
    "location": "",
    "studyUrls": [],
    "status": [],
    "studyType": [],
    "phase": [],
    "healthyVolunteers": false,
    "maxResults": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("solidcode/clinicaltrials-gov-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchTerm": "",
    "condition": "",
    "intervention": "",
    "sponsor": "",
    "location": "",
    "studyUrls": [],
    "status": [],
    "studyType": [],
    "phase": [],
    "healthyVolunteers": False,
    "maxResults": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("solidcode/clinicaltrials-gov-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchTerm": "",
  "condition": "",
  "intervention": "",
  "sponsor": "",
  "location": "",
  "studyUrls": [],
  "status": [],
  "studyType": [],
  "phase": [],
  "healthyVolunteers": false,
  "maxResults": 100
}' |
apify call solidcode/clinicaltrials-gov-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=solidcode/clinicaltrials-gov-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "ClinicalTrials.gov Scraper",
        "description": "[💰 $2.5 / 1K] Extract clinical trials from ClinicalTrials.gov: titles, conditions, interventions, sponsors, status, phase, eligibility, locations, dates, and results. Search by condition, treatment, sponsor, or location.",
        "version": "1.0",
        "x-build-id": "1svnbBVoMQxapePzV"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/solidcode~clinicaltrials-gov-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-solidcode-clinicaltrials-gov-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/solidcode~clinicaltrials-gov-scraper/runs": {
            "post": {
                "operationId": "runs-sync-solidcode-clinicaltrials-gov-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/solidcode~clinicaltrials-gov-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-solidcode-clinicaltrials-gov-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "searchTerm": {
                        "title": "Keyword search",
                        "type": "string",
                        "description": "Free-text search across the whole trial record. Example: 'immunotherapy melanoma'. Leave empty to browse without a keyword."
                    },
                    "condition": {
                        "title": "Condition or disease",
                        "type": "string",
                        "description": "Filter by the medical condition or disease being studied. Examples: 'diabetes', 'breast cancer', 'alzheimer'."
                    },
                    "intervention": {
                        "title": "Treatment or intervention",
                        "type": "string",
                        "description": "Filter by the treatment, drug, device, or procedure being tested. Examples: 'aspirin', 'insulin', 'physical therapy'."
                    },
                    "sponsor": {
                        "title": "Sponsor or funder",
                        "type": "string",
                        "description": "Filter by the organization running the trial. Examples: 'Pfizer', 'Moderna', 'National Cancer Institute'."
                    },
                    "location": {
                        "title": "Location",
                        "type": "string",
                        "description": "Filter by where the trial takes place — a city, state, or country. Examples: 'Boston', 'California', 'Germany'."
                    },
                    "studyUrls": {
                        "title": "Specific trial URLs or IDs",
                        "type": "array",
                        "description": "Fetch exact trials directly instead of searching. Paste ClinicalTrials.gov study URLs (e.g. https://clinicaltrials.gov/study/NCT04368728) or NCT IDs (e.g. NCT04368728). When provided, the search filters above are ignored.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "status": {
                        "title": "Recruitment status",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Only include trials with these statuses. Leave empty to include every status.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "RECRUITING",
                                "NOT_YET_RECRUITING",
                                "ENROLLING_BY_INVITATION",
                                "ACTIVE_NOT_RECRUITING",
                                "COMPLETED",
                                "SUSPENDED",
                                "TERMINATED",
                                "WITHDRAWN",
                                "AVAILABLE",
                                "NO_LONGER_AVAILABLE",
                                "TEMPORARILY_NOT_AVAILABLE",
                                "APPROVED_FOR_MARKETING",
                                "WITHHELD",
                                "UNKNOWN"
                            ],
                            "enumTitles": [
                                "Recruiting",
                                "Not yet recruiting",
                                "Enrolling by invitation",
                                "Active, not recruiting",
                                "Completed",
                                "Suspended",
                                "Terminated",
                                "Withdrawn",
                                "Available",
                                "No longer available",
                                "Temporarily not available",
                                "Approved for marketing",
                                "Withheld",
                                "Unknown"
                            ]
                        },
                        "default": []
                    },
                    "studyType": {
                        "title": "Study type",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Only include these kinds of studies. Leave empty to include all types.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "INTERVENTIONAL",
                                "OBSERVATIONAL",
                                "EXPANDED_ACCESS"
                            ],
                            "enumTitles": [
                                "Interventional",
                                "Observational",
                                "Expanded access"
                            ]
                        },
                        "default": []
                    },
                    "phase": {
                        "title": "Trial phase",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Only include trials in these phases. Applies mainly to interventional drug and biologic trials. Leave empty to include all phases.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "EARLY_PHASE1",
                                "PHASE1",
                                "PHASE2",
                                "PHASE3",
                                "PHASE4",
                                "NA"
                            ],
                            "enumTitles": [
                                "Early Phase 1",
                                "Phase 1",
                                "Phase 2",
                                "Phase 3",
                                "Phase 4",
                                "Not applicable"
                            ]
                        },
                        "default": []
                    },
                    "sex": {
                        "title": "Eligible sex",
                        "enum": [
                            "ALL",
                            "FEMALE",
                            "MALE"
                        ],
                        "type": "string",
                        "description": "Only include trials open to this sex. Leave as 'Any' to include all.",
                        "default": "ALL"
                    },
                    "healthyVolunteers": {
                        "title": "Accepts healthy volunteers only",
                        "type": "boolean",
                        "description": "When on, only include trials that accept healthy volunteers.",
                        "default": false
                    },
                    "sortBy": {
                        "title": "Sort results by",
                        "enum": [
                            "relevance",
                            "last_updated",
                            "first_posted",
                            "enrollment"
                        ],
                        "type": "string",
                        "description": "Choose the order results are returned in.",
                        "default": "relevance"
                    },
                    "maxResults": {
                        "title": "Maximum trials",
                        "minimum": 0,
                        "type": "integer",
                        "description": "The most trials to return. Set to 0 to return every matching trial (can be hundreds of thousands — use with care).",
                        "default": 100
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
