Sale-Discount-Monitor

Sale & Discount Monitor

Automatically monitors product prices across e-commerce websites and detects price drops and discounts over time.
Designed to emit structured, alert-ready signals for automation, deal tracking, and retail intelligence workflows.

---

Alert System (Tiered)

This Actor emits structured price alert signals intended for consumption by Apify integrations such as:

• Webhooks
• Zapier / Make
• Scheduled monitoring tasks
• Dashboards and external systems

Alerts are produced as dataset outputs and are not delivered directly by the Actor.

---

Typical Workflow

1. Add one or more product URLs to monitor
2. Schedule the Actor to run periodically (hourly, daily, daily, etc.)
3. The Actor extracts current pricing data
4. Prices are compared with previous runs
5. Price drops and discount thresholds are evaluated
6. Filter dataset items where alertTriggered = true
7. Deliver alerts via integrations

---

Example Input

The Actor expects product URLs as plain text, one URL per line.

Example Input (JSON)

{
  "startUrls": "https://www.allbirds.com/products/mens-wool-runners\nhttps://store.example.com/products/sneakers",
  "discountThreshold": 10,
  "currency": "USD"
}

Tier 1 — Alert Trigger

An alert is triggered when any of the following conditions are met:

• Product price decreases compared to the previous run
• Discount percentage meets or exceeds the configured threshold

---

Tier 2 — Alert Context

Each alert includes structured context for decision-making:

• Previous price
• Current price
• Original price (if available)
• Discount percentage
• Currency
• Timestamp

---

Tier 3 — Alert Intelligence

Advanced logic improves signal quality and reduces noise.

Alert Types

• PRICE_DROP — Price decreased since last run
• DISCOUNT_THRESHOLD — Discount meets threshold
• BOTH — Price drop and discount detected
• NONE — No alert condition met

Cooldown Protection

• Alerts are suppressed if the price has not changed since the previous run
• Prevents duplicate alerts across scheduled executions

Confidence-Aware Gating

• Alerts are triggered only when confidence score ≥ 0.6
• Reduces false positives caused by temporary page inconsistencies

---

Output

• Results are stored in the default Apify dataset
• Each dataset item represents one product evaluation
• Key output fields:
  • alertTriggered
  • alertType
  • currentPrice
  • previousPrice
  • discountPercentage
  • confidenceScore
  • timestamp

---

Intended Use

• E-commerce price monitoring
• Competitor price tracking
• Discount and deal aggregation
• Affiliate marketing workflows
• Retail price intelligence systems

---

Limitations

• Requires at least one previous run to detect price changes
• Price extraction depends on page structure
• Some websites may block automated access
• Currency detection may fail on some pages

---

Pricing

This Actor uses pay-per-event pricing.

You are charged a fixed fee each time the Actor starts running.
The total cost depends on the Actor memory configuration (one event per GB, minimum one event).

This pricing model makes costs predictable for scheduled monitoring and automation workflows.

---

Summary

• Automated price monitoring & discount detection
• Optimized for Shopify and WooCommerce product pages
• Designed for scheduled monitoring workflows
• Produces clean, structured, automation-ready outputs