# Clinical Trials Feed: Studies, Sponsors, Changes (`thoob/clinical-trials-feed`) Actor Clean, flat clinical-trial records from the official ClinicalTrials.gov v2 API, filtered by condition, sponsor, status, phase, and country, with a what-changed-since-last-run mode. Billed only per delivered record. - **URL**: https://apify.com/thoob/clinical-trials-feed.md - **Developed by:** [Pono Data](https://apify.com/thoob) (community) - **Categories:** Developer tools, News - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $0.02 / 1,000 trial records This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ## Clinical Trials Feed Clean, flat clinical-trial records from the official ClinicalTrials.gov v2 API. Filter by condition, sponsor, status, phase, and country, get one useful row per study, and run a changes-only mode that returns just what is new, status-changed, or updated since your last run. You pay only for a delivered study record. Filtered-out rows, unchanged rows in changes mode, and malformed records cost nothing. ### What a record is One flat row per study, pulled from the nested ClinicalTrials.gov record: - identity and title: `nctId`, `title`, study URL - status and timeline: `overallStatus`, `startDate`, `primaryCompletionDate`, `completionDate`, `lastUpdatePostDate` - design: `phase`, `studyType`, `enrollmentCount` - subject and treatment: `conditions`, `interventions` - sponsor: `leadSponsor`, `leadSponsorClass` (INDUSTRY, NIH, OTHER), `collaborators` - reach: `countries` (distinct trial-site countries) - provenance: `sourceUrl`, `retrievedAt`, `confidence`, `dataSource`, and in changes mode `changeType` Every value appears verbatim at the study URL in `sourceUrl`. Nothing is guessed. ### Sample output A real slice, recruiting Phase 3 non-small-cell lung cancer studies with a US site (abbreviated): | nctId | overallStatus | phase | leadSponsor | sourceUrl | |---|---|---|---|---| | NCT07222566 | RECRUITING | PHASE3 | Pfizer | clinicaltrials.gov/study/NCT07222566 | | NCT06890598 | RECRUITING | PHASE3 | Eli Lilly and Company | clinicaltrials.gov/study/NCT06890598 | | NCT02468024 | RECRUITING | PHASE3 | UT Southwestern Medical Center | clinicaltrials.gov/study/NCT02468024 | ### Two modes - **full**: every study matching your filter. - **changes**: only studies that are new, have a changed overall status, or carry a newer last-update date since this account's last run. The state is tracked per account in a named store, so it is your timeline. The first changes run has no baseline, so it returns everything matching once, then tracks deltas from there. ### Filters - **conditions**: diseases or conditions, combined into the API condition query. - **sponsor**: keep only studies whose sponsor matches this name. - **searchTerm**: an extra free-text term matched across the record. - **statuses**: recruitment statuses (RECRUITING, ACTIVE_NOT_RECRUITING, COMPLETED, TERMINATED, and the rest). - **phases**: PHASE1, PHASE2, PHASE3, PHASE4. - **countries**: keep only studies with a site in these countries. - **maxRecords**: a cap on how many records a run delivers and bills. 0 means no cap; the platform spend cap is honored regardless. Condition, sponsor, term, and status are applied by the API; phase and country are applied to the returned record. ### What to expect - ClinicalTrials.gov holds well over 500,000 studies, updated continuously. A filter narrows that to the slice you care about. - The raw API is public and free directly from the National Library of Medicine. What this actor sells is the flat, joined record, the phase and country filtering, and the per-account change feed, so you do not have to walk the nested JSON or diff it yourself. - A condition or sponsor watch is a few dollars; a daily changes feed is pennies a run. ### Source and scope - Source: the official ClinicalTrials.gov API v2 (`clinicaltrials.gov/api/v2`), a US National Library of Medicine service, public domain, no key, no anti-bot, paged with a declared identifying User-Agent. - The registry is global; the records are public study disclosures. This actor carries only that public record and stamps `dataSource=ClinicalTrials.gov`. - This is a data tool, not medical, investment, or regulatory advice. A registry record is a filing, not a finding. ### See also More clean, pay-only-for-results data tools from Pono Data: - [FDA Food Recall & Enforcement Alerts](https://apify.com/thoob/fda-food-recall-feed) - US food recalls and enforcement reports - [Regulatory Change Monitor](https://apify.com/thoob/regulatory-change-monitor) - federal rulemaking from the Federal Register Full catalog: https://apify.com/thoob # Actor input Schema ## `conditions` (type: `array`): Filter to studies of these conditions or diseases (for example non-small cell lung cancer, Alzheimer disease). Combined into the API condition query. Leave empty to match any condition. ## `sponsor` (type: `string`): Optional. Keep only studies whose sponsor matches this name (for example Pfizer, National Cancer Institute). ## `searchTerm` (type: `string`): Optional. An additional free-text term matched across the study record (interventions, keywords, and more). ## `statuses` (type: `array`): Filter to these recruitment statuses (for example RECRUITING, ACTIVE_NOT_RECRUITING, COMPLETED, TERMINATED). Leave empty for any status. ## `phases` (type: `array`): Keep only studies in these phases (for example PHASE1, PHASE2, PHASE3, PHASE4). Filtered on the returned record. Leave empty for any phase. ## `countries` (type: `array`): Keep only studies with at least one site in these countries (for example United States, China, Germany). Filtered on the returned record. Leave empty for any country. ## `mode` (type: `string`): full returns every study matching your filter. changes returns only studies that are new, have a changed overall status, or have a newer last-update date since this account's last run, tracked per account. The first changes run has no baseline, so it returns everything matching once, then tracks deltas. ## `maxRecords` (type: `integer`): Safety cap on how many studies this run delivers and bills. 0 means no cap. In changes mode, studies beyond the cap are not dropped: they are delivered on a later run, never billed twice. The platform spend cap (ACTOR_MAX_TOTAL_CHARGE_USD) is honored regardless. ## `pageSize` (type: `integer`): How many studies to request per API page (1 to 1000). Larger pages are fewer requests; the default is a polite middle. ## Actor input object example ```json { "conditions": [], "statuses": [], "phases": [], "countries": [], "mode": "full", "maxRecords": 0, "pageSize": 100 } ```` # Actor output Schema ## `studies` (type: `string`): One row per study matching your filter. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "conditions": [], "statuses": [], "phases": [], "countries": [] }; // Run the Actor and wait for it to finish const run = await client.actor("thoob/clinical-trials-feed").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "conditions": [], "statuses": [], "phases": [], "countries": [], } # Run the Actor and wait for it to finish run = client.actor("thoob/clinical-trials-feed").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 '{ "conditions": [], "statuses": [], "phases": [], "countries": [] }' | apify call thoob/clinical-trials-feed --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=thoob/clinical-trials-feed", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Clinical Trials Feed: Studies, Sponsors, Changes", "description": "Clean, flat clinical-trial records from the official ClinicalTrials.gov v2 API, filtered by condition, sponsor, status, phase, and country, with a what-changed-since-last-run mode. Billed only per delivered record.", "version": "0.0", "x-build-id": "LPUsAB0bhBiOAizfr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thoob~clinical-trials-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thoob-clinical-trials-feed", "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/thoob~clinical-trials-feed/runs": { "post": { "operationId": "runs-sync-thoob-clinical-trials-feed", "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/thoob~clinical-trials-feed/run-sync": { "post": { "operationId": "run-sync-thoob-clinical-trials-feed", "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": { "conditions": { "title": "Conditions or diseases", "type": "array", "description": "Filter to studies of these conditions or diseases (for example non-small cell lung cancer, Alzheimer disease). Combined into the API condition query. Leave empty to match any condition.", "items": { "type": "string" } }, "sponsor": { "title": "Sponsor", "type": "string", "description": "Optional. Keep only studies whose sponsor matches this name (for example Pfizer, National Cancer Institute)." }, "searchTerm": { "title": "Free-text search", "type": "string", "description": "Optional. An additional free-text term matched across the study record (interventions, keywords, and more)." }, "statuses": { "title": "Overall status", "type": "array", "description": "Filter to these recruitment statuses (for example RECRUITING, ACTIVE_NOT_RECRUITING, COMPLETED, TERMINATED). Leave empty for any status.", "items": { "type": "string" } }, "phases": { "title": "Phases", "type": "array", "description": "Keep only studies in these phases (for example PHASE1, PHASE2, PHASE3, PHASE4). Filtered on the returned record. Leave empty for any phase.", "items": { "type": "string" } }, "countries": { "title": "Trial location countries", "type": "array", "description": "Keep only studies with at least one site in these countries (for example United States, China, Germany). Filtered on the returned record. Leave empty for any country.", "items": { "type": "string" } }, "mode": { "title": "Mode", "enum": [ "full", "changes" ], "type": "string", "description": "full returns every study matching your filter. changes returns only studies that are new, have a changed overall status, or have a newer last-update date since this account's last run, tracked per account. The first changes run has no baseline, so it returns everything matching once, then tracks deltas.", "default": "full" }, "maxRecords": { "title": "Max delivered records", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Safety cap on how many studies this run delivers and bills. 0 means no cap. In changes mode, studies beyond the cap are not dropped: they are delivered on a later run, never billed twice. The platform spend cap (ACTOR_MAX_TOTAL_CHARGE_USD) is honored regardless.", "default": 0 }, "pageSize": { "title": "API page size", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many studies to request per API page (1 to 1000). Larger pages are fewer requests; the default is a polite middle.", "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 } } } } } } } } } } ```