EU Marketplace EAN Price Tracker

Match configured public marketplace offers to a supplied EAN or GTIN and compare displayed prices.

What this Actor does

Normalize matching offers with seller, currency, availability, and source evidence across a supplied URL set.

• Resolve a supplied EAN or GTIN against configured public pages.
• Compare displayed seller prices.
• Track source-backed offer changes.

Who this is for

European commerce teams, Pricing analysts, Marketplace data teams.

Input

• Demo mode is the safe default and emits one deterministic fixture.
• Live mode processes at most maxItems configured inputs.
• ean: required EAN or GTIN to match.
• startUrls: configured public offer URLs.

Output

The default dataset uses the Actor-specific schema in .actor/DATASET_SCHEMA.json. Key fields include requestedEan, observedEan, eanMatched, productName, sellerName, price, currency, availability, 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 offer URLs. EAN/GTIN and offer fields are read only when exposed by a configured page; markup types and 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 a configured event. It supports the verified EAN-resolution, product-result, and record events and 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/eu-marketplace-ean-price-tracker with Actor ID Yige2R69uAnVNmD2b. 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 only compares configured public offer pages and does not claim universal EU marketplace coverage.
• EAN matching depends on identifiers exposed by the page or supplied input.
• 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.