{ "openapi": "3.0.1", "info": { "title": "FDA Recalls & 510(k) Clearances Scraper (openFDA API)", "description": "FDA medical device, drug and food recalls (enforcement reports) and 510(k) device clearances from the public openFDA API. Filter by class, status, keyword, firm, state and date. Newest first. Regulatory monitoring and medtech competitive intelligence. No API key needed.", "version": "0.1", "x-build-id": "TXq1f4OV8SDObjBBv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/groundplanes~openfda-recalls-510k/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-groundplanes-openfda-recalls-510k", "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/groundplanes~openfda-recalls-510k/runs": { "post": { "operationId": "runs-sync-groundplanes-openfda-recalls-510k", "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/groundplanes~openfda-recalls-510k/run-sync": { "post": { "operationId": "run-sync-groundplanes-openfda-recalls-510k", "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": { "dataset": { "title": "openFDA Dataset", "enum": [ "device_enforcement", "drug_enforcement", "food_enforcement", "device_510k" ], "type": "string", "description": "Select which openFDA endpoint to query: device_enforcement, drug_enforcement, food_enforcement, or device_510k.", "default": "device_enforcement" }, "classifications": { "title": "Recall Classifications (Enforcement Only)", "type": "array", "description": "FDA recall hazard classifications to include (applies to enforcement datasets only). Leave empty for all classifications.", "items": { "type": "string", "enum": [ "Class I", "Class II", "Class III" ], "enumTitles": [ "Class I (Highest Risk / Serious Adverse Health Consequences)", "Class II (Temporary or Medically Reversible Health Consequences)", "Class III (Unlikely to Cause Adverse Health Consequences)" ] }, "default": [ "Class I", "Class II" ] }, "statuses": { "title": "Recall Statuses (Enforcement Only)", "type": "array", "description": "Optional recall statuses (Ongoing, Completed, Terminated, Pending). Leave empty for all.", "items": { "type": "string", "enum": [ "Ongoing", "Completed", "Terminated", "Pending" ], "enumTitles": [ "Ongoing", "Completed", "Terminated", "Pending" ] }, "default": [] }, "keywords": { "title": "Keywords", "type": "array", "description": "Optional keywords matched against product_description or reason_for_recall (or device_name for device_510k).", "items": { "type": "string" }, "default": [] }, "firmName": { "title": "Firm or Applicant Name", "type": "string", "description": "Optional company name matched against recalling_firm (enforcement) or applicant (device_510k).", "default": "" }, "states": { "title": "US States", "type": "array", "description": "Optional 2-letter US state codes (e.g. [\"CA\", \"MN\", \"MA\"]). Leave empty for all states.", "items": { "type": "string" }, "default": [] }, "dateFrom": { "title": "Date From (YYYY-MM-DD)", "type": "string", "description": "Start of report_date (enforcement; must be >= 2012-06-20) or decision_date (device_510k). Leave empty for today minus 90 days." }, "dateTo": { "title": "Date To (YYYY-MM-DD)", "type": "string", "description": "End of report_date (enforcement) or decision_date (device_510k). Leave empty for today." }, "openFdaApiKey": { "title": "openFDA API Key (Optional)", "type": "string", "description": "Optional free api.fda.gov key to raise the daily quota from 1,000 to 120,000 requests/day." }, "maxItems": { "title": "Maximum Items", "minimum": 1, "type": "integer", "description": "Maximum number of recall or 510(k) records to output.", "default": 200 } } }, "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 } } } } } } } } } }