Castorama France Scraper: Prices, Promotions, Sellers and Reviews

Castorama Scraper turns Castorama France (castorama.fr) into a clean product data feed. Search by keyword or category, or paste product, category and search-result links, and every product comes back as one flat record with price, was-price, promotion, seller identity, breadcrumb category and rating. Switch on product details to add the full description, technical specifications and customer reviews, then export to JSON, CSV or Excel, or pull results straight into your app through the API.

Why This Scraper?

• Two ways to find products. Search by keyword or category name, or paste product, category and search-result links directly, mixed freely in one run.
• A matching keyword resolves like the site's own search. Typing a term such as "perceuse" walks the full matching category and its facet set, exactly like typing into the site's own search box, not just a flat keyword match.
• Genuine promotion detection. isOnSpecial, originalPrice and the discount amount are only ever set when the site's own was-price for that item is genuinely higher than the current price, never a marketplace price spread.
• First-party reviews. Product detail pulls the site's own embedded review data (author, title, body, rating, date); no third-party review host is involved.
• Seller-aware. Every record marks whether it was sold directly by Castorama or by a marketplace partner, with that partner's identity.
• Built for schedules. Incremental mode returns only new and changed products on recurring runs, with expired and reappeared tracking once you turn it on, plus a resume option to continue one interrupted crawl.
• Resilient to the storefront's own occasional maintenance placeholder. A blocked request retries automatically on a fresh connection instead of silently returning fewer products.

Use Cases

• Price and promotion monitoring: track price, was-price and promotion status across a brand or category to catch markdowns as they go live.
• Marketplace and assortment research: see which products Castorama sells directly versus through marketplace partners, and compare partner pricing.
• Catalog and content teams: pull descriptions, technical specifications and images to enrich a product database.
• Review and reputation analysis: collect customer ratings and reviews per product to spot quality issues or standout items.
• Recurring stock and price feeds: schedule the actor daily with Incremental mode to feed a price-comparison site or alerting tool with only what changed.

Data You Get

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

Field	Example
productId / ean	"3666294006226"
title	"Perceuse Visseuse 20V Exemple + 2 Batteries 1,5 Ah + Chargeur rapide + Malette"
brand	"Nemura"
price	79.99
currency	"EUR"
originalPrice	139.99 (only when a real promotion is present)
discountAmount / discountPercentage	60.0 / 43
isOnSpecial	true
promotionLabel	"Promotion"
sellerId / sellerName	"2131" / "Vendeur Partenaire Exemple"
soldByCastorama	false
category	"Visseuse dévisseuse"
categoryPath	[{"name": "Visseuse dévisseuse", "path": "/visseuse-devisseuse/cat_id_0003519.cat"}]
availability	{"status": "Available", "purchasable": true, "homeDelivery": "Available"}
images / image	array of image URLs / the first one
url	"https://www.castorama.fr/mkp/example/3666294006226_CAFR.prd"
specifications	[{"name": "Tension (en V)", "value": "20V"}] (with product details on)
description	the product's full description text (with product details on)
rating	4.75
reviewCount	4
reviews	[{"author": "Exemple", "title": "Efficace", "body": "...", "rating": 5, "date": "..."}] (with product details on)
searchMode	"search", "category", or "product" for a pasted product link
scrapedAt	"2026-01-01T00:00:00Z"

rating, reviewCount and reviews are always present, explicit null/0/[] rather than omitted, on every record, whether product details are on or off. With Incremental mode on, every returned record also carries changeType, changedFields, firstSeenAt and lastSeenAt; see "Resume and recurring updates" below for exactly when each changeType value is produced.

How to Use

1. Pick a mode: search (keywords or category names, with filters) or url (paste links).
2. For search mode, list one or more keywords or category links, and set the brand, price, rating, promotion and sort filters you need. For url mode, paste product, category and search-result links, mixed freely.
3. Set Max products to cap the run's size and cost, and toggle Fetch product details for description, specifications and reviews, then click Start.
4. Download the dataset as JSON, CSV or Excel, or read it through the API.

Search by keyword with filters:

