Shopify Price & Stock Change Monitor

Monitor public Shopify product prices and availability over time. Only requests the public /products.json endpoint, with no browser or proxies.

Quick start

Use one public Shopify storefront and keep the same stateStoreName for scheduled runs:

{
  "storeUrls": ["https://www.allbirds.com"],
  "maxProductsPerStore": 10,
  "emitInitialSnapshot": false,
  "stateStoreName": "SHOPIFY-PRICE-STOCK-STATE"
}

The recommended default creates a free baseline. A later run emits NEW_VARIANT, PRICE_DROP, PRICE_CHANGE, RESTOCK, or SOLD_OUT rows only when a public variant changes.

1. Provide known public Shopify store URLs.
2. On the first run a persistent baseline is saved; by default there are no chargeable change events.
3. Schedule it periodically with the same state store name. Only new variants, price movements, restocks and sellouts are written to the Dataset.

Run economics summary

Every completed run writes an OUTPUT summary containing requested/checked stores, checked products and variants, detected changes, delivered/billed rows, billing failures, and whether the run was baseline-only. This is audit evidence for future pricing decisions; it does not change the live billing event or estimate platform cost.

Every delivered change also includes a deterministic changeIdentityKey. The key is based on the store, product, variant, change types, and before/after values—not the check timestamp—so a retry of the same business change can be recognized downstream without changing the existing change-result event or price. 4. Set emitInitialSnapshot=true only when you explicitly want the first snapshot delivered as billable rows.

The Actor records only public prices and availability flags. Actual stock quantities are not exposed by this public endpoint. Password-protected and unsupported storefronts produce clear failures; they are not billed as success. It will not bypass login, CAPTCHA, or rate limits.

Pay-per-event: change-result. The default baseline is free; emitInitialSnapshot=true explicitly emits and charges baseline rows. The live Pricing tab is authoritative for the current event price and plan-specific terms. This sprint does not add a check-result charge or change the current price. OUTPUT is an object, not a text blob. It reports requested/accepted/duplicate stores, processed/check/baseline/unchanged stores, products and variants checked, detected changes, delivered versus billed rows, and billing failures. This makes recurring monitoring and state recovery auditable.