# FDA Recalls Scraper – openFDA Enforcement API (`unnoted/openfda-recalls`) Actor

Get FDA recall enforcement reports for drugs, medical devices and food from openFDA. Search by product, firm or reason and filter by class I, II or III, status and date. Recall number, firm, product, reason, quantity, distribution and dates. Unofficial.

- **URL**: https://apify.com/unnoted/openfda-recalls.md
- **Developed by:** [Unnoted](https://apify.com/unnoted) (community)
- **Categories:** AI, Other
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 1,000 recalls

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does FDA Recalls Scraper – openFDA Enforcement API do?

FDA Recalls Scraper reads FDA's recall enforcement reports through openFDA and returns each drug, medical device or food recall as one typed row: recall number, class, status, recalling firm, product, reason, quantity, codes, distribution and dates, newest first, filtered by product, firm, class, status or date.

Unofficial, not affiliated with openFDA.

**Main features:** search by keyword, up to 100,000 recalls per run, no login needed, export to JSON, CSV or Excel, and full API and scheduling support on Apify.

### What data can you get from openFDA?

Each recall is one row with these fields:

| Field | Description |
|---|---|
| `recallingFirm` | Company that recalled the product (always filled) |
| `productDescription` | Product as FDA describes it: name, strength, package, NDC or UPC (always filled) |
| `recallNumber` | FDA recall number, e.g. D-0860-2026 (D drugs, Z devices, F or H food); empty on the rare recall FDA has not numbered yet |
| `eventId` | FDA recall event id; one event can cover several recall numbers |
| `category` | drug, device or food |
| `productType` | FDA product type: Drugs, Devices or Food |
| `status` | Ongoing, Completed or Terminated |
| `classification` | Class I, Class II, Class III or Not Yet Classified |
| `reasonForRecall` | Why the product was recalled |
| `productQuantity` | Quantity recalled as FDA lists it, e.g. 1,990 bottles |
| `codeInfo` | Lot numbers, expiry dates and other codes of the recalled units |
| `distributionPattern` | Where the product was distributed, e.g. Nationwide or a list of states and countries |
| `voluntaryMandated` | Voluntary: Firm initiated, or FDA Mandated |
| `initialFirmNotification` | How the firm first notified its customers, e.g. Letter, E-Mail, Press Release |
| `city` | Recalling firm's city |
| `state` | Recalling firm's state (US) or region |
| `country` | Recalling firm's country |
| `recallInitiationDate` | When the firm started the recall (YYYY-MM-DD) |
| `centerClassificationDate` | When FDA classified the recall (YYYY-MM-DD) |
| `reportDate` | When the recall appeared in FDA's weekly enforcement report (YYYY-MM-DD) |
| `terminationDate` | When FDA terminated the recall (YYYY-MM-DD); empty while it is open |
| `brandNames` | Brand names matched by openFDA (drugs; often empty) |
| `genericNames` | Generic names matched by openFDA (drugs; often empty) |
| `manufacturerNames` | Manufacturers matched by openFDA (drugs; often empty) |
| `productNdcs` | National Drug Codes matched by openFDA (drugs; often empty) |
| `scrapedAt` | When the recall was collected (ISO 8601) |

### How to scrape openFDA with FDA Recalls Scraper – openFDA Enforcement API

1. Open FDA Recalls Scraper – openFDA Enforcement API on Apify and go to the **Input** tab.
2. In **Category**, enter `drug`.
3. In **Max recalls**, enter `100`.
4. Click **Start** and wait for the run to finish. A small run like this one takes under a minute.
5. Open the **Output** tab to see the results, or download them as JSON, CSV, Excel or HTML.

### Input

See the **Input** tab for every option. The fields:

| Field | Name | What it does | Default |
|---|---|---|---|
| `category` | Category | Which FDA enforcement reports to read. "All three" splits Max recalls between drugs, devices and food. Options: `drug` (Drugs), `device` (Medical devices), `food` (Food and dietary supplements), `all` (All three). | `"drug"` |
| `searchText` | Product, firm or reason | Only recalls whose product, brand or generic name, recalling firm or reason contains these words, e.g. metformin, Pfizer, salmonella or insulin pump. Empty means every recall. |  |
| `classification` | Recall class | Only recalls of this FDA class. Class I: a reasonable chance of serious harm or death; class II: temporary or reversible harm; class III: unlikely to cause harm. Options: `any` (Any class), `I` (Class I (most serious)), `II` (Class II), `III` (Class III (least serious)). | `"any"` |
| `status` | Recall status | Only recalls with this status. Ongoing: still in progress; completed: the firm has finished; terminated: FDA has closed it. Options: `any` (Any status), `Ongoing` (Ongoing), `Completed` (Completed), `Terminated` (Terminated). | `"any"` |
| `dateFrom` | From date | Only recalls on or after this date (YYYY-MM-DD, e.g. 2025-01-01). Empty means no lower bound. |  |
| `dateTo` | To date | Only recalls on or before this date (YYYY-MM-DD). Empty means up to today. |  |
| `dateType` | Date to filter on | Which date From and To apply to. Results always come newest report first. Options: `reportDate` (Report date (when FDA published it)), `recallInitiationDate` (Recall initiation date (when the firm started it)). | `"reportDate"` |
| `apiKey` | openFDA API key (optional) | Optional: your own free openFDA key, for large or frequent runs. |  |
| `maxItems` | Max recalls | Maximum number of recalls in total. You pay only for recalls saved. | `100` |

Example input:

```json
{
  "category": "drug",
  "maxItems": 100
}
```

### Output

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel. One real result:

```json
{
  "recallNumber": "D-0860-2026",
  "recallingFirm": "Sterling Pharmaceutical Services LLC",
  "productDescription": "TRP The Relief Products* Gentle Eyes Lubricant Eye Drops, Carboxymethylcellulose sodium 0.5%, Sterile Eye Drops, 0.5 FL OZ (15 mL) bottles, Manufactured exclusively for TRP Company, Inc. 1575 Delucci Ln, Reno, NV 89502, NDC 17312-430-15.",
  "eventId": "99712",
  "category": "drug",
  "productType": "Drugs",
  "status": "Ongoing",
  "classification": "Class II",
  "reasonForRecall": "Lack of Assurance of Sterility",
  "productQuantity": "14538 bottles",
  "codeInfo": "Lot # 3279, Exp 6/30/2027; Lot # 3292, Exp 5/31/2027.",
  "distributionPattern": "USA Nationwide",
  "voluntaryMandated": "Voluntary: Firm initiated",
  "initialFirmNotification": "Letter",
  "city": "Dupo",
  "state": "IL",
  "country": "United States",
  "recallInitiationDate": "2026-08-20",
  "centerClassificationDate": "2026-09-21",
  "reportDate": "2026-09-30",
  "terminationDate": null,
  "brandNames": [
    "GENTLE EYES LUBRICANT EYE DROPS"
  ],
  "genericNames": [
    "CARBOXYMETHYLCELLULOSE SODIUM"
  ],
  "manufacturerNames": [
    "TRP Company"
  ],
  "productNdcs": [
    "17312-430"
  ],
  "scrapedAt": "2026-10-08T22:46:25.179Z"
}
```

### How much does it cost to scrape openFDA?

FDA Recalls Scraper – openFDA Enforcement API uses pay-per-event pricing: **$2.50 per 1,000 recalls** (Recall). You pay only for recalls saved to the dataset; platform usage is included in the price. Each run also has Apify's standard start fee of a fraction of a cent.

| Recalls | Price |
|---|---|
| 100 | $0.25 |
| 1,000 | $2.50 |
| 10,000 | $25.00 |

Set **Max items** (and the run's maximum cost in the run options) to cap what a run can spend. The run stops when either limit is reached.

### Use cases

- **Pharmacy and hospital safety:** pull every class I and II drug recall reported this week and check the lot codes against your stock.
- **Supplier and vendor monitoring:** track recalls by your suppliers or competitors by firm name, across drugs, devices and food.
- **Regulatory and quality research:** count recalls by reason (contamination, sterility, labelling) and class over the years.
- **Food safety alerts:** schedule a daily run for ongoing class I food recalls and send new ones to Slack, email or Google Sheets.
- **Market and legal research:** build a recall history for a product, brand or ingredient such as metformin, insulin pumps or salmonella.

### Tips

- Set From date to last week's date and schedule the run weekly: FDA publishes its enforcement report every Wednesday.
- Search one product word or a short phrase, e.g. metformin or insulin pump; the words must appear together.
- Use "All three" categories with a firm name to see a company's drug, device and food recalls in one run.
- For runs of many thousands of recalls, or several runs a day, add your own free openFDA API key.
- brandNames, genericNames, manufacturerNames and productNdcs are filled only for drug recalls that openFDA could match to a product label.

### FAQ

#### Is it legal to scrape openFDA?

FDA Recalls Scraper – openFDA Enforcement API collects only data that openFDA shows publicly to every visitor, and it leaves out personal data such as private profiles and contact details. Our Actors are ethical and do not extract private user data. Results could still contain personal data in titles or descriptions written by uploaders. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You are responsible for how you use the data.

#### Can I use it through an API?

Yes. Every Apify Actor has an API: start runs, pass input and read results over HTTP, or use the JavaScript and Python clients. See the **API** tab on the Actor page for ready-made examples.

#### Can I schedule runs and connect other apps?

Yes. Use Apify **Schedules** to run FDA Recalls Scraper – openFDA Enforcement API every hour, day or week, and integrations (Make, Zapier, Google Sheets, webhooks and more) to send the results where you need them.

#### Why did I get fewer results than expected?

The run stops at **Max items** or at the run's maximum cost, whichever comes first. openFDA may also return fewer results for rare search terms. Duplicates across search terms are saved once. Check the run's `RUN_SUMMARY` record in the key-value store for the inputs that returned nothing.

#### What if it stops working?

Sites change. We run a daily check of our own and fix breakages quickly. If something looks wrong, open an issue in the **Issues** tab with the run link and we'll look at it.

#### How many recalls are there?

About 18,000 drug, 40,000 medical device and 29,000 food recalls, reported from June 2012 to the latest weekly report. Set Max recalls above the count to get them all.

#### What do class I, II and III mean?

Class I: a reasonable chance that the product will cause serious harm or death. Class II: it may cause temporary or medically reversible harm. Class III: it is unlikely to cause harm.

#### Do I need an openFDA API key?

No. Without one, openFDA allows 1,000 requests a day per IP address, and each request gets up to 1,000 recalls. The servers this Actor runs on are shared with other users, so for large or frequent runs add your own free key from open.fda.gov.

#### Is the data free to reuse?

openFDA data is US government public data. FDA asks you not to rely on it for medical decisions and to treat it as unvalidated; see open.fda.gov/terms.

### Not included

No personal data: recalls name companies, not people, and no patient or adverse-event reports are included. The recalling firm's street address is left out (city, state and country are kept). FDA press releases and recall notices are not included.

### More Actors from us

- [AliExpress Search Scraper – Products & Prices](https://apify.com/unnoted/aliexpress-product-search)
- [BBB Scraper – Business Ratings & Accreditation](https://apify.com/unnoted/bbb-business-search)
- [Bilibili Scraper – Video Search & Stats API](https://apify.com/unnoted/bilibili-video-scraper)
- [Bumeran Jobs Scraper – LATAM Job Listings](https://apify.com/unnoted/bumeran-job-listings)
- [Foundit Jobs Scraper – India Job Listings API](https://apify.com/unnoted/foundit-job-listings)
- [Google Jobs Scraper – Job Listings API](https://apify.com/unnoted/google-jobs-listings)
- [Google Play Reviews Scraper – App Reviews API](https://apify.com/unnoted/google-play-reviews-scraper)
- [Google Trends Scraper – Interest & Related Queries](https://apify.com/unnoted/google-trends-data)
- [Idealo Scraper – Price Comparison Data](https://apify.com/unnoted/idealo-price-search)
- [Kleinanzeigen Scraper – Listings & Prices](https://apify.com/unnoted/kleinanzeigen-listings-scraper)
- [Mercari Japan Scraper – Listings & Prices API](https://apify.com/unnoted/mercari-japan-search)
- [Resident Advisor Scraper – RA Event Listings](https://apify.com/unnoted/resident-advisor-events)
- [Sainsbury's Scraper – UK Grocery Prices](https://apify.com/unnoted/sainsburys-grocery-search)
- [Tokopedia Scraper – Product Search & Prices](https://apify.com/unnoted/tokopedia-product-search)
- [Workday Jobs Scraper – Any Careers Site](https://apify.com/unnoted/workday-jobs-scraper)
- [Yandex Maps Scraper – Places & Business Data](https://apify.com/unnoted/yandex-maps-places)

# Actor input Schema

## `category` (type: `string`):

Which FDA enforcement reports to read. "All three" splits Max recalls between drugs, devices and food.

## `searchText` (type: `string`):

Only recalls whose product, brand or generic name, recalling firm or reason contains these words, e.g. metformin, Pfizer, salmonella or insulin pump. Empty means every recall.

## `classification` (type: `string`):

Only recalls of this FDA class. Class I: a reasonable chance of serious harm or death; class II: temporary or reversible harm; class III: unlikely to cause harm.

## `status` (type: `string`):

Only recalls with this status. Ongoing: still in progress; completed: the firm has finished; terminated: FDA has closed it.

## `dateFrom` (type: `string`):

Only recalls on or after this date (YYYY-MM-DD, e.g. 2025-01-01). Empty means no lower bound.

## `dateTo` (type: `string`):

Only recalls on or before this date (YYYY-MM-DD). Empty means up to today.

## `dateType` (type: `string`):

Which date From and To apply to. Results always come newest report first.

## `apiKey` (type: `string`):

Your own free openFDA key (open.fda.gov/apis/authentication). Without one, openFDA allows 1,000 requests a day per IP address, which other users of the same servers share; a key raises it to 120,000 a day.

## `maxItems` (type: `integer`):

Maximum number of recalls in total. You pay only for recalls saved.

## Actor input object example

```json
{
  "category": "drug",
  "classification": "any",
  "status": "any",
  "dateType": "reportDate",
  "maxItems": 100
}
```

# Actor output Schema

## `results` (type: `string`):

One item per recall.

## `runSummary` (type: `string`):

Items saved, inputs done, and how complete each field was.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "category": "drug",
    "maxItems": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("unnoted/openfda-recalls").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "category": "drug",
    "maxItems": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("unnoted/openfda-recalls").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "category": "drug",
  "maxItems": 100
}' |
apify call unnoted/openfda-recalls --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,unnoted/openfda-recalls"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/bddpAsK6v0xlP3sVL/builds/bfDiXyhEhPRye8cJw/openapi.json