{
  "mode": "search",
  "queries": ["perceuse"],
  "brand": "Bosch Professional",
  "maxPrice": 150,
  "onPromotionOnly": true,
  "maxItems": 30
}

Paste a product link and a category link together:

{
  "mode": "url",
  "urls": [
    "https://www.castorama.fr/mkp/perceuse-visseuse-20v-nemura-2-batteries-1-5-ah-chargeur-rapide-malette-avec-54-accessoires/3666294006226_CAFR.prd",
    "https://www.castorama.fr/outillage/outillage-electroportatif/perceuse-visseuse-perceuse-a-percussion-et-tournevis-sans-fil/cat_id_3796.cat"
  ],
  "fetchDetails": true
}

Fast listing-only run, sorted and rating-filtered:

{
  "mode": "search",
  "queries": ["visseuse"],
  "fetchDetails": false,
  "minRating": "4",
  "sortBy": "price_asc",
  "maxItems": 50
}

Daily incremental watch on a category:

{
  "mode": "search",
  "queries": ["peinture blanche mate"],
  "incrementalMode": true,
  "stateKey": "peinture-blanche-mate-watch"
}

Run it from your code

Python:

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("abotapi/castorama-fr-scraper").call(run_input={"mode": "search", "queries": ["perceuse"], "maxItems": 20})
for product in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(product["title"], product["price"], product["currency"])

JavaScript:

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('abotapi/castorama-fr-scraper').call({ mode: 'search', queries: ['perceuse'], maxItems: 20 });
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Or connect it to Make, Zapier, n8n, Google Sheets or webhooks from the Integrations tab.

Resume and recurring updates

• Resume (resumeFromRunId) continues one specific interrupted or previous crawl: paste its run ID or dataset ID and this run skips products already collected there, returning only the remaining new products.
• Incremental mode (incrementalMode) is for scheduling the same search again and again, for example daily. The actor remembers the previous run of the same search by itself, keyed by stateKey or an automatically derived key, so you never paste a run ID. The first run for a search returns everything as NEW. Later runs return only NEW and UPDATED (with changedFields) products by default; unchanged products are suppressed and not billed unless emitUnchanged is on.
• EXPIRED rows are only produced when emitExpired is on, and only on a run that reaches the natural end of every tracked search, meaning no maxItems cap was hit, resumeFromRunId was not used, and every page was walked to its end. A capped or resumed run skips expiry detection for that run and keeps the previous state as it was.
• REAPPEARED is not something you see on an early or ordinary run. A product is only ever classified REAPPEARED after it was previously marked EXPIRED by an earlier emitExpired run that completed a full scan, and is then seen again on a later run, whether or not that later run has emitExpired on. Until a product has gone through that expiry step once, a product missing on one run and present again on the next is not distinguished from any other UPDATED/UNCHANGED product, because it was never recorded as gone in the first place.

Send results into your apps (MCP connectors)

Optionally pipe the scraped results into the apps you already use, through Model Context Protocol (MCP) connectors. This is an extra delivery step after the scrape; the Apify dataset is never changed.

What gets written to the connector: a condensed, human-readable summary of each product, not the full JSON. Each item becomes one entry with a title and its key fields flattened to plain text. The complete record always stays in the Apify dataset.

1. Authorize a connector once under Apify, Settings, Integrations (Notion, Linear, Airtable, or Apify).
2. Select it in the "Pipe results into your apps" input field. If the picker is empty, you have not authorized a connector yet.
3. For Notion, also set notionParentPageUrl to the page where item pages should be created.

The connection is mediated by Apify's own MCP proxy, so this actor never sees your third-party credentials. Leave the field empty to skip.

Input Parameters

