Amazon BSR + Price History Tracker

Extract ASIN, displayed price, availability, and Best Sellers Rank text from configured public Amazon pages.

What this Actor does

Create source-backed Amazon product observations and compare displayed price, availability, and rank changes.

• Monitor user-provided public Amazon product URLs.
• Normalize displayed ASIN, price, availability, and rank text.
• Compare observations across recurring runs.

Who this is for

Amazon sellers, Commerce analysts, Catalog data teams.

Input

• Demo mode is the safe default and emits one deterministic fixture.
• Live mode processes at most maxItems configured inputs.
• startUrls: user-provided or approved public URLs.

Output

The default dataset uses the Actor-specific schema in .actor/DATASET_SCHEMA.json. Key fields include asin, productName, price, currency, availability, bsrRanks, previousPrice, changedFields, plus exact source, status, delta, confidence, warning, and fixture/live labels.

Data sources

Registered catalog sources: none. Live inputs are buyer-provided or explicitly approved public Amazon product URLs. ASIN, price, availability, and rank fields are read only when exposed by the configured page; buyer 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 writes each buyer-visible dataset record through the verified result-delivery 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-bsr-price-history-tracker with Actor ID 58ScHgBCuJesVQwVh. 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

• The Actor does not bypass login, CAPTCHA, paywalls, bot challenges, or other access controls.
• Rank and price fields are reported only when exposed on the configured public page.
• 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.