# Auchan Scraper: prices, stock and ratings from Russian retail (`isolovyev/ru-retail-chains-extended`) Actor Scrape Auchan products: price, old price, brand, rating, review count and stock quantity per store. Same schema as our other Russian retail Actors. - **URL**: https://apify.com/isolovyev/ru-retail-chains-extended.md - **Developed by:** [Ivan Solovyev](https://apify.com/isolovyev) (community) - **Categories:** E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## 🛒 Auchan Scraper: prices, stock and ratings from Russian retail

Auchan prices, ratings and real shelf stock, as numbers.
Search Auchan, one of the largest hypermarket chains in Russia, and get price, old price, brand, rating, review count and units in stock per store, in the same schema as our other Russian retail Actors, so several chains line up in one table.

🛒 Auchan catalogue
Price, old price, brand and rating for every product a query returns

📦 Units in stock
Actual shelf quantity per store, a number most grocery chains never publish

🏬 Per store
Choose the store: assortment and stock change, the price stays the same

🛡️ Partial-safe
If the catalogue cannot be reached the run still finishes, reason recorded

Currently covering **Auchan**. More chains with this depth of data are being added to this same Actor, so an input that works today keeps working as coverage grows. ### What you get | Field | Note | |---|---| | `title`, `brand` | product name and brand | | `price`, `oldPrice` | current price and the price it was discounted from | | `rating`, `reviewsCount` | customer rating and how many reviews it is based on | | **`stockQty`** | units currently available in the selected store | | `storeId` | which store the row belongs to | | `totalFound` | how many products the chain has for this query | Stock quantity and review counts are the interesting part: most Russian grocery chains publish neither, so shelf availability normally has to be inferred. Here it is a number. ### Input | Field | Description | |---|---| | `queries` | Search terms | | `maxItemsPerQuery` | Upper bound of products per query | | `auchanMerchantId` | Which store to query. Changes assortment and stock, not price | | `proxyConfiguration` | Residential proxy, country RU. The chain serves its catalogue to Russian addresses | ### Quick start ```json { "queries": ["молоко", "кофе"], "maxItemsPerQuery": 60 } ```` ### Scope notes - The store selector changes which products are listed and how many units are in stock. Prices are the same across stores, so compare stores for availability rather than for price. - `totalFound` is the chain's own count for the query and is usually far larger than one run collects. Raise `maxItemsPerQuery` to go deeper. - Covering more chains: [Russian Retail Chains Scraper](https://apify.com/isolovyev/ru-retail-chains-scraper) returns eight chains in this same schema, including Magnit, Metro, M.Video and Dixy. ### Reliability If the catalogue cannot be reached, the run still finishes and records the reason in `sourceErrors` rather than returning an empty result that would look like "nothing found". ### RU / На русском Актор собирает товары сети Ашан (список сетей будет расширяться в этом же акторе): название, бренд, текущую и старую цену, рейтинг, число отзывов, **остаток в штуках** и магазин, к которому относится строка. Схема данных общая с остальными нашими акторами по российской рознице, поэтому выдачи нескольких сетей складываются в одну таблицу без ручной сверки. Остатки и число отзывов тут главная ценность: большинство продуктовых сетей не публикуют ни того, ни другого, и наличие на полке обычно приходится додумывать. Выбор магазина меняет состав выдачи и остатки, но не цену: сравнивать магазины имеет смысл по наличию, а не по ценам. Поле `totalFound` показывает, сколько всего товаров у сети по запросу, это обычно намного больше, чем собирается за один прогон. Больше сетей в той же схеме (Магнит, Метро, М.Видео, Дикси и другие) собирает соседний актор [Russian Retail Chains Scraper](https://apify.com/isolovyev/ru-retail-chains-scraper). Billed per result plus platform usage. Current price is shown in the Pricing section. *** ### 🔗 Все наши акторы для данных по России, Казахстану и СНГ Одна линейка для маркетплейсов, розничных сетей, госзакупок и проверки контрагентов - соседний актор открывается одним кликом по карточке.