Parameter	Type	Default	Description
mode	string	search	search (keywords or category names, with filters) or url (paste product, category or search-result links).
queries	array	none (prefill: ["perceuse"])	Keywords or Castorama category links to search or browse, search mode only. Each entry is walked separately; a keyword matching a real category resolves straight to that category's full facet set.
brand	string	none	Only keep products of this brand, Castorama's own "Marque" facet. Narrows search mode and a pasted category/search-result link in url mode; has no effect on a single pasted product link.
sellerCastoramaOnly	boolean	false	Exclude marketplace (third-party seller) offers. Same scope as brand.
minPrice	integer	none	Keep only products priced at or above this amount, in EUR. Same scope as brand.
maxPrice	integer	none	Keep only products priced at or below this amount, in EUR. Same scope as brand.
minRating	string	0	Keep only products whose average rating is at least this many stars: 0, 3, 4, or 5. Same scope as brand.
urls	array	none (prefill: one product link and one category link)	Castorama France links to scrape directly, url mode only. Mix product, category and search-result links freely; each is routed automatically.
onPromotionOnly	boolean	false	Keep only products currently flagged with a real promotion, a genuine prior price for the same item. Applies to every result in either mode, including a single pasted product link.
inStockOnly	boolean	false	Keep only products the site currently marks purchasable online, checked client-side against each product's own status. Same scope as onPromotionOnly.
sortBy	string	relevance	Order results: relevance, price_asc, price_desc, rating_desc, newness, or best_seller. Same scope as onPromotionOnly, though sorting has no visible effect on a single pasted product link.
fetchDetails	boolean	true	Also collect each product's description, technical specifications and customer reviews. Turn off for a faster run returning only listing-level fields for products found by search or category browsing; a pasted product link always fetches full detail regardless of this setting.
maxItems	integer	20	Maximum number of products to return across the whole run. 0 means unlimited.
maxPages	integer	0	Maximum result pages walked per keyword, category or link. 0 means unlimited: the run then stops at Max products, or when a page repeats no new products.
resumeFromRunId	string	none	Continue one specific interrupted or previous run: products already collected there are skipped rather than returned or charged again. For recurring monitoring of the same search, use incrementalMode instead.
incrementalMode	boolean	false	Turn on for scheduled or recurring runs of the same search. The actor remembers the previous run itself; see "Resume and recurring updates" above.
stateKey	string	none	Name this monitoring campaign, or deliberately share state across differently configured runs. Left empty, a key is derived automatically from the search/URL and filter/detail settings.
emitUnchanged	boolean	false	Incremental mode only. Also return, and bill for, products unchanged since the last run, marked UNCHANGED.
emitExpired	boolean	false	Incremental mode only. Also return, and bill for, products no longer found, marked EXPIRED, once a run has fully scanned the tracked search.
proxy	object	{"useApifyProxy": true}	Connection settings. Apify Proxy, automatic/datacenter tier, by default.
mcpConnectors	array	none	Optional: send a summary of each product to apps you authorized under Integrations (Notion, Linear, Airtable, Apify).
notionParentPageUrl	string	none	Notion connector only: page under which item pages are created.
maxNotifyListings	integer	50	Cap on items exported to each connector per run. Does not affect the dataset.

Output Example

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

{
  "productId": "3666294006226",
  "ean": "3666294006226",
  "title": "Perceuse Visseuse 20V Exemple + 2 Batteries 1,5 Ah + Chargeur rapide + Malette",
  "brand": "Nemura",
  "price": 79.99,
  "currency": "EUR",
  "originalPrice": 139.99,
  "discountAmount": 60.0,
  "discountPercentage": 43,
  "isOnSpecial": true,
  "promotionLabel": "Promotion",
  "sellerId": "2131",
  "sellerName": "Vendeur Partenaire Exemple",
  "soldByCastorama": false,
  "category": "Visseuse dévisseuse",
  "categoryPath": [
    { "name": "Visseuse dévisseuse", "path": "/visseuse-devisseuse/cat_id_0003519.cat" },
    { "name": "Perceuse visseuse", "path": "/perceuse-visseuse/cat_id_0003518.cat" }
  ],
  "availability": { "status": "Available", "purchasable": true, "homeDelivery": "Available", "clickAndCollect": true, "inStore": false },
  "images": ["https://media.castorama.fr/is/image/Castorama/example.jpg"],
  "image": "https://media.castorama.fr/is/image/Castorama/example.jpg",
  "url": "https://www.castorama.fr/mkp/example/3666294006226_CAFR.prd",
  "specifications": [{ "name": "Marque", "value": "Nemura" }, { "name": "Tension (en V)", "value": "20V" }],
  "description": "Perceuse visseuse sans fil 20V avec deux batteries, chargeur rapide et malette de rangement.",
  "rating": 4.75,
  "reviewCount": 4,
  "reviews": [
    { "author": "Exemple", "title": "Efficace", "body": "Facile à utiliser.", "rating": 5, "date": "2026-07-08T15:18:22.000+00:00" }
  ],
  "searchMode": "search",
  "scrapedAt": "2026-01-01T00:00:00Z"
}

