{ "openapi": "3.0.1", "info": { "title": "FDA Recalls Scraper - Drug, Device & Food", "description": "Scrape & monitor FDA drug, medical device, and food recalls from the openFDA enforcement API in one run. Filter by type, class, state, and date. Export CSV/JSON.", "version": "1.0", "x-build-id": "L684dBlh3bwJzwd3S" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maydit~us-fda-recalls-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maydit-us-fda-recalls-scraper", "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/maydit~us-fda-recalls-scraper/runs": { "post": { "operationId": "runs-sync-maydit-us-fda-recalls-scraper", "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/maydit~us-fda-recalls-scraper/run-sync": { "post": { "operationId": "run-sync-maydit-us-fda-recalls-scraper", "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", "type": "array", "description": "Which FDA-regulated product categories to pull recalls for.", "items": { "type": "string", "enum": [ "drug", "device", "food" ], "enumTitles": [ "Drugs", "Medical devices", "Food" ] }, "default": [ "drug", "device", "food" ] }, "keyword": { "title": "Keyword", "type": "string", "description": "Filter recalls whose product description, recall reason, or recalling firm matches this term — e.g. 'listeria', 'salmonella', a drug name, or a company name. Leave empty for all." }, "classification": { "title": "Recall classification", "enum": [ "Class I", "Class II", "Class III" ], "type": "string", "description": "Class I = most serious (risk of death/serious harm), Class II = temporary/reversible harm, Class III = unlikely to cause harm. Leave empty for all." }, "status": { "title": "Recall status", "enum": [ "Ongoing", "Completed", "Terminated" ], "type": "string", "description": "Ongoing = FDA has not yet confirmed the recall is finished; Completed = the firm has retrieved or corrected all known stock; Terminated = FDA has formally closed the recall. Spelling must match exactly. Leave empty for all." }, "state": { "title": "Recalling firm state", "type": "string", "description": "Two-letter code for the state where the RECALLING FIRM is based, not where the product was sold - use the distributionPattern output field for distribution reach. Case-insensitive; leave empty for all." }, "reportedSince": { "title": "Reported since", "type": "string", "description": "Only recalls reported on or after this date (YYYY-MM-DD). Great for weekly monitoring. Note: FDA publishes enforcement data on a ~weekly cycle, so the newest recalls can lag 1-2 weeks." }, "reportedUntil": { "title": "Reported until", "type": "string", "description": "Only recalls whose FDA report date is on or before this date (YYYY-MM-DD). Leave empty for no upper bound. Combine with 'Reported since' to pull a fixed historical window." }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Upper bound on recalls returned per run, across all selected product types. openFDA caps pagination at 25,000 skipped records, so one run can return at most about 26,000 recalls per product type; use filters or a date window to slice larger histories.", "default": 1000 }, "maxRunSeconds": { "title": "Max run seconds", "minimum": 30, "type": "integer", "description": "Wall-clock budget for this run, in seconds. When it is reached the Actor stops cleanly and finishes successfully with the rows it already collected, instead of being killed mid-run. A default run finishes in well under a minute; only a very large \"maxResults\" across all three product types gets near it. Raise it (and the run timeout in Run options) for a deliberately large job.", "default": 240 } } }, "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 } } } } } } } } } }