🛍️ Лиды продавцов маркетплейсов продавцы WB / Ozon / Яндекс.Маркет / Kaspi с ИНН и ОГРН	📄 Тендеры 44-ФЗ / 223-ФЗ госзакупки, нацрежим, реестр российского ПО	🔍 Проверка контрагента по ИНН 5 источников, скоринг риска	🏛️ Реестр российского ПО проверка по ИНН + досье заявителя
📈 Цены на маркетплейсах WB / Ozon / Яндекс.Маркет / Avito, трекинг цены	🇰🇿 Цены и позиции на Kaspi.kz Казахстан, позиция в выдаче и цена	🏪 Розничные сети РФ Магнит, Метро, М.Видео, Дикси, Глобус, Купер в единой схеме	🛒 Ашан: цены и остатки цена, старая цена, остаток в штуках, рейтинг ● ВЫ ЗДЕСЬ

# Actor input Schema ## `queries` (type: `array`): Search terms. Each term is run against every selected chain. ## `platforms` (type: `array`): Which chains to query. ## `maxItemsPerQuery` (type: `integer`): Upper bound of products collected per query and chain. ## `auchanMerchantId` (type: `integer`): Store to query. The store changes the assortment and stock levels; prices are the same across stores. ## `proxyConfiguration` (type: `object`): Residential proxy, country RU. Russian retail serves its catalogue to Russian addresses. ## Actor input object example ```json { "queries": [ "молоко", "кофе" ], "platforms": [ "auchan" ], "maxItemsPerQuery": 10, "auchanMerchantId": 3, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "RU" } } ``` # 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 = { "queries": [ "молоко" ], "platforms": [ "auchan" ], "maxItemsPerQuery": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "RU" } }; // Run the Actor and wait for it to finish const run = await client.actor("isolovyev/ru-retail-chains-extended").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 = { "queries": ["молоко"], "platforms": ["auchan"], "maxItemsPerQuery": 10, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "RU", }, } # Run the Actor and wait for it to finish run = client.actor("isolovyev/ru-retail-chains-extended").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 '{ "queries": [ "молоко" ], "platforms": [ "auchan" ], "maxItemsPerQuery": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "RU" } }' | apify call isolovyev/ru-retail-chains-extended --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=isolovyev/ru-retail-chains-extended", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Auchan Scraper: prices, stock and ratings from Russian retail", "description": "Scrape Auchan products: price, old price, brand, rating, review count and stock quantity per store. Same schema as our other Russian retail Actors.", "version": "0.1", "x-build-id": "jnf2HOUifb1rFN7QM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/isolovyev~ru-retail-chains-extended/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-isolovyev-ru-retail-chains-extended", "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/isolovyev~ru-retail-chains-extended/runs": { "post": { "operationId": "runs-sync-isolovyev-ru-retail-chains-extended", "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/isolovyev~ru-retail-chains-extended/run-sync": { "post": { "operationId": "run-sync-isolovyev-ru-retail-chains-extended", "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": { "queries": { "title": "Search queries", "type": "array", "description": "Search terms. Each term is run against every selected chain.", "items": { "type": "string" } }, "platforms": { "title": "Chains", "type": "array", "description": "Which chains to query.", "items": { "type": "string", "enum": [ "auchan" ], "enumTitles": [ "Auchan (hypermarket)" ] }, "default": [ "auchan" ] }, "maxItemsPerQuery": { "title": "Max items per query", "minimum": 1, "maximum": 500, "type": "integer", "description": "Upper bound of products collected per query and chain.", "default": 60 }, "auchanMerchantId": { "title": "Auchan store", "type": "integer", "description": "Store to query. The store changes the assortment and stock levels; prices are the same across stores.", "default": 3 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Residential proxy, country RU. Russian retail serves its catalogue to Russian addresses.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "RU" } } } }, "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 } } } } } } } } } } ```