Plan Requirement

The default connection, Apify Proxy on its automatic/datacenter tier, works out of the box. The storefront's own edge occasionally serves a maintenance placeholder to a share of connections regardless of tier or country, and the actor retries on a fresh connection when this happens. For large or frequent runs, switching to the residential proxy group under Connection gives more headroom.

FAQ

How much does it cost?

You pay per product returned, plus a surcharge for every enriched product that reaches the dataset: products found by search or category browsing only when Fetch product details is on, and a pasted product link always, since it always fetches full detail regardless of that setting. Never charged for an unchanged product that Incremental mode suppressed. The Pricing tab shows current rates. Use Max products to cap the cost of any run.

Is it legal to scrape Castorama?

This actor collects only publicly available product data. You are responsible for how you use it: follow Castorama's terms and the laws that apply to you, and get legal advice if you plan commercial redistribution. Prices, descriptions, images and reviews may be subject to third-party rights.

Can I get only new or changed products on a schedule?

Yes. Schedule the actor from the Schedules tab and turn on Incremental mode. Each run then returns only NEW and UPDATED products by default; unchanged products are not billed unless Emit unchanged is on. EXPIRED is returned only on a run that has Emit expired on and scans the whole tracked search; REAPPEARED is then returned on any later run that finds a product an earlier such run had marked expired.

Why didn't Brand, price range or rating apply to my pasted product link?

Those three filters narrow a search, or a pasted category/search-result link, but a single pasted product link already names one specific product, so there is nothing left to narrow. Only Only products on promotion, Only purchasable products and Sort by are still checked against a pasted product link.

Why did a run return fewer products than expected, or nothing at all?

Filters (brand, price, rating, promotion, in-stock) narrow the result set, sometimes to zero: try broadening them or check the links you provided. The storefront's edge can also intermittently refuse a share of requests, in which case the actor retries automatically on a fresh connection; if every request for a search is refused, that search returns nothing, but the run still finishes normally.

Why did my run fail instead of returning an empty dataset?

A run only fails outright when the input itself cannot be honoured: an invalid resumeFromRunId, or combining resumeFromRunId with Incremental mode on a state key that already has tracked products, since merging the two could corrupt the monitoring baseline. Connection problems with the storefront return an empty or partial result with a warning in the log instead, so "nothing matched" is never confused with "the input made no sense."

Can I use it with AI agents or MCP?

Yes. Call it from any Apify integration or MCP client, and use the connector field to push results into Notion, Linear or Airtable.

🔗 Want more e-commerce data?

Pair this actor with these related scrapers from the same team:

🥦 E.Leclerc Scraper Scrape E.Leclerc France (e.leclerc) grocery and retail products. Search by keyword or...	🥦 Auchan France Scraper Scrape Auchan.fr products: grocery, drinks, household and general merchandise. Real price...
🏷️ Leboncoin FR Pull public leboncoin.fr listings across cars, property, jobs, electronics, furniture...	🛒 OBI.de Scraper Scrape OBI (obi.de) DIY/home-improvement products: current + strike-through original...
🛒 LeroyMerlin.es Scraper Scrape Leroy Merlin Spain (leroymerlin.es) DIY and home-improvement products: price...	🛒 Cdiscount Scraper Scrape product data from Cdiscount.com by keyword, category, or URL. Apply filters and...

👉 Browse all abotapi scrapers

💬 Support & custom scrapers

• 🐞 Found a bug or a missing field? Open a ticket on the Issues tab. We usually reply within hours.
• 🛠️ Need another site, extra fields or a private build? Email abotapi@proton.me or message Telegram @abotapi.
• ⭐ Enjoying it? A quick review on the actor page helps other users find it.