# CPSC Product Recalls Scraper - SaferProducts Data (`maydit/us-product-recalls-scraper`) Actor Scrape full CPSC product recall data from SaferProducts.gov - retailers, UPCs, hazards, remedies, units affected. No API key. Export JSON/CSV for compliance monitoring. - **URL**: https://apify.com/maydit/us-product-recalls-scraper.md - **Developed by:** [Brandt May](https://apify.com/maydit) (community) - **Categories:** Business, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 results 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## CPSC Product Recalls Scraper - Full SaferProducts.gov Recall Data > The deepest, cleanest CPSC recall feed on Apify - every recall flattened to one row with retailers, UPCs, hazards, remedies, and units affected. No API key required. ### What it does This **CPSC product recalls scraper** queries the official **CPSC SaferProducts.gov recalls API** and flattens deeply nested responses into one clean record per recall. Unlike a bare keyword scraper, it returns the *full* recall detail buyers actually need for automated compliance monitoring - recalling manufacturers, importers, and **retailers**, product **UPCs**, hazard descriptions, remedy options, and units affected. You can filter by keyword, product name, manufacturer, exact recall number, or date range, then export the **US consumer product recalls dataset** to JSON, CSV, or Excel. It requires no API key because it reads a public government data source. This is the CPSC leg of a three-agency recalls suite alongside FDA and NHTSA scrapers - combine all three for a single **FDA + NHTSA + CPSC recall aggregator** feed. ### Who it's for - **Retail & e-commerce compliance teams** removing recalled SKUs from shelves and listings - **Quality assurance & product-safety teams** monitoring hazards across their catalog - **Online marketplaces** screening third-party listings against active recalls - **Insurers** assessing risk tied to recalled products and reported injuries - **Importers & distributors** tracking recall activity by manufacturer - **Journalists & investigators** reporting on recall trends and safety incidents ### What you get / Output Each run produces a flat dataset with one record per recall. Fields: | Field | Description | |---|---| | `recallId` | Internal CPSC recall record identifier | | `recallNumber` | Official CPSC recall number (e.g. `26596`) | | `recallDate` | Date the recall was announced | | `title` | Recall headline | | `description` | Full recall description text | | `products` | Recalled product name(s) | | `productModels` | Affected model numbers / variants | | `unitsAffected` | Number of units recalled | | `hazards` | Hazard descriptions (fire, choking, suffocation, lithium battery, etc.) | | `injuries` | Reported injuries or incidents | | `remedies` | Remedy options (refund / repair / replace) | | `manufacturers` | Recalling manufacturer(s) | | `retailers` | Where the product was sold (retailer / channel) | | `importers` | Importer(s) of record | | `upcs` | Product UPC codes | | `soldAt` | Sold-at labels / storefront details | | `imageUrl` | Product image URL | | `consumerContact` | Consumer contact info for the recall | | `url` | Official CPSC recall webpage | ### Input / How to query Set any combination of filters. Leave a field empty to skip it. | Input | What it does | |---|---| | `keyword` | Full-text match across title, description, hazard, product, manufacturer, or retailer (e.g. `fire`, `lithium battery`, `Amazon`) | | `productName` | Case-insensitive partial match on product name (e.g. `crib`, `heater`) | | `manufacturer` | Case-insensitive partial match on manufacturer (e.g. `Samsung`) | | `recallNumber` | Exact lookup of one recall by number - overrides all other filters | | `recalledSince` | Only recalls on or after this date (`YYYY-MM-DD`) | | `recalledUntil` | Only recalls on or before this date (`YYYY-MM-DD`) | Under the hood the actor walks history in year-window chunks and applies your keyword filter client-side, so date-range pulls stay complete and reliable. ### Example use cases - **E-commerce compliance sweep** - run `keyword` = `lithium battery` weekly to catch new battery-hazard recalls before they hit your marketplace listings. - **Catalog match by manufacturer** - pull every recall for a supplier via `manufacturer` = `Samsung` and reconcile against your active SKUs. - **UPC-level recall check** - export the full feed and join on the `upcs` field to flag any recalled UPC in your inventory system. - **Litigation research** - use `recallNumber` for an exact recall, or `productName` to gather all recalls for a product family with hazards, injuries, and remedies attached. - **Historical trend analysis** - set `recalledSince` and `recalledUntil` to pull a multi-year window for reporting on recall volume by hazard or category. ### Recurring use / scheduling This actor is built for automated monitoring, not one-off pulls. Use Apify **Schedules** to run it on a cron (e.g. every morning or every Monday) with a rolling `recalledSince` window so each run only returns fresh recalls. Because `recallNumber` is a stable unique key, you can deduplicate across runs by keying on `recallNumber` (or `recallId`) in your downstream store - append only records you haven't seen before, and wire new rows into alerts, a Slack/email notification, or your compliance dashboard. ### FAQ ### How do I get CPSC product recall data without an API key? This actor reads the public **CPSC SaferProducts.gov** recalls API directly - no key, no signup, no auth. Set your filters and run it; results land in an Apify dataset ready to export. ### Is there an API for SaferProducts.gov recalls? Yes - CPSC publishes a public recalls API, and this actor wraps it into a clean, flat schema. You get one row per recall with retailers, UPCs, hazards, and remedies already unpacked from the raw nested JSON. ### How can I monitor new product recalls automatically? Schedule the actor on a cron with a rolling `recalledSince` date. Each run returns recent recalls; dedupe on `recallNumber` and push new rows to an alert or dashboard for hands-off monitoring. ### How do I export CPSC recalls to CSV or Excel? Every run writes a dataset you can download as CSV, Excel, JSON, or XML from the Apify console, or pull via the Apify API for a **product recall JSON / CSV export** into your own systems. ### How do I search product recalls by UPC or manufacturer? Filter by `manufacturer` for partial-match manufacturer search, or export the full feed and match on the `upcs` field to find recalls tied to a specific UPC in your catalog. ### How do I get recall data with retailers, hazards, and remedies? Those are first-class output fields here: `retailers`, `hazards`, and `remedies` (refund / repair / replace) come on every record, along with `unitsAffected` and `injuries` - the detail most bare recall scrapers drop. ### How do I set up product recall alerts for my e-commerce store? Schedule the actor, dedupe on `recallNumber`, and connect the new rows to a notification integration (email, Slack, webhook) or your monitoring stack so your store is alerted the moment a relevant recall posts. ### What is the best way to track consumer product recalls for compliance? Run a scheduled pull filtered to your product categories or hazards, store results keyed on `recallNumber` for a clean audit trail, and reconcile the `products`, `upcs`, and `manufacturers` fields against your inventory. ### How do I pull historical CPSC recalls by date range? Set `recalledSince` and `recalledUntil` (both `YYYY-MM-DD`). The actor chunks history into year windows so multi-year pulls come back complete. ### Can I combine CPSC, FDA, and NHTSA recall data in one feed? Yes - this is the CPSC leg of a three-agency suite. Pair it with the matching FDA and NHTSA actors and merge their datasets into a single **FDA + NHTSA + CPSC recall aggregator** feed on a shared schedule. ### Data source & notes - **Source:** the official **U.S. Consumer Product Safety Commission (CPSC)** SaferProducts.gov recalls API - public U.S. government data, free to access and use. - **No API key** is required. - Coverage is limited to what CPSC publishes: consumer products (toys, appliances, electronics, furniture, nursery, sporting goods, etc.). Vehicle recalls are NHTSA's domain and food/drug/cosmetic recalls are FDA's - use the companion actors for those. - The actor reflects CPSC's own data; it does not add, infer, or correct fields beyond flattening the API response. - Actor: `maydit/us-product-recalls-scraper` (id `DqX2SMVuwVL8nPeYB`). # Actor input Schema ## `keyword` (type: `string`): Filter recalls whose title, description, hazard, product, manufacturer, or retailer mentions this term — e.g. 'fire', 'choking', 'lithium battery', 'Amazon'. Leave empty for all. ## `productName` (type: `string`): Filter by product name (case-insensitive partial match), e.g. 'bicycle', 'crib', 'heater'. Leave empty for all. ## `manufacturer` (type: `string`): Filter by manufacturer name (case-insensitive partial match), e.g. 'Samsung'. Leave empty for all. ## `recallNumber` (type: `string`): Look up one specific CPSC recall by its number (e.g. '26596'). When set, the other filters are ignored. ## `recalledSince` (type: `string`): Only recalls announced on or after this date (YYYY-MM-DD). Defaults to the last 3 years if empty. Great for weekly monitoring. ## `recalledUntil` (type: `string`): Only recalls announced on or before this date (YYYY-MM-DD). ## `maxResults` (type: `integer`): Upper bound on recalls returned per run. ## Actor input object example ```json { "keyword": "fire", "recalledSince": "2026-01-01", "maxResults": 500 } ```` # 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("maydit/us-product-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("maydit/us-product-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 '{}' | apify call maydit/us-product-recalls-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=maydit/us-product-recalls-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "CPSC Product Recalls Scraper - SaferProducts Data", "description": "Scrape full CPSC product recall data from SaferProducts.gov - retailers, UPCs, hazards, remedies, units affected. No API key. Export JSON/CSV for compliance monitoring.", "version": "1.0", "x-build-id": "peTpYLyhRMvyLJ4rg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maydit~us-product-recalls-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maydit-us-product-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/maydit~us-product-recalls-scraper/runs": { "post": { "operationId": "runs-sync-maydit-us-product-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/maydit~us-product-recalls-scraper/run-sync": { "post": { "operationId": "run-sync-maydit-us-product-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", "properties": { "keyword": { "title": "Keyword", "type": "string", "description": "Filter recalls whose title, description, hazard, product, manufacturer, or retailer mentions this term — e.g. 'fire', 'choking', 'lithium battery', 'Amazon'. Leave empty for all." }, "productName": { "title": "Product name", "type": "string", "description": "Filter by product name (case-insensitive partial match), e.g. 'bicycle', 'crib', 'heater'. Leave empty for all." }, "manufacturer": { "title": "Manufacturer", "type": "string", "description": "Filter by manufacturer name (case-insensitive partial match), e.g. 'Samsung'. Leave empty for all." }, "recallNumber": { "title": "Recall number (optional)", "type": "string", "description": "Look up one specific CPSC recall by its number (e.g. '26596'). When set, the other filters are ignored." }, "recalledSince": { "title": "Recalled since", "type": "string", "description": "Only recalls announced on or after this date (YYYY-MM-DD). Defaults to the last 3 years if empty. Great for weekly monitoring." }, "recalledUntil": { "title": "Recalled until", "type": "string", "description": "Only recalls announced on or before this date (YYYY-MM-DD)." }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Upper bound on recalls returned per run.", "default": 500 } } }, "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 } } } } } } } } } } ```