# Bricorama Scraper — French DIY & Home Improvement Products (`studio-amba/bricorama-scraper`) Actor Scrape products from Bricorama.fr, the French DIY retailer with 100+ stores. Tools, paint, flooring, bathroom, kitchen, garden, and building materials. - **URL**: https://apify.com/studio-amba/bricorama-scraper.md - **Developed by:** [Jelle Desramaults](https://apify.com/studio-amba) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Bricorama Scraper Extract product data, prices, ratings, and stock information from bricorama.fr -- a French DIY and home improvement chain with over 100 stores across France. Scrape tools, paint, flooring, plumbing, garden supplies, bathroom fixtures, and kitchen fittings. ### What is Bricorama Scraper? Bricorama is a well-established French DIY retailer that competes in the mid-market segment alongside Leroy Merlin, Castorama, and Brico Depot. With a network of stores throughout France and a comprehensive online catalog, Bricorama serves both casual renovators and serious bricoleurs. This scraper extracts structured product data from their website. Typical use cases include: - **French DIY market intelligence** -- Monitor how Bricorama prices compare to Leroy Merlin, Castorama, and Brico Depot across product categories. Track who has the lowest prices on tools, paint, and flooring - **Cross-border price comparison** -- Compare French hardware pricing against German (OBI, Hornbach, Hagebau), Belgian (Brico, Hubo), and Nordic (Byggmax, Jula) retailers. The same DeWalt or Bosch product can cost 20-40% more or less depending on the country - **Product catalog mapping** -- Extract full category structures and brand assortments for market entry research or competitive positioning - **Seasonal promotion monitoring** -- Track French DIY promotional cycles: spring garden, summer outdoor, back-to-school renovation, and winter heating campaigns - **EAN-based matching** -- Use EAN barcodes to match identical products across multiple European retailers for true like-for-like price comparison ### What data does Bricorama Scraper extract? Each scraped product includes the following fields when available: - 🏷️ **Product name** -- Full product title in French - 🏢 **Brand** -- Manufacturer name - 💰 **Price** -- Current price in EUR - 🔖 **Original price** -- Pre-sale price for discounted items - 🔗 **EAN** -- European Article Number (barcode) for cross-retailer matching - 🔢 **SKU** -- Bricorama product reference - 📦 **In stock** -- Whether the product is available - ⭐ **Rating** -- Customer rating (normalized to 0-5 scale) - 💬 **Review count** -- Number of customer reviews - 🖼️ **Image URL** -- Main product image - 🖼️ **Image URLs** -- Full product gallery - 📝 **Description** -- Product description text (HTML stripped) - 📂 **Category** -- Product category and breadcrumb path - 🌐 **Language** -- Always `"fr"` (French) ### How to scrape Bricorama #### Search by keyword ```json { "searchQuery": "perceuse", "maxResults": 100 } ```` Good French search terms: `"perceuse"` (drill), `"peinture"` (paint), `"parquet"` (wood flooring), `"robinet"` (faucet), `"tondeuse"` (lawn mower), `"carrelage"` (tiles), `"radiateur"` (radiator). #### Scrape a category ```json { "categoryUrl": "https://www.bricorama.fr/outillage", "maxResults": 500 } ``` #### Input reference | Field | Type | Description | |-------|------|-------------| | `searchQuery` | String | French keyword (e.g., `"perceuse"`, `"peinture"`) | | `categoryUrl` | String | Bricorama.fr category page URL | | `maxResults` | Integer | Product limit (default: 100, max: 50,000) | | `proxyConfiguration` | Object | Proxy settings for reliability | **Tip:** The scraper sends `accept-language: fr-FR` headers automatically for optimal compatibility with Bricorama's server. If you do not provide any input, it defaults to an empty run -- always set at least a search query or category URL. ### Output ```json [ { "name": "Perceuse visseuse sans fil 18V Bosch GSR 18V-28", "brand": "Bosch", "price": 129.90, "currency": "EUR", "originalPrice": 159.90, "ean": "3165140951036", "sku": "BRC-0601901R08", "inStock": true, "rating": 4.4, "reviewCount": 67, "imageUrl": "https://www.bricorama.fr/media/catalog/product/bosch-gsr-18v-28.jpg", "imageUrls": [ "https://www.bricorama.fr/media/catalog/product/bosch-gsr-18v-28.jpg", "https://www.bricorama.fr/media/catalog/product/bosch-gsr-18v-28-side.jpg" ], "description": "Perceuse visseuse sans fil 18V avec 2 batteries 2,0 Ah, chargeur rapide et coffret de transport. Couple max 63 Nm.", "category": "Outillage electroportatif", "categories": ["Outillage", "Outillage electroportatif", "Perceuses"], "language": "fr", "url": "https://www.bricorama.fr/perceuse-visseuse-bosch-gsr-18v-28.html", "scrapedAt": "2026-04-03T10:00:00.000Z" }, { "name": "Peinture murs et plafonds blanc mat 10L V33", "brand": "V33", "price": 49.90, "currency": "EUR", "inStock": true, "rating": 4.1, "reviewCount": 134, "imageUrl": "https://www.bricorama.fr/media/catalog/product/v33-peinture-blanc-mat-10l.jpg", "description": "Peinture monocouche haute opacite pour murs et plafonds. Seche au toucher en 30 minutes. Rendement 12 m2/L.", "category": "Peinture interieure", "categories": ["Peinture", "Peinture interieure", "Peinture blanche"], "language": "fr", "url": "https://www.bricorama.fr/peinture-murs-plafonds-blanc-mat-10l-v33.html", "scrapedAt": "2026-04-03T10:00:15.000Z" }, { "name": "Lame de terrasse composite gris 2400x145x21 mm", "brand": "Blooma", "price": 15.90, "currency": "EUR", "originalPrice": 19.90, "inStock": true, "imageUrl": "https://www.bricorama.fr/media/catalog/product/lame-terrasse-composite-gris.jpg", "description": "Lame de terrasse en bois composite resistant aux intemperies. Surface antiderapante. Garantie 10 ans.", "category": "Terrasse", "categories": ["Jardin", "Terrasse", "Lames de terrasse"], "language": "fr", "url": "https://www.bricorama.fr/lame-terrasse-composite-gris-2400mm.html", "scrapedAt": "2026-04-03T10:00:28.000Z" } ] ``` Export in **JSON**, **CSV**, **Excel**, **XML**, or **RSS** from the Apify dataset tab. ### How much does it cost? Bricorama Scraper uses CheerioCrawler (lightweight HTTP requests), keeping costs minimal. | Scenario | Products | Estimated cost | |----------|----------|----------------| | Quick product search | 50 | ~$0.03 | | Category monitoring | 200 | ~$0.10 | | Multi-category export | 1,000 | ~$0.50 | | Broad catalog crawl | 5,000 | ~$2.50 | The Apify free tier covers most monitoring workflows. No headless browser is needed, so runs are fast and compute-efficient. ### Can I integrate? Route Bricorama product data anywhere: - **Webhooks** -- Get notified when a scrape run completes - **Google Sheets** -- Auto-export to shared spreadsheets - **Slack / Microsoft Teams** -- Price drop alerts for tracked products - **Zapier / Make** -- Connect to 5,000+ apps - **Amazon S3 / Google Cloud Storage** -- Cloud storage for data pipelines - **PostgreSQL / MySQL / BigQuery** -- Direct database ingestion - **API** -- Programmatic access from any language ### Can I use it as an API? #### Python ```python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") run = client.actor("studio-amba/bricorama-scraper").call(run_input={ "searchQuery": "peinture", "maxResults": 100, }) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(f"{item['name']} - EUR {item['price']}") ``` #### JavaScript ```javascript import { ApifyClient } from "apify-client"; const client = new ApifyClient({ token: "YOUR_API_TOKEN" }); const run = await client.actor("studio-amba/bricorama-scraper").call({ searchQuery: "peinture", maxResults: 100, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach(item => console.log(`${item.name} - EUR ${item.price}`)); ``` ### FAQ **How does Bricorama compare to other French DIY sites?** Bricorama occupies the mid-market. Brico Depot focuses on trade and budget buyers, Leroy Merlin targets premium renovators, and Castorama sits in between. Scraping all four gives you complete French DIY market coverage. **Does the scraper get EAN barcodes?** Yes, when available in the JSON-LD structured data. EANs allow you to match identical products across Bricorama, Leroy Merlin, Brico Depot, and even German or Nordic retailers for true like-for-like comparison. **Can I scrape multiple categories in one run?** Set `categoryUrl` to a top-level category and the scraper will follow subcategory links and pagination automatically. For truly separate categories, run the actor multiple times with different URLs. **Are prices including or excluding VAT?** All prices are TTC (toutes taxes comprises) -- the consumer price including French VAT at 20%. **What if a product page has no JSON-LD?** The scraper falls back to HTML parsing using `itemprop` attributes, CSS class patterns, and breadcrumb navigation. Most products return complete data through one method or the other. **How do I monitor specific products over time?** Use Apify's scheduler to run the scraper daily or weekly with the same input. Each run creates a new dataset so you can track prices over time by comparing datasets. ### Limitations - All data is in French from bricorama.fr - Product detail extraction combines JSON-LD and HTML fallback, so field completeness may vary by product page - Pagination is handled automatically but stops when no more "next page" links are found - The scraper does not extract store-level stock or click-and-collect availability - Very large categories (10,000+ products) should be split across multiple runs for reliability ### Other DIY & hardware scrapers Build a complete European DIY price database by combining scrapers from our collection: - [Gamma Scraper](https://apify.com/studio-amba/gamma-scraper) -- Netherlands - [Leroy Merlin Scraper](https://apify.com/studio-amba/leroymerlin-scraper) -- France - [Brico Scraper](https://apify.com/studio-amba/brico-scraper) -- Belgium - [Praxis Scraper](https://apify.com/studio-amba/praxis-scraper) -- Netherlands - [OBI Scraper](https://apify.com/studio-amba/obi-scraper) -- Germany - [Hornbach Scraper](https://apify.com/studio-amba/hornbach-scraper) -- Germany/Europe - [Bauhaus Scraper](https://apify.com/studio-amba/bauhaus-scraper) -- Germany/Europe - [Castorama Scraper](https://apify.com/studio-amba/castorama-scraper) -- France/Poland - [Hubo Scraper](https://apify.com/studio-amba/hubo-scraper) -- Belgium/Netherlands - [Toom Scraper](https://apify.com/studio-amba/toom-scraper) -- Germany - [Hagebau Scraper](https://apify.com/studio-amba/hagebau-scraper) -- Germany - [Globus Baumarkt Scraper](https://apify.com/studio-amba/globus-baumarkt-scraper) -- Germany - [Brico Depot Scraper](https://apify.com/studio-amba/bricodepot-scraper) -- France - [Byggmax Scraper](https://apify.com/studio-amba/byggmax-scraper) -- Sweden - [Bricomarche Scraper](https://apify.com/studio-amba/bricomarche-scraper) -- France - [Clas Ohlson Scraper](https://apify.com/studio-amba/clasohlson-scraper) -- Scandinavia - [Jula Scraper](https://apify.com/studio-amba/jula-scraper) -- Sweden - [K-Rauta Scraper](https://apify.com/studio-amba/krauta-scraper) -- Finland ### Your feedback This scraper is actively maintained. If you encounter issues, missing data, or have feature requests, drop us a message on the actor's Apify Store page or the community forum. We prioritize feedback from active users. # Actor input Schema ## `searchQuery` (type: `string`): Search for products by keyword (e.g., 'perceuse', 'peinture', 'parquet'). ## `categoryUrl` (type: `string`): A Bricorama category page URL to scrape. Example: https://www.bricorama.fr/outillage. If empty and no search query, nothing will be scraped. ## `maxResults` (type: `integer`): Maximum number of products to return. ## `proxyConfiguration` (type: `object`): Proxy settings for better reliability. ## Actor input object example ```json { "searchQuery": "perceuse", "maxResults": 100 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQuery": "perceuse" }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/bricorama-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQuery": "perceuse" } # Run the Actor and wait for it to finish run = client.actor("studio-amba/bricorama-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQuery": "perceuse" }' | apify call studio-amba/bricorama-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/bricorama-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Bricorama Scraper — French DIY & Home Improvement Products", "description": "Scrape products from Bricorama.fr, the French DIY retailer with 100+ stores. Tools, paint, flooring, bathroom, kitchen, garden, and building materials.", "version": "0.1", "x-build-id": "z5zNsECVXk6R2pifb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~bricorama-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-bricorama-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/studio-amba~bricorama-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-bricorama-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/studio-amba~bricorama-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-bricorama-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Search for products by keyword (e.g., 'perceuse', 'peinture', 'parquet')." }, "categoryUrl": { "title": "Category URL", "type": "string", "description": "A Bricorama category page URL to scrape. Example: https://www.bricorama.fr/outillage. If empty and no search query, nothing will be scraped." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Maximum number of products to return.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for better reliability." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```