{ "openapi": "3.0.1", "info": { "title": "ClinicalTrials.gov Search: Trials, Sponsors & Sites", "description": "Search the official ClinicalTrials.gov registry (600,000+ studies): condition, drug, sponsor, phase, status, country, city or distance, new trials. One row per study or per trial site with facility, location and contacts. Official US Government data.", "version": "0.1", "x-build-id": "jWMjAK9Rg2FsilQMS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/frenchdatalab~clinical-trials-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-frenchdatalab-clinical-trials-search", "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/frenchdatalab~clinical-trials-search/runs": { "post": { "operationId": "runs-sync-frenchdatalab-clinical-trials-search", "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/frenchdatalab~clinical-trials-search/run-sync": { "post": { "operationId": "run-sync-frenchdatalab-clinical-trials-search", "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 / diseases", "type": "array", "description": "e.g. \"lung cancer\", \"type 2 diabetes\", \"Alzheimer\". Synonyms are handled by ClinicalTrials.gov.", "items": { "type": "string" } }, "interventions": { "title": "Drugs / interventions", "type": "array", "description": "e.g. \"pembrolizumab\", \"semaglutide\", \"CAR-T\".", "items": { "type": "string" } }, "sponsors": { "title": "Sponsors / collaborators", "type": "array", "description": "e.g. \"Pfizer\", \"Novartis\", \"National Cancer Institute\".", "items": { "type": "string" } }, "keywords": { "title": "Other words", "type": "string", "description": "Free text searched in the whole record." }, "nctIds": { "title": "NCT numbers", "type": "array", "description": "Look up these studies (e.g. NCT04368728) instead of searching. Unknown numbers are listed with found = false and are not charged.", "items": { "type": "string" } }, "statuses": { "title": "Recruitment status", "uniqueItems": true, "type": "array", "description": "Leave empty for all.", "items": { "type": "string", "enum": [ "RECRUITING", "NOT_YET_RECRUITING", "ENROLLING_BY_INVITATION", "ACTIVE_NOT_RECRUITING", "COMPLETED", "SUSPENDED", "TERMINATED", "WITHDRAWN", "UNKNOWN" ], "enumTitles": [ "Recruiting", "Not yet recruiting", "Enrolling by invitation", "Active, not recruiting", "Completed", "Suspended", "Terminated", "Withdrawn", "Unknown" ] } }, "phases": { "title": "Phases", "uniqueItems": true, "type": "array", "description": "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" ] } }, "studyTypes": { "title": "Study types", "uniqueItems": true, "type": "array", "description": "Leave empty for all.", "items": { "type": "string", "enum": [ "INTERVENTIONAL", "OBSERVATIONAL", "EXPANDED_ACCESS" ], "enumTitles": [ "Interventional (clinical trials)", "Observational", "Expanded access" ] } }, "sponsorTypes": { "title": "Lead sponsor types", "uniqueItems": true, "type": "array", "description": "INDUSTRY = pharma, biotech and medtech companies.", "items": { "type": "string", "enum": [ "INDUSTRY", "NIH", "FED", "OTHER_GOV", "INDIV", "NETWORK", "OTHER", "UNKNOWN" ], "enumTitles": [ "Industry", "NIH", "Other US federal agency", "Other government", "Individual", "Network", "Other (universities, hospitals…)", "Unknown" ] } }, "firstPostedWithinDays": { "title": "New trials: first posted in the last N days", "minimum": 0, "type": "integer", "description": "e.g. 7 for the new trials of the week (great for a weekly scheduled run). Results are sorted newest first." }, "firstPostedSince": { "title": "First posted on or after", "type": "string", "description": "YYYY-MM-DD" }, "updatedSince": { "title": "Updated on or after", "type": "string", "description": "YYYY-MM-DD: trials whose record changed since this date (status, sites, results…)." }, "countries": { "title": "Countries", "type": "array", "description": "Trials with at least one site in these countries: names (\"France\", \"United States\") or 2-letter codes (FR, US).", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Trials with at least one site in these cities, e.g. \"Boston\", \"Lyon\".", "items": { "type": "string" } }, "latitude": { "title": "Near: latitude", "type": "string", "description": "Decimal degrees, e.g. 40.7128 (with longitude and radius: trials with a site within the radius)." }, "longitude": { "title": "Near: longitude", "type": "string", "description": "Decimal degrees, e.g. -74.0060." }, "radiusKm": { "title": "Near: radius (km)", "minimum": 1, "type": "integer", "description": "Default 50 km." }, "oneRowPerSite": { "title": "One row per trial site", "type": "boolean", "description": "Site selection & hospital prospecting: one row per facility (name, city, country, site status, site contacts' names, roles and phones) with the main study fields. With location filters, only the sites inside the area are returned.", "default": false }, "includeEligibilityCriteria": { "title": "Include full eligibility criteria", "type": "boolean", "description": "Adds the inclusion / exclusion criteria text (long).", "default": false }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of studies (or sites) returned.", "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 }, "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 } } } } } } } } } }