Product Recall Risk Scorer

Return complete public product and medical-device recall records with normalized risk scores, recommended actions, and official source evidence.

Production behavior

• Retrieves the complete public CPSC Recall API response.
• Retrieves openFDA's complete dated and missing-date populations separately. Dated recalls are divided into disjoint yearly partitions through the current year and each partition follows natural skip pagination; the missing-date partition does the same. This stays below openFDA's per-query skip boundary and avoids its failing or inconsistent search-after links without dropping records.
• Emits one buyer-visible dataset row and one recall-alert event per delivered recall.
• Has no Actor-side result, per-source, spend-derived, or overall-run output cap.
• Stops paid delivery only when Apify reports the buyer's spending limit.
• Continues with the remaining configured sources if one provider is temporarily unavailable, and records the source error in RUN-SUMMARY instead of discarding already delivered results.
• Preserves stable record IDs and supports optional sinceLastRun state for buyer-created recurring tasks; ordinary runs default to the complete current sources.

The default production input leaves watchlistTerms empty, so every available record is delivered. Buyers may add product or brand terms when they intentionally want a narrower result set. Optional startUrls can add public or user-authorized recall JSON sources; they do not replace the built-in official sources.

Non-billable sample

{
  "sourceMode": "sample",
  "outputMode": "sample-records"
}

Sample mode emits one deterministic schema-valid record without a paid event. It exists only for Store and release-gate inspection.

Output

Every default-dataset record includes:

• entityName, signalType, summary, and recommendedAction
• recordId and dedupeKey
• sourceName, sourceUrl, and evidenceUrl
• retrievedAt, score, confidence, and scoreReasons
• errors and runSummary

Source-specific recall fields such as product, brand, hazard, remedy, recall date, risk status, and product code are included when available. Missing source values remain null; they are not invented. openFDA records are unvalidated decision-support data and do not replace medical advice or review of the official record.

Sources and access boundary

• CPSC Recall API: https://www.saferproducts.gov/RestWebServices/Recall?format=json
• openFDA Device Recall API: https://api.fda.gov/device/recall.json
• Optional public or user-authorized JSON URLs supplied through startUrls

The Actor does not bypass authentication, access controls, CAPTCHAs, paywalls, or private-source authorization.

Existing Actor identity

• Owner: zentrafoundry
• Actor ID: 5TSQ4m6t6Fv15ajt8
• Slug: product-recall-risk-scorer
• Store URL: https://apify.com/zentrafoundry/product-recall-risk-scorer

This package updates that exact existing public Actor in place. It does not create, clone, upsert, duplicate, draft, privatize, reprice, or change listing content.