Điện Máy Xanh Scraper - Products & Reviews

Scrape products from dienmayxanh.com (Điện Máy Xanh) - one of Vietnam's largest home appliance and consumer-electronics retailers, covering refrigerators, washing machines, air conditioners, televisions, kitchen appliances and more. Get a clean, flat record per product with current & original price, discount % and savings, Flash Sale deals, full detail (specifications, variants, SKU, category path, brand), image gallery, the aggregate customer rating and the customer reviews shown on each product page.

What it does

• Search by keyword - e.g. tủ lạnh, máy giặt inverter, tivi samsung.
• Filter and sort results - keep only products matching brand, price range and minimum rating, and sort them, whether they came from a keyword search or a pasted URL.
• Flash Sale deals (toggle) - browse Điện Máy Xanh's site-wide, time-limited Flash Sale page alongside (or instead of) a keyword search, with real current/original price and discount % on every item.
• Scrape pasted URLs - paste a product URL for a single product, a category / search URL to pull the whole matching listing, or a promotion URL (the Flash Sale page, or a seasonal category promotion page such as khuyen-mai-tu-lanh) to pull its deals.
• Full product detail (toggle) - specifications, variants (where a model has them, with per-variant price and availability), SKU, category path, image gallery, brand, category, description and aggregate rating.
• Customer reviews (toggle) - the star-rated reviews shown on the product page: author, date, rating and review text.

Input

Field	Description
Mode	search (keyword search) or url (paste links).
Search keywords	One or more terms; each is searched separately.
Brand	Keep only products whose brand contains this text (e.g. Samsung, LG). Applies to both Search mode and pasted URLs.
Sort by	Relevance, price low-to-high or high-to-low, highest rated, most reviewed, name A-Z. Applies to both Search mode and pasted URLs.
Min / Max price	Price range in VND. Applies to both Search mode and pasted URLs.
Min rating	Keep products at or above this average rating (needs details on). Applies to both Search mode and pasted URLs.
Flash sale only	Also browse the site-wide Flash Sale deals page alongside any keywords.
URLs	Product, category, search or promotion URLs (URL mode).
Fetch product details	Adds specs, gallery, description and rating for each product. Opens each product page, so it is off by default — turn it on when you need the full detail fields.
Fetch customer reviews	Also collect the reviews shown on each product page.
Max products	Cap on total products returned (0 = unlimited).
Resume from run/dataset id	Continue one specific interrupted run: paste a previous run id or dataset id and already-collected products are skipped.
Incremental mode	Track this same search/URLs over repeated scheduled runs; returns only NEW/UPDATED/REAPPEARED (and optionally EXPIRED) products. Default off.
State key	Optional name for the Incremental mode baseline. Empty = auto-derived from your search settings.
Emit unchanged products	Incremental mode: also return (and bill) products with no change since last run. Default off.
Emit expired products	Incremental mode: also return (and bill) products no longer found, once a run completes a full scan. Default off.
Connection	Apify Proxy with residential access in Vietnam is required for reliable results and correct local pricing.

Specials / promotions

Điện Máy Xanh's promotional surface has two kinds of pages, both verified live:

• Flash Sale (/flashsale) - a permanent, site-wide landing page of curated, time-limited deals. Turn on Flash sale only in Search mode, or paste https://www.dienmayxanh.com/flashsale in URL mode. It is a single curated page (no further pagination), so maxItems/maxPages cap how many of its listed deals are returned.
• Category promotions (khuyen-mai-<category>, e.g. khuyen-mai-tu-lanh for fridges) - seasonal campaign pages that rotate with the current promotion cycle, so they are not exposed as a fixed picklist. Paste the page's own link in URL mode to scrape it; the same was-price and discount fields populate.

Was-price, discount & savings

For every product on special, the record carries the current price (price, unchanged), plus the site's own struck-through original price (originalPrice), the discount percentage (discountPercent, plus the raw badge text in discount) and the savings amount (savings = originalPrice − price). isOnSpecial is true only when a genuine original price was found; on a full-price product these fields are null/false - never fabricated. A gift/bonus offer shown on the card (e.g. a free accessory) is captured verbatim in promoGift, and an interest-free-installment badge in installmentOffer, when present.

Resume & recurring updates

Two separate features cover two separate needs:

