# USDA FSIS Recalls Scraper (`crawlerbros/usda-fsis-recalls-scraper`) Actor

Scrape USDA Food Safety and Inspection Service (FSIS) recall data - meat, poultry, and egg product recalls and public health alerts. Search by keyword, establishment, state, or classification; filter by recall type, reason, processing category, and date range.

- **URL**: https://apify.com/crawlerbros/usda-fsis-recalls-scraper.md
- **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community)
- **Categories:** Automation, News, 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 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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

## USDA FSIS Recalls Scraper

Scrape USDA Food Safety and Inspection Service (FSIS) recall data — meat, poultry, and egg product recalls and public health alerts regulated by USDA. Search by keyword, recalling establishment, state, or classification; filter by recall type, reason, processing category, date range, and outbreak linkage. Pulls the full public FSIS recall feed directly, no login or API key required.

> Looking for FDA recalls (most other foods, drugs, cosmetics, medical devices)? See the separate **FDA Recalls Scraper** — this actor covers only meat/poultry/egg products regulated by USDA's FSIS.

### What this actor does

- **Five modes:** `recent`, `search`, `byEstablishment`, `byState`, `byClassification`
- **Rich filters:** classification, recall type, recall reason(s), processing categories, states, date range, active-only, outbreak-related-only, has-Spanish-version-only, language (English/Spanish/Any)
- **Full recall detail:** cleaned plain-text summary, official recall document PDF links (labels, retail lists, import lists), media/company contacts, affected states, product descriptions
- **Sorted newest-first** by recall date
- **Empty fields are omitted** — every record only contains fields FSIS actually populated

### Output per recall

- `recallNumber`, `title`
- `language` — `English` or `Spanish` (which language version of the notice this record is)
- `recallType` — Active Recall / Closed Recall / Public Health Alert
- `classification` — Class I / Class II / Class III / Public Health Alert
- `riskLevel`
- `recallReasons[]`
- `recallDate`, `lastModifiedDate`, `year`, `closedYear`
- `establishments[]` — recalling company/establishment name(s)
- `states[]` — distribution states (or `Nationwide`/`Midwest`)
- `processingCategories[]`
- `productItems[]` — affected product descriptions
- `summary` — cleaned plain-text press release
- `recallUrl` — canonical FSIS recall page
- `labelPdfUrls[]` — official recall document PDFs (product labels, retail-distribution lists, import lists, etc.) linked from the press release, when FSIS published one
- `mediaContact`, `companyMediaContact[]`
- `activeNotice`, `archived`, `outbreakRelated`, `hasSpanishVersion` — booleans
- `qtyRecovered`
- `sourceUrl`, `recordType: "recall"`, `scrapedAt`

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | string | `recent` | `recent` / `search` / `byEstablishment` / `byState` / `byClassification` |
| `keyword` | string | `chicken` | Free-text query over title/summary/product/establishment (mode=search) |
| `establishmentName` | string | – | Partial match on recalling company (mode=byEstablishment) |
| `language` | string | `English` | `English` / `Spanish` / `Any` — FSIS publishes a separate full record per language, sharing the same recall number |
| `states` | array | – | US states/territories, or `Nationwide`/`Midwest` (mode=byState) |
| `classification` | string | – | Class I / Class II / Class III / Public Health Alert (mode=byClassification) |
| `recallType` | string | – | Active Recall / Closed Recall / Public Health Alert |
| `recallReasons` | array | – | One or more of the 9 FSIS recall reasons |
| `processingCategories` | array | – | One or more of the 10 FSIS processing categories |
| `dateFrom` / `dateTo` | string | – | `YYYY-MM-DD` recall-date bounds |
| `activeOnly` | bool | `false` | Only currently-active recalls |
| `outbreakRelatedOnly` | bool | `false` | Only recalls linked to an outbreak investigation |
| `hasSpanishOnly` | bool | `false` | Only recalls with a Spanish-language notice |
| `maxItems` | int | `50` | Hard cap (1–2000) |
| `proxyConfiguration` | object | Apify Proxy (AUTO) | Optional; not required for access (see Data Source below) |

