{
"openapi": "3.0.1",
"info": {
"title": "FDA Recall Monitor — Drug, Device & Food Alerts",
"description": "Monitor FDA drug, device, and food recalls from the official openFDA API. Filter by keyword, firm, recall class (I/II/III), status, or date range. Alert mode outputs only new recalls since your last run, so you can schedule daily or weekly compliance and safety alerts.",
"version": "0.1",
"x-build-id": "j1hMsQoLEX3Ya3csp"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/bikram07~fda-recall-monitor/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-bikram07-fda-recall-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/bikram07~fda-recall-monitor/runs": {
"post": {
"operationId": "runs-sync-bikram07-fda-recall-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/bikram07~fda-recall-monitor/run-sync": {
"post": {
"operationId": "run-sync-bikram07-fda-recall-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": {
"productTypes": {
"title": "Product types to monitor",
"type": "array",
"description": "Which FDA product categories to include: drug, device, food. Defaults to drug only.",
"items": {
"type": "string"
},
"default": [
"drug"
]
},
"keywords": {
"title": "Keywords (optional)",
"type": "array",
"description": "Only include recalls where the product description or reason contains at least one of these terms. Example: insulin, epinephrine, undeclared allergen. Leave empty for all recalls.",
"items": {
"type": "string"
}
},
"firm": {
"title": "Recalling firm name (optional)",
"type": "string",
"description": "Filter recalls by the name of the recalling company. Partial matches work. Example: Pfizer"
},
"classification": {
"title": "Classifications (optional)",
"type": "array",
"description": "Filter by FDA recall severity. Values: Class I (most severe, health hazard), Class II (may cause adverse effects), Class III (unlikely to cause harm). Leave empty for all.",
"items": {
"type": "string"
}
},
"status": {
"title": "Status (optional)",
"type": "string",
"description": "Filter by recall status. Values: Ongoing, Completed, Terminated. Leave blank for all."
},
"dateFrom": {
"title": "Date from (optional)",
"pattern": "^\\d{8}$",
"type": "string",
"description": "Start date for recall initiation date filter. Format: YYYYMMDD. Example: 20260101"
},
"dateTo": {
"title": "Date to (optional)",
"pattern": "^\\d{8}$",
"type": "string",
"description": "End date for recall initiation date filter. Format: YYYYMMDD. Leave blank for today."
},
"maxRecords": {
"title": "Max recall records",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Maximum total recall records to output across all product types.",
"default": 200
},
"alertMode": {
"title": "Alert mode (only new recalls)",
"type": "boolean",
"description": "When enabled, the Actor remembers which recalls it has already output for this filter combination and only outputs new recalls since the last run. Schedule weekly or daily for continuous monitoring.",
"default": false
}
}
},
"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
}
}
}
}
}
}
}
}
}
}