Amazon Review Defect Miner

Analyze configured public Amazon reviews or buyer-provided review records for recurring defect themes.

What this Actor does

Return explainable defect categories, severity signals, evidence snippets, and review metadata for human review.

• Analyze buyer-provided review records.
• Process configured public Amazon review URLs.
• Group recurring defect language into reviewable themes.

Who this is for

Product quality teams, Amazon sellers, Review analysts.

Input

• Demo mode is the safe default and emits one deterministic fixture.
• Live mode processes at most maxItems configured inputs.
• reviewRecords: buyer-provided review rows.
• startUrls: configured public Amazon review URLs.

Output

The default dataset uses the Actor-specific schema in .actor/DATASET_SCHEMA.json. Key fields include reviewId, reviewTitle, rating, defectCategories, severity, matchedTerms, evidenceSnippet, recommendedAction, plus exact source, status, delta, confidence, warning, and fixture/live labels.

Data sources

Registered catalog sources: none. Live inputs are buyer-provided review records or buyer-provided or explicitly approved public Amazon review URLs; those inputs are not represented as registered source IDs.

Demo run

Run examples/first-run.json. The row in examples/sample-output.json is labeled sourceStatus: fixture, isDemo: true, and is not live evidence.

Live-run behavior

Live mode processes only the configured Actor-specific inputs. Failures are returned as diagnostics or explicit errors; the runtime does not silently substitute unrelated source families.

Pricing

The runtime reads the effective Apify pay-per-event map after Actor.init() and adapts from the current result-delivery event to the already scheduled review-signal event. It stops with an explicit configuration-drift error instead of emitting unmetered output. This package never defines or changes provider pricing.

Identity and visibility safety

This package targets only zentrafoundry/amazon-review-defect-miner with Actor ID XKBZTQezjtdKLcw7z. Any future release must find exactly one authenticated inventory match and abort on identity or visibility drift. Creating, cloning, upserting, duplicating, drafting, or privatizing the Actor is forbidden.

Limitations

• Findings are heuristic signals and do not prove product safety, defect rates, or causation.
• The Actor does not bypass Amazon access controls or process private account data.
• Local tests and fixtures do not prove an Apify build, live run, Store content update, or Store readback.

Responsible use

Use only data you are authorized to process. Respect source terms, robots policies, privacy rules, and applicable law. Never place credentials, cookies, tokens, or private account data in URLs or logs.

Support

When reporting a problem, include the run ID, sanitized input shape, expected result, and observed result. Do not include secrets or private data.