#### Example: recent recalls (no filters)

```json
{ "mode": "recent", "maxItems": 20 }
````

#### Example: keyword search with classification + date range

```json
{
  "mode": "search",
  "keyword": "listeria",
  "classification": "Class I",
  "dateFrom": "2024-01-01",
  "dateTo": "2025-12-31",
  "maxItems": 100
}
```

#### Example: all recalls from a specific establishment

```json
{ "mode": "byEstablishment", "establishmentName": "Tyson", "maxItems": 50 }
```

#### Example: active recalls distributed to specific states

```json
{
  "mode": "byState",
  "states": ["California", "Texas", "Nationwide"],
  "activeOnly": true
}
```

### Use cases

- **Food safety monitoring** — track meat/poultry/egg recalls by company, region, or hazard type
- **Compliance / supply-chain risk** — screen suppliers/establishments for recall history
- **Consumer safety apps** — surface active recalls relevant to a shopper's state
- **Public health research** — analyze recall reasons and outbreak linkage trends over time
- **Journalism** — track high-classification recalls and affected retailers

### Data source & reliability notes

Data comes directly from FSIS's public recall feed (`fsis.usda.gov/fsis/api/recall/v/1`), which is unauthenticated and requires no registration. The `fsis.usda.gov` domain is protected by Akamai bot management: requests from plain HTTP clients (`curl`, `httpx`, `requests`) with no browser TLS fingerprint are blocked with a 403 from Akamai's edge — regardless of source IP, User-Agent header, or Referer. This actor uses `curl_cffi` with Chrome TLS impersonation, which the upstream site accepts, so no API key, login, cookies, or paid proxy tier is needed. An optional Apify Proxy (`AUTO` group, free) input is offered for additional resilience but is not required for the actor to return data.

**Known caveat:** the same Akamai protection also blocks plain, non-impersonated `curl` checks against `recallUrl` and `labelPdfUrls` pages (403 from a clean shell). These URLs are genuine and load normally in any real browser or Chrome-impersonating HTTP client — this is a site-wide anti-bot posture, not a broken link.

### FAQ

**What's the difference between this and the FDA Recalls Scraper?** FDA and USDA-FSIS are separate US regulatory agencies with non-overlapping food categories. FSIS regulates meat, poultry, and processed egg products; FDA regulates virtually everything else (produce, seafood, packaged/prepared foods, dietary supplements, drugs, cosmetics, medical devices). If a recall involves raw or processed meat/poultry/eggs, it's FSIS; otherwise it's FDA.

**How far back does the data go?** The feed includes recalls from 2014 through the present, refreshed by FSIS as new recalls and public health alerts are issued.

**What's a "Public Health Alert"?** A notice FSIS issues when a product poses a health risk but a formal recall isn't requested — often because the product is no longer available for purchase.

**What's the difference between `classification` and `riskLevel`?** They're closely related FSIS fields: `classification` is the formal recall class (Class I/II/III or Public Health Alert); `riskLevel` is FSIS's plain-language risk label (e.g. "High - Class I"). Both are included since FSIS publishes them as distinct fields.

**Why might `labelPdfUrls` be empty on some records?** FSIS doesn't publish a document PDF (product label, retail-distribution list, import list, etc.) for every recall (older/simpler recalls often omit it). The field is populated only when FSIS embedded a PDF link — of any of these document types — in the official press release.

**How fresh is the data?** As fresh as FSIS's own feed — recalls and public health alerts typically appear within hours of being issued.

**Why is there a `language` field/filter, and why does it default to English-only?** FSIS's feed contains a fully separate record for the Spanish translation of many recalls (same `recallNumber`, translated title/summary/product text, `language: "Spanish"`). Without filtering, an English recall and its Spanish translation would appear as two near-duplicate records. The default (`English`) returns one record per recall; set `language` to `Spanish` or `Any` if you want the translated notices too.

# Actor input Schema

## `mode` (type: `string`):

How to look up recalls.

## `keyword` (type: `string`):

Search term matched against the recall title, summary, product description, and establishment name. Used in `search` mode.

## `establishmentName` (type: `string`):

Filter recalls by the recalling establishment or company name (partial match). Required for `byEstablishment` mode.

## `language` (type: `string`):

FSIS publishes a separate full record for the Spanish-language translation of many recalls, sharing the same recall number as the English original. Choose which language version(s) to include.

## `states` (type: `array`):

Filter recalls distributed to these US states/territories, or nationwide/regional distributions. Required for `byState` mode; optional filter in other modes.

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

Class I = health hazard (high risk). Class II = may cause adverse health consequences. Class III = unlikely to cause harm. Required for `byClassification` mode; optional filter otherwise.

## `recallType` (type: `string`):

Filter by recall status/type.

## `recallReasons` (type: `array`):

Filter by one or more reasons for recall.

## `processingCategories` (type: `array`):

Filter by product processing category.

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

Only include recalls announced on or after this date. Format: YYYY-MM-DD.

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

Only include recalls announced on or before this date. Format: YYYY-MM-DD.

## `activeOnly` (type: `boolean`):

Only include recalls currently marked active (not yet closed/archived).

## `outbreakRelatedOnly` (type: `boolean`):

Only include recalls FSIS has linked to a foodborne illness outbreak investigation.

## `hasSpanishOnly` (type: `boolean`):

Only include recalls that have a Spanish-language notice available.

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

Maximum number of recall records to return.

## `proxyConfiguration` (type: `object`):

Optional proxy configuration. FSIS is protected by Akamai bot management that blocks plain HTTP clients regardless of IP, so this actor uses browser TLS impersonation rather than relying on proxy for access; proxy is offered only for extra resilience and is not required.

## Actor input object example

```json
{
  "mode": "recent",
  "keyword": "chicken",
  "language": "English",
  "states": [],
  "recallReasons": [],
  "processingCategories": [],
  "activeOnly": false,
  "outbreakRelatedOnly": false,
  "hasSpanishOnly": false,
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `records` (type: `string`):

Dataset containing all scraped FSIS recall records.

# 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 = {
    "mode": "recent",
    "keyword": "chicken",
    "language": "English",
    "activeOnly": false,
    "outbreakRelatedOnly": false,
    "hasSpanishOnly": false,
    "maxItems": 20
};

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

# Prepare the Actor input
run_input = {
    "mode": "recent",
    "keyword": "chicken",
    "language": "English",
    "activeOnly": False,
    "outbreakRelatedOnly": False,
    "hasSpanishOnly": False,
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("crawlerbros/usda-fsis-recalls-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 '{
  "mode": "recent",
  "keyword": "chicken",
  "language": "English",
  "activeOnly": false,
  "outbreakRelatedOnly": false,
  "hasSpanishOnly": false,
  "maxItems": 20
}' |
apify call crawlerbros/usda-fsis-recalls-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=crawlerbros/usda-fsis-recalls-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "USDA FSIS Recalls Scraper",
        "description": "Scrape USDA Food Safety and Inspection Service (FSIS) recall data - meat, poultry, and egg product recalls and public health alerts. Search by keyword, establishment, state, or classification; filter by recall type, reason, processing category, and date range.",
        "version": "1.0",
        "x-build-id": "UegSxnzkKzI2z8qdJ"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/crawlerbros~usda-fsis-recalls-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-crawlerbros-usda-fsis-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/crawlerbros~usda-fsis-recalls-scraper/runs": {
            "post": {
                "operationId": "runs-sync-crawlerbros-usda-fsis-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/crawlerbros~usda-fsis-recalls-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-crawlerbros-usda-fsis-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",
                "required": [
                    "mode"
                ],
                "properties": {
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "recent",
                            "search",
                            "byEstablishment",
                            "byState",
                            "byClassification"
                        ],
                        "type": "string",
                        "description": "How to look up recalls.",
                        "default": "recent"
                    },
                    "keyword": {
                        "title": "Keyword",
                        "type": "string",
                        "description": "Search term matched against the recall title, summary, product description, and establishment name. Used in `search` mode.",
                        "default": "chicken"
                    },
                    "establishmentName": {
                        "title": "Establishment / Company Name",
                        "type": "string",
                        "description": "Filter recalls by the recalling establishment or company name (partial match). Required for `byEstablishment` mode."
                    },
                    "language": {
                        "title": "Language",
                        "enum": [
                            "English",
                            "Spanish",
                            "Any"
                        ],
                        "type": "string",
                        "description": "FSIS publishes a separate full record for the Spanish-language translation of many recalls, sharing the same recall number as the English original. Choose which language version(s) to include.",
                        "default": "English"
                    },
                    "states": {
                        "title": "States",
                        "type": "array",
                        "description": "Filter recalls distributed to these US states/territories, or nationwide/regional distributions. Required for `byState` mode; optional filter in other modes.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "Alabama",
                                "Alaska",
                                "American Samoa",
                                "Arizona",
                                "Arkansas",
                                "California",
                                "Colorado",
                                "Connecticut",
                                "Delaware",
                                "District of Columbia",
                                "Florida",
                                "Georgia",
                                "Guam",
                                "Hawaii",
                                "Idaho",
                                "Illinois",
                                "Indiana",
                                "Iowa",
                                "Kansas",
                                "Kentucky",
                                "Louisiana",
                                "Maine",
                                "Maryland",
                                "Massachusetts",
                                "Michigan",
                                "Midwest",
                                "Minnesota",
                                "Mississippi",
                                "Missouri",
                                "Montana",
                                "Nationwide",
                                "Nebraska",
                                "Nevada",
                                "New Hampshire",
                                "New Jersey",
                                "New Mexico",
                                "New York",
                                "North Carolina",
                                "North Dakota",
                                "Ohio",
                                "Oklahoma",
                                "Oregon",
                                "Pennsylvania",
                                "Puerto Rico",
                                "Rhode Island",
                                "South Carolina",
                                "South Dakota",
                                "Tennessee",
                                "Texas",
                                "Utah",
                                "Vermont",
                                "Virginia",
                                "Washington",
                                "West Virginia",
                                "Wisconsin",
                                "Wyoming"
                            ],
                            "enumTitles": [
                                "Alabama",
                                "Alaska",
                                "American Samoa",
                                "Arizona",
                                "Arkansas",
                                "California",
                                "Colorado",
                                "Connecticut",
                                "Delaware",
                                "District of Columbia",
                                "Florida",
                                "Georgia",
                                "Guam",
                                "Hawaii",
                                "Idaho",
                                "Illinois",
                                "Indiana",
                                "Iowa",
                                "Kansas",
                                "Kentucky",
                                "Louisiana",
                                "Maine",
                                "Maryland",
                                "Massachusetts",
                                "Michigan",
                                "Midwest (multi-state region)",
                                "Minnesota",
                                "Mississippi",
                                "Missouri",
                                "Montana",
                                "Nationwide",
                                "Nebraska",
                                "Nevada",
                                "New Hampshire",
                                "New Jersey",
                                "New Mexico",
                                "New York",
                                "North Carolina",
                                "North Dakota",
                                "Ohio",
                                "Oklahoma",
                                "Oregon",
                                "Pennsylvania",
                                "Puerto Rico",
                                "Rhode Island",
                                "South Carolina",
                                "South Dakota",
                                "Tennessee",
                                "Texas",
                                "Utah",
                                "Vermont",
                                "Virginia",
                                "Washington",
                                "West Virginia",
                                "Wisconsin",
                                "Wyoming"
                            ]
                        },
                        "default": []
                    },
                    "classification": {
                        "title": "Recall Classification",
                        "enum": [
                            "Class I",
                            "Class II",
                            "Class III",
                            "Public Health Alert"
                        ],
                        "type": "string",
                        "description": "Class I = health hazard (high risk). Class II = may cause adverse health consequences. Class III = unlikely to cause harm. Required for `byClassification` mode; optional filter otherwise."
                    },
                    "recallType": {
                        "title": "Recall Type",
                        "enum": [
                            "Active Recall",
                            "Closed Recall",
                            "Public Health Alert"
                        ],
                        "type": "string",
                        "description": "Filter by recall status/type."
                    },
                    "recallReasons": {
                        "title": "Recall Reasons",
                        "type": "array",
                        "description": "Filter by one or more reasons for recall.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "Import Violation",
                                "Insanitary Conditions",
                                "Misbranding",
                                "Mislabeling",
                                "Processing Defect",
                                "Produced Without Benefit of Inspection",
                                "Product Contamination",
                                "Unfit for Human Consumption",
                                "Unreported Allergens"
                            ],
                            "enumTitles": [
                                "Import Violation",
                                "Insanitary Conditions",
                                "Misbranding",
                                "Mislabeling",
                                "Processing Defect",
                                "Produced Without Benefit of Inspection",
                                "Product Contamination",
                                "Unfit for Human Consumption",
                                "Unreported Allergens"
                            ]
                        },
                        "default": []
                    },
                    "processingCategories": {
                        "title": "Processing Categories",
                        "type": "array",
                        "description": "Filter by product processing category.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "Eggs/Egg Products",
                                "Fully Cooked - Not Shelf Stable",
                                "Heat Treated - Not Fully Cooked - Not Shelf Stable",
                                "Heat Treated - Shelf Stable",
                                "Not Heat Treated - Shelf Stable",
                                "Products with Secondary Inhibitors - Not Shelf Stable",
                                "Raw - Intact",
                                "Raw - Non Intact",
                                "Thermally Processed - Commercially Sterile",
                                "Unknown"
                            ],
                            "enumTitles": [
                                "Eggs/Egg Products",
                                "Fully Cooked - Not Shelf Stable",
                                "Heat Treated - Not Fully Cooked - Not Shelf Stable",
                                "Heat Treated - Shelf Stable",
                                "Not Heat Treated - Shelf Stable",
                                "Products with Secondary Inhibitors - Not Shelf Stable",
                                "Raw - Intact",
                                "Raw - Non Intact",
                                "Thermally Processed - Commercially Sterile",
                                "Unknown"
                            ]
                        },
                        "default": []
                    },
                    "dateFrom": {
                        "title": "Recall Date From (YYYY-MM-DD)",
                        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                        "type": "string",
                        "description": "Only include recalls announced on or after this date. Format: YYYY-MM-DD."
                    },
                    "dateTo": {
                        "title": "Recall Date To (YYYY-MM-DD)",
                        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                        "type": "string",
                        "description": "Only include recalls announced on or before this date. Format: YYYY-MM-DD."
                    },
                    "activeOnly": {
                        "title": "Active recalls only",
                        "type": "boolean",
                        "description": "Only include recalls currently marked active (not yet closed/archived).",
                        "default": false
                    },
                    "outbreakRelatedOnly": {
                        "title": "Outbreak-related only",
                        "type": "boolean",
                        "description": "Only include recalls FSIS has linked to a foodborne illness outbreak investigation.",
                        "default": false
                    },
                    "hasSpanishOnly": {
                        "title": "Has Spanish-language version only",
                        "type": "boolean",
                        "description": "Only include recalls that have a Spanish-language notice available.",
                        "default": false
                    },
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 2000,
                        "type": "integer",
                        "description": "Maximum number of recall records to return.",
                        "default": 50
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Optional proxy configuration. FSIS is protected by Akamai bot management that blocks plain HTTP clients regardless of IP, so this actor uses browser TLS impersonation rather than relying on proxy for access; proxy is offered only for extra resilience and is not required.",
                        "default": {
                            "useApifyProxy": true
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
