🎁 Black Friday & Christmas Deals Tracker (Toys, Tech, Gaming, Gifts)

Real-time discount tracker, price drop detector, and flash deal monitor for the Holiday Season.
Scrapes top community-verified mega deals, error fares, and clearance sales across France (Dealabs), the UK (HotUKDeals), Germany (Mydealz), and Spain (Chollometro).

---

⚡ Why Use This Actor for the Holiday Season?

During Black Friday, Cyber Monday, and the December Christmas rush, deal speed is everything:

• 🚀 Instant Alerting: Feeds update in real time with community-voted hot deals.
• 🌡️ Heat & Temperature Filtering: Filter out mediocre sales and keep only verified hot deals (e.g. minTemperature: 100°).
• 🧸 Gift Categories Ready: Dedicated pre-filtered feeds for Toys (LEGO, Barbie, Pokémon), Gaming (PS5, Nintendo Switch, Xbox), Tech (AirPods, Smartwatches, Laptops), and Home / Kitchen (Airfryer, Espresso machines).
• 🤖 Perfect for Telegram / Discord Bots & Affiliate Sites: Stream high-converting deals directly to your community or automated affiliate blogs.

---

🌍 Supported Deal Networks & Countries

Network	Country	Covered Retailers
Dealabs	France 🇫🇷	Amazon.fr, Cdiscount, Fnac, Darty, E.Leclerc, Carrefour, Cultura
HotUKDeals	United Kingdom 🇬🇧	Amazon.co.uk, Currys, Argos, Very, John Lewis, ASDA
Mydealz	Germany 🇩🇪	Amazon.de, MediaMarkt, Saturn, Otto, Alternate, Mindfactory
Chollometro	Spain 🇪🇸	Amazon.es, PcComponentes, El Corte Inglés, MediaMarkt.es

---

📥 Input Parameters

Parameter	Type	Default	Description
channels	array	Dealabs, HotUKDeals, Mydealz	List of country deal networks to monitor (dealabs, hotukdeals, mydealz, chollometro).
categories	array	all, toys, gaming, tech	Gift categories (all, toys, gaming, tech, home, fashion).
keywords	array	[]	Optional product filters (e.g. ["lego", "ps5", "switch", "dyson", "pokemon"]).
minTemperature	integer	50	Minimum deal heat (100°+ represents hot community deals).
maxPrice	number	null	Budget cap for secret santa or affordable gifts (e.g. 50.0).
maxDealsPerChannel	integer	30	Maximum deals per channel/category combination (1 to 200).
includeSummary	boolean	true	Outputs a dealsSummary record with top merchants and median prices.

Example Input:

{
  "channels": ["dealabs", "hotukdeals"],
  "categories": ["toys", "gaming", "tech"],
  "keywords": ["lego", "ps5", "nintendo"],
  "minTemperature": 100,
  "maxPrice": 150.0,
  "includeSummary": true
}

---

📤 Output Data Format

The Actor outputs two record types:

1. Curated Hot Deal (recordType: "deal")

{
  "recordType": "deal",
  "source": "dealabs",
  "country": "FR",
  "title": "LEGO Speed Champions 77264 - Jaguar Project 7 & Land Rover Defender",
  "temperature": 111,
  "isMegaDeal": true,
  "price": 29.99,
  "currency": "EUR",
  "priceRaw": "29,99€",
  "merchant": "E.Leclerc",
  "category": "Jouets & Jeux",
  "dealUrl": "https://www.dealabs.com/bons-plans/lego-77264speed-champions-3443827",
  "imageUrl": "https://static-pepper.dealabs.com/threads/raw/GAlJr/3443827_1/re/150x150/qt/55/3443827_1.jpg",
  "description": "Super remise fidélité sur le set LEGO Speed Champions. Prix de base 44,99€.",
  "publishedAt": "2026-11-02T14:45:00Z",
  "scrapedAt": "2026-11-02T15:00:00Z"
}

2. Deals Summary Metrics (recordType: "dealsSummary")

{
  "recordType": "dealsSummary",
  "totalDealsScraped": 45,
  "megaDealsCount": 28,
  "megaDealsShare": 0.622,
  "averageTemperature": 142.5,
  "medianPrice": 49.99,
  "topMerchants": [
    { "name": "Amazon", "count": 18 },
    { "name": "Cdiscount", "count": 9 },
    { "name": "Fnac", "count": 7 }
  ],
  "topCategories": [
    { "name": "High-Tech", "count": 20 },
    { "name": "Jeux Vidéo", "count": 15 },
    { "name": "Jouets", "count": 10 }
  ],
  "scrapedAt": "2026-11-02T15:00:00Z"
}

---

💵 Pay-Per-Event (PPE) Pricing

Event	Price (USD)	Description
Deal Extracted (deal)	$0.0020	Charged per verified hot deal extracted ($2.00 per 1,000 deals).
Summary Metrics (dealsSummary)	FREE	Summary metrics, price medians, and merchant breakdown are included for free.