• resumeFromRunId continues ONE specific interrupted run. Paste the run id or dataset id from a previous run that got cut off (timeout, item cap, connection issue) and this run skips every product it already collected, so you don't pay to re-scrape and re-download what you already have.
• incrementalMode tracks the SAME search or URLs across many scheduled runs on its own — no id to paste. Turn it on and schedule the actor (e.g. daily); each run compares against a baseline it remembers itself (keyed by your search settings, or your own State key) and returns only changeType: "NEW", "UPDATED" or "REAPPEARED" products, plus changedFields, firstSeenAt and lastSeenAt. Unchanged products are neither returned nor billed unless you turn on Emit unchanged products. Products that disappear are only reported as "EXPIRED" (and only if Emit expired products is on) once a run completes a full, uncapped scan of the search — a run limited by Max products (the default is 20) never reports EXPIRED, since it never proved those products are actually gone.
• The baseline for Incremental mode is keyed on your search settings (mode, keywords, brand, sort, price/rating filters, Flash Sale toggle, URLs, fetch details/reviews) — not on Max products/Max listing pages/Max reviews per product/the connector export cap, so raising a limit keeps your existing baseline instead of starting over and re-billing everything.
• Volatility note: every field this actor emits was measured byte-identical across two live fetches of the same products 8 seconds apart, including rating and reviewCount — this actor has no rank/position field and no ticking engagement counter to exclude, so a genuine change to any emitted field (including price, discount, promo and rating fields) triggers "UPDATED". The one exclusion is structural, not measured: the embedded reviews[] array is a peer collection that belongs to individual reviewers, not the product, so a stranger leaving a new review does not by itself change the product's changeType.

Track a search over repeated scheduled runs (Incremental mode):

{
  "mode": "search",
  "queries": ["tủ lạnh"],
  "fetchDetails": true,
  "incrementalMode": true,
  "emitExpired": true,
  "maxItems": 0
}

Output

One record per product. Example (illustrative values):

{
  "code": "220325",
  "productCode": "3051097001790",
  "sku": "220325",
  "name": "Tủ lạnh Samsung Inverter 236 lít RT22M4032BY/SV",
  "url": "https://www.dienmayxanh.com/tu-lanh/samsung-rt22m4032by-sv",
  "brand": "Samsung",
  "category": "Tủ lạnh",
  "categoryPath": ["Tủ lạnh", "Tủ lạnh Samsung"],
  "color": "Bạc",
  "price": 5990000,
  "originalPrice": 8030000,
  "discountPercent": 25.0,
  "savings": 2040000,
  "discount": "(-25%)",
  "isOnSpecial": true,
  "promoGift": "Quà tặng bộ chia điện 160.000₫",
  "installmentOffer": "Trả chậm 0% trả trước 0đ",
  "currency": "VND",
  "rating": 4.8,
  "reviewCount": 1240,
  "ratingBreakdown": { "bestRating": 5, "worstRating": 1 },
  "specifications": {
    "Kiểu tủ": "Ngăn đá trên",
    "Dung tích": "236 lít",
    "Công nghệ Inverter": "Có"
  },
  "images": [
    "https://cdn.tgdd.vn/Products/Images/1943/220325/samsung-rt22m4032by-sv-1.jpg"
  ],
  "description": "Tủ lạnh Samsung Inverter 236 lít - ngăn đá trên, tiết kiệm điện...",
  "availability": "InStock",
  "reviews": [
    { "author": "Trần Linh", "date": "3/16/2025", "rating": 5, "title": null, "body": "Giao hàng nhanh, máy làm lạnh tốt." }
  ],
  "searchMode": "search",
  "source": "dienmayxanh.com"
}

A full-price product carries the same fields with originalPrice/discountPercent/discount/ savings all null and isOnSpecial: false - never a fabricated discount.

Fields present depend on the toggles: without Fetch product details you get the listing fields (name, price, was-price/discount, brand, category, color, image, code); with it you also get specifications, variants, SKU, full category path, gallery, description and the aggregate rating; with Fetch customer reviews each record gains a reviews[] array. With Incremental mode on, each record also gains changeType, changedFields, firstSeenAt and lastSeenAt — see Resume & recurring updates.

Reviews

Reviews are the star-rated customer reviews the product page itself publishes (author, date, star rating and text) plus the product's aggregate rating (rating, reviewCount). Non-rated Q&A entries are excluded. Reviews carry no photos, so no third-party media is emitted.

Connection

This source serves the correct catalogue, pricing and stock only to a residential connection in Vietnam, so the run uses Apify Proxy with residential access, country Vietnam by default and rotates a fresh exit per request. On the free plan, coverage may be limited and some runs may return no results.

Export to your apps (optional)

Results can optionally be piped into Notion, Linear, Airtable or other apps via MCP connectors - authorize one under Apify → Settings → API & Integrations and select it in the input. This is a side-channel that never changes the dataset output.