{ "openapi": "3.0.1", "info": { "title": "FDA Recalls, Adverse Events & 510(k) Scraper (openFDA)", "description": "Export FDA drug, food & device recalls, FAERS adverse events, 510(k) clearances and drug labels from the official openFDA API. No API key, no 25k record cap.", "version": "0.1", "x-build-id": "toyU1ApBlqWegWNnR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deanko~openfda-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deanko-openfda-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/deanko~openfda-scraper/runs": { "post": { "operationId": "runs-sync-deanko-openfda-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/deanko~openfda-scraper/run-sync": { "post": { "operationId": "run-sync-deanko-openfda-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": { "dataset": { "title": "Dataset", "enum": [ "drug/enforcement", "food/enforcement", "device/enforcement", "drug/event", "device/510k", "drug/label" ], "type": "string", "description": "Which official openFDA dataset to export: drug, food or medical device recalls (enforcement reports), FAERS drug adverse events, device 510(k) clearances or drug labels (SPL). Every row has the common columns dataset, recordId, date, company, title and url, followed by dataset-specific columns.", "default": "drug/enforcement" }, "searchText": { "title": "Search text", "type": "string", "description": "Optional. Free-text search across all fields, e.g. metformin, listeria, insulin pump. Whole words match. Also accepts openFDA query syntax for precise filters, e.g. reason_for_recall:undeclared or patient.drug.medicinalproduct:\"OZEMPIC\". Leave empty for all records.", "default": "" }, "firmNames": { "title": "Company / manufacturer names", "type": "array", "description": "Optional. Only records from these companies (any of them). Matches the recalling firm for recalls, the applicant for 510(k), and the manufacturer name for adverse events and labels. Words inside the name match, so Pfizer finds \"Pfizer Laboratories Div Pfizer Inc\". Example: Pfizer, Medtronic.", "items": { "type": "string" } }, "dateFrom": { "title": "Date from", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Optional. Only records on or after this date (YYYY-MM-DD). Uses the report date for recalls, the FDA receive date for adverse events, the decision date for 510(k) and the effective date for labels.", "default": "" }, "dateTo": { "title": "Date to", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Optional. Only records on or before this date (YYYY-MM-DD). Same date field as \"Date from\".", "default": "" }, "classifications": { "title": "Recall classification", "type": "array", "description": "Optional, recall datasets only. Class I = dangerous (reasonable probability of serious harm or death), Class II = may cause temporary or reversible harm, Class III = unlikely to cause harm. Leave empty for all classes. Ignored for adverse events, 510(k) and labels.", "items": { "type": "string", "enum": [ "Class I", "Class II", "Class III" ] }, "default": [] }, "sortOrder": { "title": "Sort by date", "enum": [ "desc", "asc" ], "type": "string", "description": "Order of records by the dataset's date field. Newest first is best for monitoring; oldest first for building a full history.", "default": "desc" }, "maxItems": { "title": "Max records", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stop after this many records. You pay per record, so start small (20 records = $0.03) and raise it for full exports. There is no upper cap from openFDA: pagination continues past the 25,000-record skip limit.", "default": 20 }, "apiKey": { "title": "openFDA API key (optional)", "type": "string", "description": "Optional free key from open.fda.gov/apis/authentication. Not needed for normal use. Without a key openFDA allows 240 requests per minute and 1,000 per day per IP; a key raises the daily limit to 120,000. Each request returns up to 1,000 records." } } }, "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 } } } } } } } } } }