CPSC Supplier Recall Exposure Monitor

Match recently published or updated records from the official CPSC Recall Retrieval API to a private supplier, brand, product, category, or risk-keyword scope. The Actor turns a public recall feed into a recurring supply-chain exposure workflow with deterministic reasons and lifecycle changes.

Unofficial tool: This independent Blaidlink Actor is not affiliated with, sponsored by, or endorsed by the U.S. Consumer Product Safety Commission or the U.S. government. CPSC is the authoritative source. Verify consequential inventory, legal, safety, and reporting decisions against the official recall record and qualified professionals.

What it does

• fetches a mandatory 1–31 day LastPublishDateStart window from the official keyless JSON API;
• fails closed if the API returns more than the configured bounded source ceiling;
• matches public recall fields against supplier/seller, brand, product, category, and keyword filters;
• supports any or all logic across populated filter groups;
• explains every exposure with the exact query group and public field that matched;
• stores only a hashed monitoring-scope key and public recall snapshots;
• establishes the first run as an unpriced baseline;
• labels later records new, material-change, unchanged, or scope-resolved;
• never treats absence from a rolling window as resolution.

The Actor intentionally omits CPSC's ConsumerContact field, product images, UPCs, and caller identity from output and persisted state. It does not collect private consumer reports.

Quick start

{
  "monitorId": "lighting-supply-chain",
  "supplierNames": ["Currey & Company"],
  "productTerms": ["chandelier"],
  "keywords": ["electrocution", "fire"],
  "filterMode": "any",
  "lookbackDays": 14,
  "maxSourceRecords": 500,
  "maxEvents": 50
}

Save the configuration as an Apify Task and schedule it daily or weekly. Keep the schedule interval shorter than lookbackDays. The first successful run creates the baseline; later runs surface new or changed exposure.

Filter behavior

Input	Public fields checked
supplierNames	manufacturer, importer, distributor, retailer
brandNames	title, description, product name/description/model/type
productTerms	product name, description, model, type
categoryIds	product CategoryID
keywords	title, description, product, hazard, remedy

Matching is case-insensitive, accent-insensitive substring matching. With filterMode: "all", every populated group must match; terms within a group are alternatives. Output reasons are ordered supplier → brand → product → category → keyword, then normalized query order.

Lifecycle semantics

• baseline: matching public record seen on the first successful run; not a proposed billable event.
• new: a matching recall ID not present in an initialized scope.
• material-change: a matched recall's title, description, product, company, retailer, hazard, remedy, or injury fields changed.
• unchanged: same material snapshot; emitted only when requested.
• scope-resolved: a republished record was retrieved but no longer matches the configured scope. This does not mean the official recall ended or the hazard was remedied.

CPSC notes that remedy information can change. LastPublishDateStart allows updated official records to re-enter the bounded window. A recall simply aging outside that window remains active in state and is not falsely resolved.

Live pricing

The public Apify Store listing uses pay-per-event pricing:

• new-recall-exposure: $0.05 per delivered new exposure;
• material-recall-change: $0.03 per delivered material update;
• baseline, unchanged, scope-resolved, and summary: $0.00 Blaidlink lifecycle-event fee;
• Apify platform usage is currently absorbed by the creator rather than billed separately to the customer.

Apify also applies its small synthetic Actor-start and default-dataset-item events. The Store pricing panel is the authoritative checkout display.

The runtime only invokes named charging events if the platform reports an active pay-per-event configuration. Otherwise all local and unpriced builds use ordinary dataset writes. State advances only after all lifecycle candidates are delivered, preventing a charge/output cap from silently consuming unseen events.

Official source and limits

• CPSC Recall API information
• CPSC Recall Retrieval Web Services Programmer's Guide
• Official recalls

The official API performs wildcard searches and warns that misspelled parameters may return the full historical corpus. This Actor uses only documented LastPublishDateStart and format=json parameters and enforces a response ceiling. CPSC data may be corrected or republished. A match is an exposure-review lead, not proof of a supplier relationship, legal duty, product ownership, harm, liability, or required action.

Development

npm install
npm test
npm run validate:live

The live validation script makes one bounded official query and applies three local scopes to that shared response. It does not deploy, publish, create an account, or configure pricing.