Darty Product Scraper

Pull product data from Darty (darty.com), the French consumer-electronics and appliance retailer (part of Fnac Darty). Search by keyword, or paste product and search-result links directly. Every record includes the current price, the strike-through reference price with computed discount when a product is genuinely marked down, and the site's own customer reviews.

Why This Scraper?

• Was-price and discount, structured, never fabricated. When a product is marked down against darty.com's own reference price, both prices are captured plus the computed discount amount, percentage, and the site's own promo label (e.g. "Bon Plan", "Soldes"). Full-price products simply carry null -- nothing is guessed.
• Real narrowing, not a filter that quietly does nothing. Rating floor and free-delivery narrow via the site's own search facets, verified against live results; brand narrows against the site's own card-level brand field; sort reorders the full server-side result set.
• Reviews straight from the product page. Overall rating, total review count, recommend-percentage, per-criteria scores (e.g. ease of use, value for money), and the page's own individual reviews (author, dates, rating, title, body, purchase store) -- not a third-party review vendor.
• Flattened spec sheet. Full detail returns every characteristic the product page itself declares (screen size, energy class, dimensions, EAN, and whatever else that category carries) rather than a fixed field list, so nothing category-specific is silently dropped.
• Two ways in. Keyword search with real site filters (brand, price range, discount-only, rating, free delivery, sort), or paste any product/search-result link and continue pagination automatically.
• Optional export to your apps. Send results into Notion, Linear, Airtable, or any Apify MCP connector alongside the dataset.
• Resume and recurring updates. Turn on Incremental mode to get only NEW, UPDATED, and REAPPEARED products on every scheduled run, or resume one specific interrupted crawl with resumeFromRunId.

Data You Get

