{
"openapi": "3.0.1",
"info": {
"title": "FDA Recall Monitor 🚨 (device, drug, food alerts)",
"description": "Watch US FDA recalls by firm, product, classification (Class I, II or III) or status and get only what is new since your last run, straight to Slack. Official openFDA enforcement API, no key. Pay $0.002 per recall, misses are free.",
"version": "0.1",
"x-build-id": "bY3tsp4fIPg2XIvS8"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/tagadanar~openfda-recall-monitor/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-tagadanar-openfda-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/tagadanar~openfda-recall-monitor/runs": {
"post": {
"operationId": "runs-sync-tagadanar-openfda-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/tagadanar~openfda-recall-monitor/run-sync": {
"post": {
"operationId": "run-sync-tagadanar-openfda-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": {
"categories": {
"title": "Product categories",
"type": "array",
"description": "Which FDA recall databases to watch. Devices, drugs and food are separate openFDA enforcement endpoints. Leave all selected to cover everything.",
"items": {
"type": "string",
"enum": [
"device",
"drug",
"food"
],
"enumTitles": [
"Medical devices",
"Drugs",
"Food"
]
},
"default": [
"device",
"drug",
"food"
]
},
"searchTerms": {
"title": "Firm or product keywords",
"type": "array",
"description": "Optional. Company names or product keywords to match, e.g. Abbott, insulin, peanut butter. Each term matches the recalling firm or the product description. Multiple terms are combined with OR. Leave empty to watch every recall in the selected categories.",
"default": [],
"items": {
"type": "string"
}
},
"classification": {
"title": "Classification (severity)",
"enum": [
"",
"Class I",
"Class II",
"Class III"
],
"type": "string",
"description": "FDA recall severity. Class I is the most serious (reasonable probability of serious harm or death), Class II is temporary or medically reversible, Class III is unlikely to cause harm. Leave as Any for all.",
"default": ""
},
"status": {
"title": "Recall status",
"enum": [
"",
"Ongoing",
"Completed",
"Terminated"
],
"type": "string",
"description": "Filter by where the recall is in its lifecycle. Leave as Any for all.",
"default": ""
},
"sinceDays": {
"title": "Look back this many days",
"minimum": 1,
"maximum": 3650,
"type": "integer",
"description": "Only return recalls reported within this many days (by the FDA report date). A scheduled monitor typically uses a window a bit longer than its run interval.",
"default": 90
},
"maxResults": {
"title": "Max recalls per run",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Stop after collecting this many matching recalls across all selected categories. Caps cost and runtime on broad queries.",
"default": 200
},
"monitorMode": {
"title": "Monitor mode (alert on new/changed recalls only)",
"type": "boolean",
"description": "Remember recalls already seen across runs and return only new ones, plus any whose status changed (for example Ongoing to Terminated). Built for a scheduled run: the first run establishes the baseline, later runs report and charge for changes only.",
"default": false
},
"webhookUrl": {
"title": "Webhook URL (Slack-compatible)",
"type": "string",
"description": "When monitor mode finds new or changed recalls, post a text digest here (Slack incoming webhook or any endpoint accepting {\"text\": \"...\"} JSON)."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}