Shopify Discount Scanner

Scan any Shopify store to find all discounted products instantly. First run shows current sales with savings calculated. Subsequent runs track price drops, restocks, and new items. Supports Slack and Discord alerts.

---

🎯 What This Tool Does

Most Shopify scrapers dump raw product data. You get thousands of rows and figure it out yourself.

This tool does the analysis for you:

[1] First run  → Shows ALL products currently on sale (with savings)
[2] Later runs → Shows ONLY what changed since last time

---

⚙️ How It Works

INPUT: Store URL (e.g. fashionnova.com)
         ↓
SCAN: Fetch /products.json from store
         ↓
ANALYZE: Find items where compare_at_price > price
         ↓
OUTPUT: List of deals with discount % and savings
         ↓
STORE: Save snapshot for next comparison

---

🔄 First Run vs Later Runs

FIRST RUN
─────────
Input:  fashionnova.com
Output: 100 items on sale | $1,049 total savings available

SECOND RUN (next day)
─────────────────────
Output: 3 price drops | 2 restocks | 1 new product

---

📦 Output Example

Each item in the dataset:

{
  "event_type": "on_sale",
  "store": "fashionnova.com",
  "product_title": "Cable Knit Cardigan",
  "before_price": 35.99,
  "after_price": 14.00,
  "delta_pct": -61.0,
  "savings": 21.99,
  "product_url": "https://fashionnova.com/products/cable-knit-cardigan",
  "available": true
}

---

💡 Use Cases

🛒 Find Deals Across Multiple Stores

{
  "stores": ["fashionnova.com", "prettylittlething.com", "boohoo.com"]
}

📊 Monitor Competitor Pricing

{
  "stores": ["competitor1.com", "competitor2.com"],
  "eventPriceChange": true,
  "eventSaleStarted": true,
  "alertsEnabled": true,
  "slackWebhookUrl": "https://hooks.slack.com/services/..."
}

🔔 Restock Alerts

{
  "stores": ["kith.com", "supremenewyork.com"],
  "eventRestock": true,
  "alertsEnabled": true,
  "discordWebhookUrl": "https://discord.com/api/webhooks/..."
}

---

📋 Event Types

Event	Description
on_sale	Product currently discounted (first run)
price_change	Price increased or decreased
restock	Item back in stock
sold_out	Item no longer available
new_product	Product added to store
removed_product	Product removed from store
sale_started	Discount applied
sale_ended	Discount removed

---

🔔 Alerts

💬 Slack Format

fashionnova.com - 15 changes detected

📉 Price Drop: 8 | 📦 Restock: 5 | 🆕 New: 2

Top changes:
• Cardigan: $14 (was $36) - 61% off
• Summer Dress: $18 (was $45) - 60% off
• High Waist Jeans: $22 (was $50) - 56% off

💬 Discord Format

Sends embed with store name, change counts, and top deals.

---

⚙️ Input Options

Parameter	Default	Description
stores	Required	Shopify store domains to scan
eventPriceChange	true	Track price changes
eventRestock	true	Track restocks
eventSaleStarted	true	Track new sales
eventNewProduct	true	Track new products
minPriceChangePct	5	Min % change to report
alertsEnabled	false	Send webhook alerts
slackWebhookUrl	—	Slack webhook URL
discordWebhookUrl	—	Discord webhook URL
maxProductsPerStore	250	Products to scan per store

---

💰 Pricing

Typical run: $0.50 - $2 (depends on store size)
One good deal found = pays for 100+ runs

---

⚠️ Limitations

• Only works with Shopify stores with public /products.json
• Some stores block or rate-limit this endpoint
• Max 250 products per store by default (configurable)

---

🚀 Quick Start

1. Enter store domain(s)
2. Run actor
3. First run → see all current discounts
4. Schedule daily/hourly runs → track changes
5. Add webhook URL → get instant notifications

---

❓ FAQ

How do I know if a store is Shopify?

Visit storename.com/products.json — if it returns JSON, it works.

What happens on first run?

You get all products currently on sale with discount % and savings.

What about later runs?

Only changes: price drops, restocks, new products, etc.

Can I monitor multiple stores?

Yes. Add multiple domains to the stores array.

---

🔧 Technical Details

• Uses Shopify /products.json API
• Stores snapshots in Apify Key-Value Store
• Normalizes data for consistent diffing
• Supports residential proxies for blocked stores