{ "openapi": "3.0.1", "info": { "title": "Medical Device Clearance Tracker", "description": "Track FDA 510(k) clearances and PMA approvals by device type, product code or company. Returns device, applicant, class, decision date, review time and the FDA record link, newest first, and flags new clearances since your last run. For medtech teams.", "version": "0.1", "x-build-id": "GVOZmF0jVDLMY1vCt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arched_friend~medical-device-clearance-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arched_friend-medical-device-clearance-tracker", "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/arched_friend~medical-device-clearance-tracker/runs": { "post": { "operationId": "runs-sync-arched_friend-medical-device-clearance-tracker", "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/arched_friend~medical-device-clearance-tracker/run-sync": { "post": { "operationId": "run-sync-arched_friend-medical-device-clearance-tracker", "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": { "searchTerms": { "title": "Device type or keyword", "type": "array", "description": "What to watch, one per line, for example glucose monitor, catheter or a company name. Matched against the device name, the FDA generic name and the applicant.", "items": { "type": "string" } }, "applicants": { "title": "Companies", "type": "array", "description": "Optional. Only decisions for these applicants, one per line. Use this to watch competitors.", "items": { "type": "string" } }, "productCodes": { "title": "FDA product codes", "type": "array", "description": "Optional. Three-letter FDA product codes, one per line, for example DXY or QBJ.", "items": { "type": "string" } }, "pathways": { "title": "Pathways", "type": "array", "description": "510(k) clearances, PMA approvals or both.", "items": { "type": "string", "enum": [ "510k", "pma" ], "enumTitles": [ "510(k) clearances", "PMA approvals" ] }, "default": [ "510k", "pma" ] }, "includeSupplements": { "title": "Include PMA supplements", "type": "boolean", "description": "PMA supplements (labelling changes, site moves, 30-day notices) outnumber original approvals about fifty to one. Leave off to see only new devices.", "default": false }, "lastDays": { "title": "Decided in the last N days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "How far back to search by FDA decision date.", "default": 90 }, "countries": { "title": "Applicant countries", "type": "array", "description": "Optional. Two-letter country codes, one per line, for example US or CN. Applies to 510(k) rows only, since FDA publishes no country for PMA approvals.", "items": { "type": "string" } }, "deviceClasses": { "title": "Device classes", "type": "array", "description": "Only these FDA device classes. Leave empty for all.", "items": { "type": "string", "enum": [ "1", "2", "3" ], "enumTitles": [ "Class I", "Class II", "Class III" ] }, "default": [] }, "applicantExcludes": { "title": "Exclude companies", "type": "array", "description": "Drop decisions for applicants whose name contains any of these, one per line.", "items": { "type": "string" } }, "onlyChanged": { "title": "Only new decisions", "type": "boolean", "description": "Return nothing on a quiet run. Turn on for a scheduled watch so you only hear about decisions published since the last run.", "default": false }, "maxResultsPerPathway": { "title": "Maximum decisions per pathway", "minimum": 1, "maximum": 5000, "type": "integer", "description": "The most decisions to read from each pathway, newest first.", "default": 200 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait for one page from openFDA before giving up on it.", "default": 45 }, "timeBudgetSecs": { "title": "Time budget (seconds)", "minimum": 30, "maximum": 3600, "type": "integer", "description": "How long the run may spend before it returns what it has.", "default": 150 } } }, "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 } } } } } } } } } }