{ "openapi": "3.0.1", "info": { "title": "Clinical Trials Change Monitor: Status & Updates", "description": "Track changes to ClinicalTrials.gov studies with the official API: overall status and why stopped, phase, enrollment, primary completion date, locations added or removed, results posted, sponsors and arms. Monitor mode returns only what changed; recent-updates mode lists the latest updates.", "version": "1.0", "x-build-id": "RxHJmU6XjChvruO2G" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/offerastudio~clinicaltrials-change-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-offerastudio-clinicaltrials-change-monitor", "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/offerastudio~clinicaltrials-change-monitor/runs": { "post": { "operationId": "runs-sync-offerastudio-clinicaltrials-change-monitor", "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/offerastudio~clinicaltrials-change-monitor/run-sync": { "post": { "operationId": "run-sync-offerastudio-clinicaltrials-change-monitor", "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": { "mode": { "title": "Mode", "enum": [ "recent-updates", "monitor" ], "type": "string", "description": "Recent updates: studies updated in the last N days that match your filters (no memory between runs). Monitor: keeps a snapshot of the tracked studies in a named key-value store and returns only what changed since the last run, with a field-level diff.", "default": "recent-updates" }, "conditions": { "title": "Conditions", "type": "array", "description": "Diseases or conditions, for example obesity or \"breast cancer\". Studies matching any of them are included.", "items": { "type": "string" } }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Other terms, such as a drug or a keyword (semaglutide, CAR-T). Studies matching any of them are included.", "items": { "type": "string" } }, "sponsors": { "title": "Sponsors", "type": "array", "description": "Lead sponsors or collaborators, for example Pfizer or \"Novo Nordisk\". Studies of any of them are included.", "items": { "type": "string" } }, "nctIds": { "title": "NCT IDs", "maxItems": 2000, "type": "array", "description": "Up to 2,000 specific studies, for example NCT05567796. In monitor mode they are always tracked, besides what the other filters find.", "items": { "type": "string" } }, "phases": { "title": "Phases", "type": "array", "description": "Only studies of these phases. Leave empty for all.", "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": [] }, "statuses": { "title": "Statuses", "type": "array", "description": "Only studies with one of these overall statuses. In monitor mode this only decides which studies are picked up: once tracked, a status change (for example RECRUITING to COMPLETED) is still reported.", "items": { "type": "string", "enum": [ "NOT_YET_RECRUITING", "RECRUITING", "ENROLLING_BY_INVITATION", "ACTIVE_NOT_RECRUITING", "COMPLETED", "SUSPENDED", "TERMINATED", "WITHDRAWN", "UNKNOWN" ], "enumTitles": [ "Not yet recruiting", "Recruiting", "Enrolling by invitation", "Active, not recruiting", "Completed", "Suspended", "Terminated", "Withdrawn", "Unknown" ] } }, "countries": { "title": "Countries", "type": "array", "description": "Only studies with a site in one of these countries, spelled as ClinicalTrials.gov does, for example United States or Germany.", "items": { "type": "string" } }, "updatedWithinDays": { "title": "Updated within", "minimum": 1, "maximum": 365, "type": "integer", "description": "Recent updates mode: studies whose last update was posted in the last N days (1 to 365).", "default": 7 }, "maxResults": { "title": "Maximum studies", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Recent updates: stop after this many studies (newest update first). Monitor: how many studies are tracked (the most recently updated that match; your NCT IDs are always tracked). Each study returned costs $0.002.", "default": 50 }, "includeUnchanged": { "title": "Include unchanged studies (monitor mode)", "type": "boolean", "description": "In monitor mode, also return a row for tracked studies that did not change. Off by default, so the dataset (and your alerts) only get rows when something changed. It is switched on in the example input only so a first try always shows rows; turn it off for monitoring.", "default": false }, "monitorName": { "title": "Monitor name", "pattern": "^[A-Za-z0-9 _-]{0,36}$", "type": "string", "description": "Name of this monitor's snapshot store (letters, digits, spaces, - and _). Runs with the same name share the snapshot. Leave empty to derive it from the filters; then changing a filter starts a new monitor with a new baseline." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }