Search recalls
search_recallsUse this when the user wants product recalls, a recall list, or a consumer product recall search. Searches live consumer-product data by keyword and dates touching at most 15 calendar years since 2000; previews up to 20 rows and exports the newest 2,000 to XLSX and CSV. Do not use for food, drugs or vehicle recalls.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_recalls"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date_to | No | Inclusive YYYY-MM-DD no later than today UTC; defaults to today UTC. Example: 2026-10-21. | |
| keywords | No | Product, brand, hazard, UPC or model keywords; blank lists the date range. Example: laminator. | |
| match_in | No | Field for word matching; default any. Example: hazard. | |
| date_from | No | Inclusive YYYY-MM-DD from 2000, defaults to 365 days before date_to. Example: 2026-10-01. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| rows | Yes | ||
| source | Yes | ||
| date_to | Yes | ||
| coverage | Yes | ||
| keywords | Yes | ||
| match_in | Yes | ||
| date_from | Yes | ||
| downloads | Yes | ||
| source_url | Yes | ||
| total_count | Yes | ||
| failed_years | Yes | ||
| retrieved_utc | Yes | ||
| exported_count | Yes |