Field	Example value
productId / ean	00000001 (Darty's own "codic"), 0000000000000 (EAN)
name	TV LED Sample Brand X100 80 cm
brand	SampleBrand
category / breadcrumbPath	TV LED, ["TV, Video, Home cinema", "Television", "TV LED"]
url	https://www.darty.com/nav/achat/.../sample-brand-x100.html
price / currency	119.99, EUR
originalPrice / discountAmount / discountPercent	149.99, 30.00, 20.0
isOnSpecial / promoLabel	true, Bon Plan
inStock / condition / seller	true, new, Darty
image / images	["https://image.example.com/..."]
description	full product description text
specs	{"Screen size (inches)": "32 \"", "Definition": "HD (720p)", "Energy class": "E"}
rating / reviewCount	4.5, 26
reviews.averageRating / totalReviewCount / recommendPercent	4.5, 26, 93
reviews.criteria	[{"name": "Ease of use", "score": 4.8}]
reviews.items[]	[{"rating": 5, "title": "Sample title", "body": "Sample review text.", "author": "JANE", "level": "confirmed", "postedDate": "01/01/2026", "purchaseDate": "20/12/2025", "purchaseStore": "DARTY SAMPLE"}]

Sample shape: values above are illustrative placeholders, not from a live product.

How to Use

1. Keyword search, first page, with reviews (default):

{
  "mode": "search",
  "searchTerm": "television",
  "maxItems": 20
}

2. Keyword filtered to a brand, discounted items only, 4+ stars, sorted by price:

{
  "mode": "search",
  "searchTerm": "television",
  "brands": ["Samsung"],
  "specialsOnly": true,
  "minRating": 4,
  "sortBy": "PRICE_ASC",
  "maxItems": 50,
  "maxPages": 5
}

3. Full product detail (spec sheet + images) and reviews for a pasted product link:

{
  "mode": "url",
  "urls": ["https://www.darty.com/nav/achat/hifi_video/televiseurs-led/grand_ecran_led/sample-brand-x100.html"],
  "fetchDetails": true,
  "fetchReviews": true
}

4. Paste a search-result link and keep paginating forward:

{
  "mode": "url",
  "urls": ["https://www.darty.com/nav/recherche?text=lave-linge"],
  "maxItems": 100,
  "maxPages": 10
}

Resume and recurring updates

Two different things, both under the same input section:

• resumeFromRunId continues ONE specific interrupted crawl. Paste a previous run ID or dataset ID and this run skips every product that run already collected, picking up where it left off -- useful after a run was stopped early or hit an error partway through a large pull.
• incrementalMode is for running the SAME search or URL set again and again (daily, weekly, on a schedule) and getting only what changed. It remembers the previous run's products in a dedicated key-value store, keyed automatically from the mode, search/URL and filter settings (or your own stateKey if you want to name or deliberately share a campaign) -- so two differently-configured runs never mix their baselines. Every product is classified as changeType: NEW (first time seen), UPDATED (a comparable field changed -- see changedFields), REAPPEARED (was gone, is back), or, with emitExpired on and only once a run has fully scanned every tracked search/URL, EXPIRED (was tracked, no longer found). UNCHANGED products are tracked but not returned unless emitUnchanged is on -- both extra-emission toggles are off by default because they return, and bill, rows you already have. The state key folds in fetchReviews alongside the search filters (brands, minPrice, maxPrice, specialsOnly, minRating, freeDeliveryOnly, sortBy), since turning it on or off changes the emitted record shape.
• incrementalMode defaults to false -- a normal run's behavior and output shape are unchanged until you opt in. Combining it with resumeFromRunId bootstraps a brand-new monitoring campaign from that resumed crawl's results; if a baseline already exists for the derived (or given) state key, the run fails fast rather than silently mixing the two.

Input Parameters

Parameter	Type	Description
mode	string	search or url.
searchTerm	string	Keyword (search mode only; uses darty.com's own product search).
brands	array	Exact brand names to keep (search mode only).
minPrice / maxPrice	number	EUR price band to keep (search mode only).
specialsOnly	boolean	Keep only products currently showing a genuine discount against darty.com's own reference price (search mode only).
minRating	integer	Minimum star rating (1-5), narrowed server-side (search mode only).
freeDeliveryOnly	boolean	Keep only products with free home delivery (search mode only).
sortBy	string	RELEVANCE, PRICE_ASC, PRICE_DESC, RATING_DESC, or NEWEST.
urls	array	Product or search-result-listing URLs to scrape (url mode only).
fetchDetails	boolean	Fetch full product detail (description, EAN, breadcrumb category, flattened spec sheet, image gallery).
fetchReviews	boolean	Fetch the product's own reviews.
maxReviewsPerProduct	integer	Cap on written reviews per product; the product page itself only ever surfaces a recent subset.
maxPages	integer	Cap on result pages per search/URL entry; empty = unlimited.
maxItems	integer	Cap on total products returned; 0 = unlimited.
resumeFromRunId	string	Previous run ID or dataset ID to continue ONE interrupted crawl without re-returning/re-charging products it already collected. See "Resume and recurring updates" above.
incrementalMode	boolean	Recurring monitoring of the same search/URL set: returns only NEW/UPDATED/REAPPEARED products against a remembered baseline. Default false. See "Resume and recurring updates" above.
stateKey	string	Incremental mode only. Name a monitoring campaign, or deliberately share state across differently-configured runs. Leave empty to derive one automatically.
emitUnchanged	boolean	Incremental mode only. Also return UNCHANGED products. Off by default -- returns and bills rows you already have.
emitExpired	boolean	Incremental mode only. Also return EXPIRED products once a run fully scans every tracked search/URL. Off by default -- returns and bills extra synthetic rows.
proxy	object	Apify proxy configuration. Leave the default as provided -- this source needs it.
mcpConnectors	array	Optional MCP connectors to export results into (Notion, Linear, Airtable, Apify).
notionParentPageUrl	string	Notion connector only: page under which item pages are created.
maxNotifyListings	integer	Cap on items exported to each connector per run. Does not affect the dataset.

Output Example

{
  "productId": "00000001",
  "ean": "0000000000000",
  "url": "https://www.darty.com/nav/achat/hifi_video/televiseurs-led/grand_ecran_led/sample-brand-x100.html",
  "image": "https://image.example.com/000000000.jpg",
  "name": "TV LED Sample Brand X100 80 cm",
  "brand": "SampleBrand",
  "category": "TV LED",
  "price": 119.99,
  "currency": "EUR",
  "originalPrice": 149.99,
  "discountAmount": 30.00,
  "discountPercent": 20.0,
  "isOnSpecial": true,
  "promoLabel": "Bon Plan",
  "rating": 4.5,
  "reviewCount": 26,
  "inStock": true,
  "condition": "new",
  "seller": "Darty",
  "description": "Sample product description as shown on the site.",
  "breadcrumbPath": ["TV, Video, Home cinema", "Television", "TV LED"],
  "specs": { "Screen size (inches)": "32 \"", "Definition": "HD (720p)", "Energy class": "E" },
  "images": ["https://image.example.com/000000000.jpg"],
  "reviews": {
    "averageRating": 4.5,
    "totalReviewCount": 26,
    "recommendPercent": 93,
    "criteria": [{ "name": "Ease of use", "score": 4.8 }],
    "items": [
      { "rating": 5, "title": "Sample title", "body": "Sample review text.", "author": "JANE", "level": "confirmed", "postedDate": "01/01/2026", "purchaseDate": "20/12/2025", "purchaseStore": "DARTY SAMPLE" }
    ]
  }
}

Sample shape: values above are illustrative placeholders, not from a live product.

A note on reviews and prices

Reviews come directly from the product page itself, not a third-party review vendor -- the page only ever surfaces its own most recent written reviews, while the overall rating, review count, recommend-percentage, and per-criteria scores reflect the full history. originalPrice reflects darty.com's own reference price and is only ever populated when it is genuinely higher than the current price -- a full-price product always carries null there, never a fabricated discount.

Send results into your apps (MCP connectors)

Optionally pipe results into the apps you already use through Model Context Protocol (MCP) connectors. Authorize a connector once under Apify, Settings, Integrations, then select it in the mcpConnectors field. Each connector receives a condensed, human-readable summary per product (name plus key fields), while the complete record always stays in the Apify dataset. For Notion, set notionParentPageUrl to the page the item pages should be created under, and use maxNotifyListings to cap how many items are exported per connector per run. Supported connectors: Notion, Linear, Airtable, and Apify. Leave the field empty to skip; it never changes the dataset output.

A note on plans

Leave the proxy default as provided -- this source needs it and it may not work on every Apify plan. Change only the region if you need a different one.