Product Safety Market Action Portfolio Report

Buyer: product safety, quality, legal, and operations teams that need a small, source-linked queue of new or changed public safety records across a product or vehicle portfolio. Input: CPSC and NHTSA watchlists plus an isolated monitorKey. Output: a report-first portfolio row, optional raw safety records, market-action alerts, and an optional export row.

This actor uses only the official public CPSC Recalls REST API and official public NHTSA Recalls and Complaints APIs. It does not use search engines, retailer pages, manufacturer pages, social media, private feeds, or third-party safety databases.

Run the next report

• Inspect CPSC recall evidence with CPSC Product Recall Marketplace Watch Scraper.
• Inspect NHTSA recall and complaint evidence with NHTSA Recall Complaint Watch Scraper.

Input

{
  "watchlists": [
    {
      "id": "children-products",
      "name": "Children product safety watch",
      "agency": "CPSC",
      "productNames": ["toy"],
      "keywords": ["choking", "burn"],
      "lookbackDays": 30
    },
    {
      "id": "vehicle-watch",
      "name": "Honda Accord watch",
      "agency": "NHTSA",
      "make": "Honda",
      "model": "Accord",
      "modelYear": 2020,
      "recordTypes": ["recall", "complaint"]
    }
  ],
  "monitorKey": "buyer-portfolio-1",
  "initialRunMode": "baseline_only",
  "generateReport": true,
  "emitRawRows": true,
  "emitUnchanged": false,
  "maxChargeUsd": 25,
  "dryRun": false
}

The eight control fields shown above are required. CPSC watchlists need a product, brand, category, keyword, or recall selector. NHTSA watchlists need a make/model/model year, campaign number, or ODI number. NHTSA vehicle watchlists query recalls and complaints by default; set recordTypes or includeComplaints to narrow them.

monitorKey is the state namespace. Keep it stable for a scheduled monitor and change it for an independent baseline. initialRunMode accepts baseline_only, emit_current_window, or emit_backfill. emitExport is optional and adds the $5 export event when a change exists. Network timeout, retry, rate-limit, webhook, and idempotency controls are optional.

Output

Rows use rowType values product_safety_portfolio_report, safety_record, market_action_alert, and product_safety_export. Every billable row carries a deterministic stableKey, idempotencyKey, official source URLs, limitations, and prohibitedInterpretations.

The report row is emitted first. A safety record row includes normalized CPSC or NHTSA fields only when emitRawRows is enabled. An alert row is created for each new or changed matched record. NHTSA complaints are labeled signalOnly; they are not treated as proof of a defect. The output also contains deliveryAudit with planned and captured event prices, charge counts, idempotency keys, budget, delivery status, and state-commit status.

Run patterns

1. Establish a free baseline

Run the same watchlists with initialRunMode: "baseline_only" and dryRun: false. The actor fetches official data, saves the fingerprint snapshot, and emits zero rows and zero charges.

2. Monitor the current window

Use initialRunMode: "emit_current_window" on a first run only when first-window records should be delivered. Later runs compare the official record fingerprints. New or changed records produce the configured report, alerts, and optional raw/export rows. A fully unchanged run always emits zero rows and zero charges, including when emitUnchanged is true.

3. Review a historical backfill

Use initialRunMode: "emit_backfill" for an explicit first-run delivery of all records returned by the official APIs. Set a buyer-approved maxChargeUsd; the full unique event plan is checked before any push.

Pricing

This actor uses PAY_PER_EVENT pricing and has no start or heartbeat charge.

Event	Price	When emitted
safety-record-row	$0.006	Each changed (or included unchanged-with-change) raw record when emitRawRows is true
market-action-alert	$0.20	Each new or changed matched record
product-safety-portfolio-report	$8.00	One changed portfolio report when generateReport is true
product-safety-export	$5.00	One optional changed export when emitExport is true

Baseline-only and unchanged runs are zero-row and zero-charge. Dry runs do not call the official APIs, write state, or push billable events.

Source and safety limits

Source URLs are restricted in code to saferproducts.gov/cpsc.gov and api.nhtsa.gov/nhtsa.gov. A source error for any watchlist makes the entire run non-billable and prevents state advancement. State load and save fail closed; a failed save cannot be reported as a successful run. Unknown billing events, missing chargedCount, PPE charge-limit responses, and budget overruns stop delivery.

Public recalls and complaints are evidence for review, not a safety rating, legal conclusion, defect finding, compliance certification, or proof of injury causation. Use the source-linked official record for the final decision.

Files

• INPUT_SCHEMA.json
• dataset_schema.json
• docs/source-compliance.md
• docs/integration-guide.md
• docs/store-competitive-snapshot.md
• docs/sample-output.json