Export any public WooCommerce store's full catalog (products, variations, prices, stock) from the Store API and get typed change alerts on every scheduled run — price drops, new products, stock-outs, and low-stock-remaining warnings.
All notable changes to this actor are documented here. Format follows
Keep a Changelog ; versions follow semver.
[0.1.3] — 2026-08-17
Fixed
Runs started normally produced no data. The actor decided it was in Standby mode from the
presence of ACTOR_STANDBY_PORT, which the platform also sets on ordinary runs of a Standby-enabled
actor. Every run therefore started an HTTP server, waited for requests that never came, and wrote an
empty dataset. Mode is now decided by APIFY_META_ORIGIN=STANDBY, and a run whose input names at
least one store always crawls regardless of the environment. Each run logs the mode and the reason.
This also removes a path to the maintenance flag, since the daily health check requires a non-empty
dataset. Covered by regression tests in tests/run-mode.test.ts.
ACTOR_STANDBY_PORT values such as 12.5.6 were accepted as port 12, because Number.parseInt
stops at the first invalid character. The port is now digit-validated before parsing.
[0.1.2] — 2026-08-16
Added
Buyer-facing Store listing at .actor/README.md, separate from the developer README.
Actor logo (.actor/logo.svg, .actor/logo.png).
Changed
Actor title shortened to WooCommerce Catalog & Price Monitor — Diffs & Low-Stock Alerts (62
characters); Apify rejects titles over 63.
[0.1.0] — 2026-08-16
First release.
Added
Catalog export from the public WooCommerce Store API (wc/store/v1), one row per product or per
variation, with prices in exact integer cents.
Store detection via /wp-json/ namespaces with a Store API fallback probe. Detected REST namespaces
are exported — they enumerate the site's REST-enabled plugins.
Snapshot and diff per store in a named key-value store, emitting seven typed change events:
price_drop, price_increase, low_stock, back_in_stock, out_of_stock, new_product,
removed_product.
Low-stock detection from two signals: the store's own low_stock_remaining where published, and
otherwise the unit count parsed out of stock_availability and tracked across runs. Fires on
crossing into the threshold or falling further, not on every run while low.
Per-variation price enrichment within a configurable budget, with unenriched rows explicitly
labelled priceSource: "parent".
Watch filters over events only (nameIncludes, categories, tags, minPctChange).
Slack and generic webhook alerts, grouped per store, carrying every low-stock hit and the ten most
significant price moves.
Pre-run cost estimator written to COST-ESTIMATE.json and logged, derived from each store's own
X-WP-Total header rather than from an assumption.
Free-plan caps: 1 store, 50 records, no alert delivery.
Standby HTTP mode sharing one run() with the one-off entry point, plus GET /health.
npm run discover to qualify prospect domains before spending anything.
Health records (kind: "health") so a run that collects nothing is visible in the dataset rather
than silently empty, and endpoint-drift detection for sources that return 2xx with the wrong shape.
199 automated tests, including diff fixtures covering every event type exactly once and detection
fixtures captured from live sites.
Notes
Prices are parsed from minor-unit strings using each store's currency_minor_unit. Zero-decimal
currencies are handled: "115" at exponent 0 is $115.00, not $1.15. No floating point arithmetic
appears anywhere in the price path.
Product names are HTML-entity decoded, so exported names match the store's rendered page.
Stores whose robots.txt excludes /wp-json/ are reported skipped and never charged. This affected
3 of the 6 WooCommerce stores found while probing 42 domains during the build.
