# Darty Scraper — French Electronics & Appliance Prices (`studio-amba/darty-scraper`) Actor Scrape products, prices, ratings, and availability from Darty.com — France's leading electronics and home appliance retailer (Fnac Darty group). Extract TVs, smartphones, laptops, kitchen appliances, and more. - **URL**: https://apify.com/studio-amba/darty-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Darty Scraper Scrape product data, prices, ratings, and availability from [Darty.com](https://www.darty.com) -- France's leading electronics and home appliance retailer, part of the Fnac Darty group. ### How it works The scraper uses a headless browser (Playwright) to load Darty search results and product pages, then extracts product data from structured JSON-LD markup and the rendered DOM. This approach handles Darty's anti-bot protections reliably. For listing pages, it extracts product cards with name, price, image, rating, and stock info directly. For product detail pages, it pulls the full data including specifications, description, and category breadcrumbs. The scraper supports both keyword search and direct category URL scraping with automatic pagination. ### Input | Field | Type | Description | |-------|------|-------------| | `searchQuery` | string | Search term (e.g., `"aspirateur"`, `"television"`, `"machine a laver"`) | | `categoryUrl` | string | Direct category URL from darty.com | | `maxResults` | integer | Maximum number of products (default: 100) | | `proxyConfiguration` | object | Proxy settings (French residential recommended) | 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 | `"Dyson V15 Detect Absolute"` | | `brand` | string | `"Dyson"` | | `price` | number | `699.99` | | `originalPrice` | number | `799.99` | | `currency` | string | `"EUR"` | | `sku` | string | `"7890123"` | | `inStock` | boolean | `true` | | `rating` | number | `4.5` | | `reviewCount` | number | `234` | | `url` | string | Full product page URL | | `imageUrl` | string | Main product image URL | | `description` | string | Product description text | | `category` | string | `"Aspirateur > Aspirateur balai"` | | `specs` | object | Key-value technical specifications | | `scrapedAt` | string | ISO 8601 timestamp | ### Cost The scraper uses Playwright (headless browser) which consumes more resources than pure HTTP scrapers. Expect roughly 300-500 products per $1 on Apify, depending on proxy usage and the number of detail pages visited. ### Why use Darty Scraper - **Price monitoring** -- Track prices and promotions on one of France's biggest electronics retailers - **Competitive intelligence** -- Compare your catalog against Darty pricing and availability - **Market research** -- Analyze product trends, ratings, and customer sentiment in the French market - **Lead generation** -- Build product datasets for affiliate sites, comparison tools, or data feeds - **No login or cookies required** -- Works without authentication, just point and scrape ### How to use Darty 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. Configure proxy settings (French residential proxies recommended) 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 monitoring ### How to scrape Darty data This Actor automates the process of extracting structured product data from Darty.com. You can run it directly from the Apify console, the Apify API, or any of the official SDKs (JavaScript, Python). The scraper handles pagination, retries, and anti-bot protections 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 laptops ```json { "searchQuery": "ordinateur portable", "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "FR" } } ```` #### Example: Scrape a category ```json { "categoryUrl": "https://www.darty.com/nav/achat/gros_electromenager/lave-linge.html", "maxResults": 200 } ``` ### Tips for best results - **Use French residential proxies** -- Darty has anti-bot protections; French residential IPs work best - **Start small** -- run with `maxResults: 10` to verify everything works before larger jobs - **Throttle on big jobs** -- the scraper already limits concurrency, but keep runs reasonable - **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 Darty covers the full range of electronics and home appliances: - TVs, monitors, and projectors - Laptops, desktops, and tablets - Smartphones and accessories - Kitchen appliances (ovens, dishwashers, microwaves) - Laundry (washing machines, dryers) - Vacuum cleaners and floor care - Audio and headphones - Gaming consoles and accessories - Smart home devices - Small appliances (coffee makers, toasters, blenders) ### FAQ and support **Is it legal to scrape Darty?** 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 have fewer products available. Try broader keywords or increase `maxResults` and verify proxy settings. **The scraper returns 0 items -- what should I do?** Enable residential proxies with a French IP in the proxy configuration. Datacenter IPs are blocked by Darty's anti-bot system. **Can I scrape a single product?** Not directly through this actor's input. To get data for a specific product, use its product name as the search query. 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 sites change. # Actor input Schema ## `searchQuery` (type: `string`): Search for products by keyword (e.g., 'aspirateur', 'television', 'machine a laver'). ## `categoryUrl` (type: `string`): A Darty category page URL to scrape. Example: https://www.darty.com/nav/achat/gros\_electromenager/lave-linge.html. If provided, takes priority over search query. ## `maxResults` (type: `integer`): Maximum number of products to return. ## `proxyConfiguration` (type: `object`): Proxy settings. Residential proxies with French IPs recommended for best results. ## Actor input object example ```json { "searchQuery": "aspirateur", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "FR" } } ``` # 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": "aspirateur", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "FR" } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/darty-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": "aspirateur", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "FR", }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/darty-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": "aspirateur", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "FR" } }' | apify call studio-amba/darty-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/darty-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Darty Scraper — French Electronics & Appliance Prices", "description": "Scrape products, prices, ratings, and availability from Darty.com — France's leading electronics and home appliance retailer (Fnac Darty group). Extract TVs, smartphones, laptops, kitchen appliances, and more.", "version": "0.1", "x-build-id": "ieCdUfhNNksmeiQ11" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~darty-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-darty-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~darty-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-darty-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~darty-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-darty-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., 'aspirateur', 'television', 'machine a laver')." }, "categoryUrl": { "title": "Category URL", "type": "string", "description": "A Darty category page URL to scrape. Example: https://www.darty.com/nav/achat/gros_electromenager/lave-linge.html. If provided, takes priority over search query." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of products to return.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies with French IPs recommended for best results." } } }, "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 } } } } } } } } } } ```