Shopify Price & Stock Change Monitor

Monitors Shopify stores for price drops, stock changes, and new products. Only what changed since last check.

Unlike traditional scrapers that return full catalogs every single run and consume massive compute/proxy resources, this actor stores its state between runs and emits true, incremental deltas. Perfect for price-arbitrage bots, dropshipping intelligence, and AI-agent automation.

---

🌌 Features

• Zero-Proxy Cost Moat: Uses stable public JSON endpoints (/products.json). No headless browsers, no HTML parsing, no residential proxies needed.
• True Delta Output: Returns only changed items (price_up, price_down, back_in_stock, out_of_stock, new, removed).
• Agentic Ready: PPE priced, zero-Standby required, and fully discoverable by AI agents (e.g. x402/MCP users).

---

🛠️ Input Schema

Field	Type	Required	Default	Description
storeUrls	Array of strings	Yes	—	One or more Shopify store base URLs (e.g., ["https://kith.com"]).
minPriceChangePercent	Integer	No	5	Only report price changes whose difference is above this percentage threshold.
backInStockOnly	Boolean	No	false	If enabled, only reports items transitioning from out of stock to back in stock (restocks).
checkIntervalMinutes	Integer	No	60	Intended check interval in minutes (used for metadata).

---

📊 Output Example

When a change is detected, the actor pushes a structured delta object to the default dataset:

[
  {
    "storeUrl": "https://kith.com",
    "productTitle": "Kith Classic Cap - Black",
    "change_type": "price_down",
    "old_value": "60.00",
    "new_value": "50.00",
    "product_url": "https://kith.com/products/khm051558-001-ph"
  },
  {
    "storeUrl": "https://kith.com",
    "productTitle": "Kith Classic Cap - Black",
    "change_type": "back_in_stock",
    "old_value": "out_of_stock",
    "new_value": "available",
    "product_url": "https://kith.com/products/khm051558-001-ph"
  },
  {
    "storeUrl": "https://kith.com",
    "productTitle": "Kith Classic Cap - Black",
    "change_type": "new",
    "old_value": null,
    "new_value": "Price: 60.00, Stock: available",
    "product_url": "https://kith.com/products/khm051558-001-ph"
  }
]

Supported change_type values:

• price_up - Variant price increased
• price_down - Variant price decreased (exceeding minPriceChangePercent)
• back_in_stock - Variant stock went from out-of-stock to available
• out_of_stock - Variant stock went from available to out-of-stock
• new - A new product or variant was added
• removed - A product or variant was removed from the store

---

⚡ Pay-Per-Event (PPE) Cost Math

This actor is priced strictly by event performance:

• Actor Start: $0.01 per run
• Default Dataset Item (emitted change): $0.005 per changed item

Example Math:

• Small Store (200 products, checked hourly, averages 5 changes/day):
  • 24 runs * $0.01 = $0.24
  • 5 changes * $0.005 = $0.025
  • Total cost: $0.265/day
• Large Store (1,000 products, checked hourly, averages 20 changes/day):
  • 24 runs * $0.01 = $0.24
  • 20 changes * $0.005 = $0.10
  • Total cost: $0.34/day

---

⚠️ Limitations

• Requires a public /products.json endpoint (exposed by default on ~99% of public Shopify stores).
• Does not work on password-protected stores or stores that have explicitly disabled their products endpoint.
• Max 250 products per page. Full pagination is handled automatically.
• Very large catalogs (>10k products) are fetched at ~2 pages/sec to respect Shopify rate limits.
• Catalogs above ~25,000 products exceed the public endpoint's pagination cap and are skipped with a warning.

---

🤖 AI Agent Integration

[!NOTE] Agentic Compatibility Badge: This actor is agent-compatible. AI agents can discover, run, and pay for it programmatically without an Apify account using standardized pay-per-event routing.