{ "openapi": "3.0.1", "info": { "title": "FDA Recall Enforcement Reports Monitor (openFDA)", "description": "Unofficial; not affiliated with FDA or HHS. Search and monitor FDA recall enforcement reports for food, drugs and medical devices via the official openFDA API. Filter by keyword, firm, class, status, state and date. Only-new and changed reports.", "version": "0.1", "x-build-id": "Q2WN1ITAdVzC47sTW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/brightish_ascent~openfda-recall-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-brightish_ascent-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/brightish_ascent~openfda-recall-monitor/runs": { "post": { "operationId": "runs-sync-brightish_ascent-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/brightish_ascent~openfda-recall-monitor/run-sync": { "post": { "operationId": "run-sync-brightish_ascent-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": "Categories", "type": "array", "description": "Which openFDA enforcement datasets to search. Empty = all three.", "items": { "type": "string", "enum": [ "food", "drug", "device" ], "enumTitles": [ "Food (incl. cosmetics, dietary supplements)", "Drugs", "Medical devices" ] } }, "query": { "title": "Keyword or phrase", "type": "string", "description": "Phrase matched in product description, reason for recall or code info (e.g. listeria, insulin pump)." }, "recallingFirm": { "title": "Recalling firm", "type": "string", "description": "Company name phrase as listed by FDA." }, "classifications": { "title": "Recall class", "type": "array", "description": "Class I is the most serious. Empty = all.", "items": { "type": "string", "enum": [ "Class I", "Class II", "Class III" ] } }, "statuses": { "title": "Status", "type": "array", "description": "Empty = all.", "items": { "type": "string", "enum": [ "Ongoing", "Completed", "Terminated", "Pending" ] } }, "states": { "title": "Firm state (2-letter)", "type": "array", "description": "U.S. state codes of the recalling firm, e.g. CA, TX.", "items": { "type": "string" } }, "fromReportDate": { "title": "Report date from", "type": "string", "description": "YYYY-MM-DD. If no keyword, firm or dates are set, the last 30 days are used." }, "toReportDate": { "title": "Report date to", "type": "string", "description": "YYYY-MM-DD." }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum rows per run (you pay per row). Default 25.", "default": 25 }, "onlyNewSinceLastRun": { "title": "Only new since last run", "type": "boolean", "description": "For schedules: return only reports not delivered by a previous run with the same filters, plus already-delivered reports whose status, class or termination date changed (updateType \"changed\") while their report date is within lookbackDays. The first run is a baseline.", "default": false }, "lookbackDays": { "title": "Lookback days (monitor mode)", "minimum": 0, "maximum": 365, "type": "integer", "description": "How far before the last seen report date to re-check for late-posted reports.", "default": 30 }, "outputFormat": { "title": "Output format", "enum": [ "full", "compact" ], "type": "string", "description": "compact = key fields only, text truncated to 300 chars.", "default": "full" }, "apiKey": { "title": "openFDA API key (optional)", "type": "string", "description": "Free key from open.fda.gov raises rate limits. Without it, openFDA allows 1,000 requests/day per IP (shared by all users on that Apify IP) and this Actor stops at 100 requests per run." } } }, "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 } } } } } } } } } }