# Boulanger Scraper — French Electronics & Appliance Prices (`studio-amba/boulanger-scraper`) Actor

Scrape products, prices, brands, and stock status from Boulanger.com — France's leading electronics and home appliance retailer. Extract TVs, smartphones, laptops, kitchen appliances, and more via search or category pages.

- **URL**: https://apify.com/studio-amba/boulanger-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 result scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Boulanger Scraper

Scrape product data, prices, brands, and stock status from [Boulanger.com](https://www.boulanger.com) — France's leading electronics and home appliance retailer, part of the Auchan/Mulliez group.

### How it works

Boulanger.com blocks plain HTTP requests and even a real Chromium browser's automatic/free proxy traffic at the Akamai edge (verified: both return an HTTP 400 "Invalid URL" response with no content, `server: AkamaiGHost`). This actor routes every request through Bright Data's Web Unlocker to get past that block, then parses the returned HTML directly — no headless browser rendering is needed.

Boulanger's search and category pages are a client-hydrated single-page app, but the raw server-rendered HTML still carries the full page of results in two inline data blocks: a Tag Commander analytics array (price, brand, SKU, category, stock) and a schema.org `ItemList` JSON-LD block (proper product name, image, URL). The actor reads both and joins them by product ID, so a single request per page of ~40 products is enough for the standard fields — there's no need to visit every product's own page.

For EAN barcodes, star ratings, and full descriptions (not present on listing pages), turn on the optional `fetchDetails` input — it fetches each product's own page for that extra data, at the cost of one additional request per product.

The scraper supports keyword search, direct category URL scraping, or a list of specific URLs, all with automatic pagination.

### Input

| Field | Type | Description |
|-------|------|-------------|
| `searchQuery` | string | Search term (e.g., `"aspirateur"`, `"televiseur"`, `"lave-linge"`) |
| `categoryUrl` | string | Direct category URL from boulanger.com, e.g. `https://www.boulanger.com/c/accessoire-aspirateur` |
| `startUrls` | array | Specific search, category, or `/ref/` product URLs to scrape (max 50) |
| `maxResults` | integer | Maximum number of products to return (default: 100) |
| `fetchDetails` | boolean | OFF by default. Turn on to also fetch each product's detail page for EAN, rating, review count, description and specs — roughly doubles the number of requests |
| `brightDataApiKey` | string | Your own Bright Data Web Unlocker key. Optional — leave empty to use the operator's default key |

When no input is provided, it defaults to searching for `"aspirateur"` (vacuum cleaners).

### Output

Each product includes the following fields:

| Field | Type | Example |
|-------|------|---------|
| `name` | string | `"Aspirateur sans sac ROWENTA Compact Cyclonic Power XXL RO4B25EA"` |
| `brand` | string | `"ROWENTA"` |
| `price` | number | `99.0` |
| `currency` | string | `"EUR"` |
| `sku` | string | `"1189684"` |
| `ean` | string | `"3221616093096"` (only with `fetchDetails`) |
| `inStock` | boolean | `true` |
| `rating` | number | `4.5` (only with `fetchDetails`) |
| `reviewCount` | number | `183` (only with `fetchDetails`) |
| `url` | string | Full product page URL |
| `imageUrl` | string | Main product image URL |
| `productDescription` | string | Product description text (only with `fetchDetails`) |
| `category` | string | `"maison - entretien - jardin > aspirateur > aspirateur balai"` |
| `scrapedAt` | string | ISO 8601 timestamp |

### Example output

```json
{
    "name": "Aspirateur sans sac ROWENTA Compact Cyclonic Power XXL RO4B25EA",
    "brand": "ROWENTA",
    "price": 99.0,
    "currency": "EUR",
    "sku": "1189684",
    "inStock": true,
    "category": "maison - entretien - jardin > aspirateur > aspirateur balai",
    "imageUrl": "https://boulanger.scene7.com/is/image/Boulanger/3221616093096_h_f_l_0",
    "url": "https://www.boulanger.com/ref/1189684",
    "scrapedAt": "2026-09-14T09:18:19.065Z"
}
```

### Cost

Each listing-page request returns around 40 products, and Bright Data's Web Unlocker costs roughly $0.0015 per request — well under a tenth of a cent per result. With `fetchDetails` off, expect several thousand products per $1 of Apify credits. Turning `fetchDetails` on adds one Bright Data request per product, so budget for roughly half as many results per $1.

A run's usage cost only settles once the run has finished with status **SUCCEEDED** — check the final cost after completion, not mid-run.

### Why use Boulanger Scraper

- **Price monitoring** — Track prices and stock on one of France's biggest electronics and appliance retailers
- **Competitive intelligence** — Compare your catalog against Boulanger's pricing and availability
- **Market research** — Analyze product ranges, brands, and category depth in the French electronics market
- **Lead generation** — Build product datasets for affiliate sites, comparison tools, or price-tracking feeds
- **No login or cookies required** — Works without authentication, just point and scrape

### How to use Boulanger Scraper

1. Open the **Input** tab and enter a search query or category URL
2. Set `maxResults` to control how many products to extract
3. Turn on `fetchDetails` only if you need EAN, ratings, or descriptions
4. Click **Start** and wait for the run to complete
5. Download results from the **Output** tab in JSON, CSV, Excel, XML, or HTML
6. Schedule recurring runs from the **Schedule** tab for ongoing price monitoring

### How to scrape Boulanger data

This Actor automates the process of extracting structured product data from Boulanger.com. You can run it directly from the Apify console, the Apify API, or any of the official SDKs (JavaScript, Python). The scraper handles Boulanger's Akamai anti-bot protection, pagination, and retries so you can focus on the data.

Typical workflows:

- **One-off export**: paste a search keyword or category URL, set `maxResults`, and run
- **Scheduled monitoring**: set a daily or weekly cron in the Schedule tab to track prices over time
- **Programmatic integration**: trigger runs from your backend via the Apify API and pull the dataset when finished
- **Webhook automation**: receive a callback the moment a run completes and pipe results into Zapier, Make, n8n, BigQuery, or Google Sheets

#### Example: Search for TVs

```json
{
    "searchQuery": "televiseur",
    "maxResults": 50
}
```

#### Example: Scrape a category

```json
{
    "categoryUrl": "https://www.boulanger.com/c/accessoire-aspirateur",
    "maxResults": 200
}
```

#### Example: With EAN and ratings

```json
{
    "searchQuery": "aspirateur",
    "maxResults": 30,
    "fetchDetails": true
}
```

### Tips for best results

- **Start small** — run with `maxResults: 10` to verify everything works before larger jobs
- **Leave `fetchDetails` off** unless you specifically need EAN, ratings, or full descriptions — it roughly doubles run cost and time
- **Use category URLs for full-catalogue pulls** — they're more stable than search keywords for repeat monitoring
- **Schedule regular runs** — daily or weekly monitoring captures price changes effectively
- **Check the dataset schema** — the Storage tab shows the full output structure with all available fields

### Supported product categories

Boulanger covers the full range of consumer electronics and home appliances:

- TVs, monitors, and home cinema
- Laptops, desktops, and tablets
- Smartphones and accessories
- Kitchen appliances (ovens, dishwashers, microwaves)
- Laundry (washing machines, dryers)
- Vacuum cleaners and floor care
- Audio, headphones, and speakers
- Gaming consoles and accessories
- Connected home and smart devices
- Small appliances (coffee makers, toasters, blenders)

### FAQ and support

**Is it legal to scrape Boulanger?** This Actor extracts publicly available data. Always review the website's Terms of Service before scraping at scale, and respect rate limits.

**Why am I getting fewer results than expected?** Some searches or categories have fewer products available than `maxResults`. Try a broader keyword, or check the site directly for the total result count.

**The scraper returns 0 items — what should I do?** Check that a valid Bright Data API key is configured. Boulanger blocks plain proxies entirely, so this is the one dependency that has to be right.

**Can I get EAN barcodes and ratings?** Yes — turn on `fetchDetails` in the input. It's off by default because most price-monitoring use cases only need name, price, brand, and stock status, which are already included at no extra cost.

For issues, feature requests, or bug reports, open a ticket in the Issues tab on the Actor page or contact support. We monitor every actor and ship fixes quickly when the site changes.

# Actor input Schema

## `searchQuery` (type: `string`):

Search for products by keyword (e.g., 'aspirateur', 'televiseur', 'lave-linge').

## `categoryUrl` (type: `string`):

A Boulanger category page URL to scrape. Example: https://www.boulanger.com/c/accessoire-aspirateur

## `startUrls` (type: `array`):

List of Boulanger URLs to scrape (search results pages, category pages, or product detail pages under /ref/). Max 50 URLs per run.

## `maxResults` (type: `integer`):

Maximum number of products to return.

## `fetchDetails` (type: `boolean`):

OFF by default. Listing/search pages already return name, brand, price, currency, SKU, stock status, category and image for every product — no extra requests needed. Turning this ON makes the actor fetch each product's own page for EAN/GTIN barcode, star rating, review count, full description and specs. This roughly doubles the number of requests (one extra Bright Data request per product) and increases run cost and time accordingly — leave OFF unless you specifically need EAN or ratings.

## `brightDataApiKey` (type: `string`):

Your Bright Data API key for the Web Unlocker zone. Required to bypass Boulanger's Akamai anti-bot protection. Leave empty to use the operator's default key. Get your own at https://brightdata.com

## `proxyConfiguration` (type: `object`):

Not used for fetching Boulanger pages (Bright Data Web Unlocker handles that) — kept for platform compatibility.

## Actor input object example

```json
{
  "searchQuery": "aspirateur",
  "maxResults": 100,
  "fetchDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQuery": "aspirateur",
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/boulanger-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQuery": "aspirateur",
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/boulanger-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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": "aspirateur",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call studio-amba/boulanger-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/boulanger-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/kqCYDwrDNpNhJLcDG/builds/R4G5GLE7NcAGeeqfQ/openapi.json