# openFDA Scraper (`straightforward_hydra/openfda-scraper`) Actor Recalls (drug/device/food), adverse events and drug labels from the official openFDA API. No API key. - **URL**: https://apify.com/straightforward\_hydra/openfda-scraper.md - **Developed by:** [Dev D](https://apify.com/straightforward_hydra) (community) - **Categories:** Automation, Developer tools, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 records This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## openFDA Scraper 💊 **Drug, device and food recalls, adverse-event reports and drug labels from the official openFDA API. No API key, no login.** Pull clean, structured regulatory data straight from the U.S. FDA's [openFDA](https://open.fda.gov) API: product **recalls** (enforcement reports) for drugs, medical devices and food; **adverse-event** reports; and **drug labels**. Filter by classification, status, firm, state and date range. Perfect for pharma/food safety monitoring, compliance, competitive intelligence and research. > Uses the official openFDA API — public U.S. FDA data, no key required. --- ### Datasets - 💊 **Drug recalls** — enforcement reports (class, reason, firm, product). - 🩺 **Device recalls** — medical-device enforcement reports. - 🥫 **Food recalls** — food & cosmetic enforcement reports. - ⚠️ **Drug adverse events** — FAERS reports (reactions, patient, drugs). - 🏷️ **Drug labels** — indications, warnings, dosage, ingredients. ### Features - ✅ **No API key** — official openFDA endpoints, works out of the box. - ✅ **Recall filters** — classification (Class I/II/III), status, firm, state, date range. - ✅ **Clean records** — ISO dates, flattened brand/generic/manufacturer names. - ✅ **Advanced queries** — pass any openFDA field query (e.g. `reason_for_recall:"contamination"`). - ✅ **Low-maintenance** — stable official API, one clean record per item. --- ### Input | Field | Description | |---|---| | **Dataset** | drug / device / food recalls, adverse events, or labels. | | **Search query** | Free text or an openFDA field query. | | **Classification** | Recalls: Class I / II / III. | | **Status** | Recalls: Ongoing / Completed / Terminated. | | **State / Firm** | Recalls: filter by recalling firm's state or name. | | **From / To date** | YYYY-MM-DD range on the dataset's main date field. | | **API key** | Optional free key for a higher daily quota. | | **Max results** | Result cap (openFDA caps deep paging at ~25,000). | #### Example — ongoing Class I drug recalls, 2024 ```json { "dataset": "drug-recalls", "classification": "Class I", "status": "Ongoing", "dateFrom": "2024-01-01", "maxResults": 500 } ```` #### Example — recent adverse events for a drug ```json { "dataset": "drug-adverse-events", "query": "patient.drug.medicinalproduct:\"OZEMPIC\"", "maxResults": 200 } ``` ### Output Recall row: ```json { "type": "recall", "recall_number": "D-0123-2024", "status": "Ongoing", "classification": "Class I", "product_description": "...", "reason_for_recall": "Failed specifications", "recalling_firm": "Example Pharma Inc.", "state": "NJ", "recall_initiation_date": "2024-03-11", "brand_name": "...", "generic_name": "..." } ``` Adverse-event rows carry `safetyreportid`, `serious`, `reactions`, `drugs`, patient sex/age; label rows carry `indications_and_usage`, `warnings`, `dosage_and_administration`, ingredients. ### Run it on a schedule Schedule the Actor to watch for new recalls in your category and connect a **Google Sheets / Slack / webhook** integration for instant safety alerts. ### Notes & limitations - Uses the official openFDA API — no key needed (optional key raises the daily quota). - Data is a point-in-time snapshot at run time. - Adverse-event reports are voluntary and not confirmed causation (FDA disclaimer). - Public, non-personal U.S. FDA regulatory data. - Data source: openFDA (U.S. Food & Drug Administration). *** #### Keywords openFDA, FDA, drug recall, food recall, device recall, FDA recalls, adverse events, FAERS, drug label, drug safety, pharmacovigilance, product recall, FDA enforcement, recall monitoring, pharma compliance, food safety, medical device, drug data, FDA API, regulatory data. # Actor input Schema ## `dataset` (type: `string`): Which FDA dataset to pull. ## `query` (type: `string`): Free text, or an openFDA field query. Examples: "metformin"; reason\_for\_recall:"contamination"; patient.drug.medicinalproduct:"ASPIRIN". ## `classification` (type: `string`): Class I (most serious), Class II, or Class III. ## `status` (type: `string`): Ongoing, Completed, Terminated, or Pending. ## `state` (type: `string`): Two-letter US state of the recalling firm, e.g. CA, NY, TX. ## `firm` (type: `string`): Exact recalling firm / company name. ## `dateFrom` (type: `string`): Only records on/after this date (YYYY-MM-DD). Applies to the dataset's main date field. ## `dateTo` (type: `string`): Only records on/before this date (YYYY-MM-DD). ## `sort` (type: `string`): openFDA sort expression, e.g. recall\_initiation\_date:desc. Defaults to newest first. ## `apiKey` (type: `string`): Optional free key (open.fda.gov/apis/authentication) to raise the daily quota from 1,000 to 120,000 requests. Not required. ## `maxResults` (type: `integer`): How many records to return (openFDA caps deep paging at ~25,000). ## Actor input object example ```json { "dataset": "drug-recalls", "classification": "", "status": "", "maxResults": 100 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("straightforward_hydra/openfda-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("straightforward_hydra/openfda-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call straightforward_hydra/openfda-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=straightforward_hydra/openfda-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "openFDA Scraper", "description": "Recalls (drug/device/food), adverse events and drug labels from the official openFDA API. No API key.", "version": "0.1", "x-build-id": "b7Qb0GCrA41ypRb2S" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/straightforward_hydra~openfda-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-straightforward_hydra-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/straightforward_hydra~openfda-scraper/runs": { "post": { "operationId": "runs-sync-straightforward_hydra-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/straightforward_hydra~openfda-scraper/run-sync": { "post": { "operationId": "run-sync-straightforward_hydra-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-recalls", "device-recalls", "food-recalls", "drug-adverse-events", "drug-labels" ], "type": "string", "description": "Which FDA dataset to pull.", "default": "drug-recalls" }, "query": { "title": "Search query (optional)", "type": "string", "description": "Free text, or an openFDA field query. Examples: \"metformin\"; reason_for_recall:\"contamination\"; patient.drug.medicinalproduct:\"ASPIRIN\"." }, "classification": { "title": "Recall classification (recalls only)", "enum": [ "", "Class I", "Class II", "Class III" ], "type": "string", "description": "Class I (most serious), Class II, or Class III.", "default": "" }, "status": { "title": "Recall status (recalls only)", "enum": [ "", "Ongoing", "Completed", "Terminated", "Pending" ], "type": "string", "description": "Ongoing, Completed, Terminated, or Pending.", "default": "" }, "state": { "title": "State (recalls only)", "type": "string", "description": "Two-letter US state of the recalling firm, e.g. CA, NY, TX." }, "firm": { "title": "Recalling firm (recalls only)", "type": "string", "description": "Exact recalling firm / company name." }, "dateFrom": { "title": "From date (optional)", "type": "string", "description": "Only records on/after this date (YYYY-MM-DD). Applies to the dataset's main date field." }, "dateTo": { "title": "To date (optional)", "type": "string", "description": "Only records on/before this date (YYYY-MM-DD)." }, "sort": { "title": "Sort (optional)", "type": "string", "description": "openFDA sort expression, e.g. recall_initiation_date:desc. Defaults to newest first." }, "apiKey": { "title": "openFDA API key (optional)", "type": "string", "description": "Optional free key (open.fda.gov/apis/authentication) to raise the daily quota from 1,000 to 120,000 requests. Not required." }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 26000, "type": "integer", "description": "How many records to return (openFDA caps deep paging at ~25,000).", "default": 100 } } }, "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 } } } } } } } } } } ```