Product Feed Price & Stock Delta Monitor

Watch user-supplied public product feeds (Google Merchant CSV / TSV / JSON) for price and availability changes. Only deltas since the last run are written to the dataset — ideal for affiliate ops, merchant CI, and scheduled commerce agents.

Status: LIVE on Apify Store — https://apify.com/collinjreynolds/product-feed-price-stock-delta-monitor

Pricing (pay per event — suggested Console values, comps-anchored):

Event	Price	Comp anchors (verified 2026-09-14)
product-delta (primary)	$0.002 per changed product	stellar_ballet delta $0.002; fourwake Shopify change $0.001
price-drop (optional flag)	$0.005 when price decreases	stellar_ballet price-drop alert $0.005
Actor start	platform small event (~$0.00005)	—

Change-only charging (no expensive per-check if avoidable). First run baselines quietly (0 dataset items / 0 delta charges).

Why use this (vs comps)

• Simpler Merchant UX — clear Google Merchant CSV/TSV/JSON column aliases (id/sku, title, price, availability)
• Silent first-run baseline — empty LAST_SEEN → seed only
• Change-only PPE — undercut / match stellar at $0.001–$0.002 for product-delta
• Optional price-drop event — document + flag (enablePriceDropEvent); not mandatory complexity
• Feed-first ToS — public URLs / local fixtures only; no HTML storefront scrape in v0
• Honest comps: stellar_ballet_0bu/product-feed-delta-monitor

Input

Field	Required	Description
feeds	yes	List of {url, label?, format?} or URL strings. url may be https://… or a local fixture path
includeTitleInFingerprint	no	Also treat title changes as deltas (default false)
enablePriceDropEvent	no	Also charge price-drop when numeric price decreases (default false)
resetState	no	Clear LAST_SEEN and re-baseline (0 emits that run)

Example

{
  "feeds": [
    {
      "url": "https://api.apify.com/v2/key-value-stores/mMgO4ptHbjmpSq1bg/records/google_merchant_sample.csv",
      "label": "demo-merchant-csv",
      "format": "csv"
    },
    {
      "url": "https://fakestoreapi.com/products",
      "label": "fakestore-demo-json",
      "format": "json"
    }
  ],
  "includeTitleInFingerprint": false,
  "enablePriceDropEvent": false,
  "resetState": false
}

Offline fixture example:

{
  "feeds": [
    {
      "url": "./fixtures/products_baseline.csv",
      "label": "fixture-merchant",
      "format": "csv"
    }
  ]
}

Output

Each dataset item is a changed product (never the full catalog after baseline), for example:

• feed_key, product_id, product_title, price, price_value, previous_price, availability, previous_availability, change_types, is_price_drop, fingerprint, link

change_types is a subset of: new, price, availability, title, price_drop.

First-run behavior

Situation	Dataset items	product-delta charges
Empty LAST_SEEN	0	0 (baseline only)
Later run, unchanged catalog	0	0
Later run, price/stock/(optional title) change or new SKU	1 per changed product	1 per item
Price decrease + enablePriceDropEvent	same item	+1 price-drop

Local development

cd /workspace/revenue-ops/apify-actors/product-feed-price-stock-delta-monitor
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt pytest
pytest -q
python scripts/run_offline_demo.py

ToS / scope

User-supplied public feeds only. Feed-first (no HTML scrape of storefronts in v0). No inventing prices. No LinkedIn/Meta/X. See ./AGREEMENT.md.

Store

• Store: https://apify.com/collinjreynolds/product-feed-price-stock-delta-monitor
• Console: https://console.apify.com/actors/ (see LEDGER for Actor ID)
• Published under Collin standing Apify PPE auth (B). Pure PPE + LIMITED_PERMISSIONS.