# X-Com Shop Scraper (`crawlerbros/xcom-shop-scraper`) Actor Scrape XCOM-SHOP (xcom-shop.ru) - a major Russian electronics and computer retailer. Search products, browse categories, and fetch full product details including price, availability, images, ratings, and reviews. - **URL**: https://apify.com/crawlerbros/xcom-shop-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** E-commerce, Automation, Integrations - **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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## X-Com Shop Scraper Scrape [XCOM-SHOP](https://www.xcom-shop.ru) (xcom-shop.ru) — one of Russia's largest electronics and computer retailers, selling laptops, PCs, components, networking gear, office equipment, security systems, and more. Search for products, browse any catalog category, or fetch complete product details including price, stock status, images, ratings, and customer reviews. No login, no cookies, no paid proxy required. ### What this actor does - **Search** — free-text product search (matches the site's own search box), returns up to 100 relevant results per run - **Browse by category** — walk any of the 16 top-level catalog sections (or a specific sub-category URL/slug) with full pagination - **Product details** — fetch full specs, pricing, availability, images, rating, and customer reviews for one or more product URLs - **Filters** — price range, brand, in-stock only, sort order (price/name/popularity/availability) - Prices are always in Russian rubles (RUB) - Empty fields are omitted from every record — no `null`, no placeholder values ### Output per product **Search & category listing records:** - `productId` — numeric XCOM-SHOP product ID - `name`, `brand` - `price`, `currency` (`RUB`) - `available` — in-stock flag (when known) - `productUrl`, `sourceUrl` - `imageUrl`, `imageUrls[]` - `categoryName`, `categoryUrl`, `categoryId` — numeric Bitrix catalog section ID - `rating`, `reviewsCount` - `relevanceScore` — the search engine's own relevance ranking score for this result (`search` mode only) - `listPosition` — the product's rank/position on its category listing page (`byCategory` mode only) - `shortDescription` — key spec bullets (screen, CPU, RAM, storage, etc.) - `oldPrice`, `discountPercent` — when the product is on sale (category listing only) - `loyaltyPoints` — bonus/cashback points earned on purchase (category listing only) - `deliveryEstimate`, `pickupEstimate` — courier delivery / in-store pickup date estimate (a date like `25.07.2026` or a relative label like `Завтра`/`Послезавтра`) - `carrierTransferEstimate` — date the item ships to the carrier network (`search` mode only) - `recordType: "product"`, `scrapedAt` **Product detail records** (mode=`productDetails`) additionally include: - `availability` — raw stock status - `images[]` — full-resolution gallery - `categoryPath[]` — full breadcrumb trail - `ratingValue`, `ratingCount`, `reviewCount` - `reviews[]` — one entry per published review, with: - `author`, `rating`, `datePublished` - `body` — the review's raw `schema.org` text - `pros`, `cons` — the reviewer's separately-submitted "Достоинства" (pros) / "Недостатки" (cons) fields, when the reviewer filled them in - `comment` — the reviewer's free-text comment, when given - `helpfulVotes`, `unhelpfulVotes` — other shoppers' 👍/👎 vote counts on the review - `specifications[]` — full grouped spec table: `[{ "group": "Экран", "specs": { "Диагональ экрана": "15.6 \"", ... } }, ...]` covering every characteristic section the product page publishes (screen, CPU, RAM, storage, ports, dimensions, power, etc.) - `deliveryEstimate`, `pickupEstimate`, `carrierTransferEstimate` — same delivery estimates as listing records - `recordType: "productDetail"` ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `search` | `search` / `byCategory` / `productDetails` | | `searchQuery` | string | `ноутбук` | Free-text query (mode=search) | | `category` | string (select) | – | Top-level catalog category (mode=byCategory) | | `categoryUrl` | string | – | Exact sub-category slug or URL, overrides `category` | | `productUrls` | array | – | Product page URLs (mode=productDetails) | | `sortBy` | string (select) | `popularity` | `popularity` / `priceAsc` / `priceDesc` / `name` / `availability` (mode=byCategory) | | `minPrice` / `maxPrice` | int | – | Price range filter in RUB | | `brand` | string | – | Case-insensitive brand filter | | `inStockOnly` | bool | `false` | Only emit in-stock products | | `maxItems` | int | `20` | Hard cap on emitted records (1–2000) | | `proxyConfiguration` | object | AUTO | Apify proxy (free datacenter group); not required for this site | #### Example: browse laptops sorted by price, in stock only ```json { "mode": "byCategory", "categoryUrl": "kompyutery_i_noytbyki/noytbyki", "sortBy": "priceAsc", "inStockOnly": true, "maxItems": 50 } ```` #### Example: search for a brand with a price ceiling ```json { "mode": "search", "searchQuery": "ноутбук", "brand": "Lenovo", "maxPrice": 100000, "maxItems": 30 } ``` #### Example: fetch full details for specific products ```json { "mode": "productDetails", "productUrls": [ "https://www.xcom-shop.ru/huawei_mitchellg-w5611d_1106075.html", "https://www.xcom-shop.ru/lenovo_ideapad_1_15iru7_1298430.html" ] } ``` ### Use cases - **Price monitoring** — track price changes for specific products or an entire category over time - **Competitor research** — compare brand assortment, pricing, and stock levels across Russian electronics retailers - **Market research** — analyze rating and review data for popular laptop/PC brands - **Catalog enrichment** — pull product images, specs, and descriptions for a comparison dataset ### Other Russian marketplace actors by CrawlerBros | Actor | URL | |---|---| | Citilink Scraper - Russian Electronics Store Products | | | DNS-Shop Scraper | | | Eldorado Scraper | | | ETM Electrical Equipment Scraper | | | Holodilnik.ru Scraper | | | Lemanapro Scraper | | | Magnit Market (mm.ru) Scraper | | | Maxidom Scraper | | | Megamarket.ru Scraper | | | M.Video Scraper | | | Onlinetrade.ru Scraper | | | Ozon Scraper - Products, Categories & Search | | | Petrovich Building Materials Scraper | | | Regard Scraper | | | Russkiy Svet (rs24.ru) Electrical Equipment Scraper | | | Technopark.ru Scraper - Products, Categories & Search | | | VseInstrumenti.ru Scraper | | | Wildberries Scraper | | | X-Com Shop Scraper (this actor) | | | Yandex Market Pro Scraper | | ### FAQ **Do I need a proxy or login?** No. XCOM-SHOP serves full product data without authentication, and the default Apify AUTO (datacenter) proxy group is sufficient — most requests work without any proxy at all. **What currency are prices in?** Always Russian rubles (RUB), matching the site's default display. **How many products can I get from `search`?** The search endpoint returns up to 100 relevant matches per query (matching the site's own search relevance ranking). For larger volumes, use `byCategory` instead, which paginates through the full catalog section. **Why did my search for a very unusual term return unrelated products?** XCOM-SHOP's own search falls back to related/popular suggestions when a query has no close match, rather than returning nothing — the same behavior you'd see typing the query into the site's search box. All returned products are real, current catalog items. **Can I browse a specific sub-category, not just a top-level one?** Yes — set `categoryUrl` to the sub-category's slug (e.g. `kompyutery_i_noytbyki/noytbyki`) or its full URL; it takes priority over `category`. **Why does `category` (a top-level section) also work even though those pages show sub-category tiles, not products?** Several top-level sections (e.g. "Компьютеры и ноутбуки") are landing/hub pages with no product cards of their own — the actor detects this automatically and crawls all of that section's sub-categories for you, so you still get products without needing to know the exact sub-category slug up front. Use `categoryUrl` instead when you want only one specific sub-category. # Actor input Schema ## `mode` (type: `string`): What to fetch. ## `searchQuery` (type: `string`): Free-text search query (mode=search), e.g. product name, brand, or model. ## `category` (type: `string`): Top-level catalog category to browse. Leave as "(none)" and use "Category URL / slug" below for a specific sub-category instead. ## `categoryUrl` (type: `string`): Exact sub-category path, slug, or full URL for deeper browsing, e.g. `kompyutery_i_noytbyki/noytbyki` or `https://www.xcom-shop.ru/catalog/kompyutery_i_noytbyki/noytbyki/`. Overrides "Category" above if set. ## `productUrls` (type: `array`): Full XCOM-SHOP product page URLs to fetch details for, e.g. `https://www.xcom-shop.ru/huawei_mitchellg-w5611d_1106075.html`. ## `sortBy` (type: `string`): Sort order for category listings. Ignored in other modes. ## `minPrice` (type: `integer`): Drop products cheaper than this price, in Russian rubles. ## `maxPrice` (type: `integer`): Drop products more expensive than this price, in Russian rubles. ## `brand` (type: `string`): Only keep products whose brand matches this text (case-insensitive), e.g. `Huawei`. ## `inStockOnly` (type: `boolean`): Only emit products currently marked as available/in stock. ## `maxItems` (type: `integer`): Hard cap on emitted records. ## `proxyConfiguration` (type: `object`): Not required for this site but kept available in case of future rate limiting. Defaults to Apify's free datacenter (AUTO) proxy group. ## Actor input object example ```json { "mode": "search", "searchQuery": "ноутбук", "category": "kompyutery_i_noytbyki", "productUrls": [], "sortBy": "popularity", "inStockOnly": false, "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `products` (type: `string`): Dataset containing all scraped XCOM-SHOP products. # 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 = { "mode": "search", "searchQuery": "ноутбук", "category": "kompyutery_i_noytbyki", "productUrls": [], "sortBy": "popularity", "inStockOnly": false, "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/xcom-shop-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 = { "mode": "search", "searchQuery": "ноутбук", "category": "kompyutery_i_noytbyki", "productUrls": [], "sortBy": "popularity", "inStockOnly": False, "maxItems": 20, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/xcom-shop-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 '{ "mode": "search", "searchQuery": "ноутбук", "category": "kompyutery_i_noytbyki", "productUrls": [], "sortBy": "popularity", "inStockOnly": false, "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true } }' | apify call crawlerbros/xcom-shop-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/xcom-shop-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "X-Com Shop Scraper", "description": "Scrape XCOM-SHOP (xcom-shop.ru) - a major Russian electronics and computer retailer. Search products, browse categories, and fetch full product details including price, availability, images, ratings, and reviews.", "version": "1.0", "x-build-id": "JfXg9Tx26t1wSTPpo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~xcom-shop-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-xcom-shop-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/crawlerbros~xcom-shop-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-xcom-shop-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/crawlerbros~xcom-shop-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-xcom-shop-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byCategory", "productDetails" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Free-text search query (mode=search), e.g. product name, brand, or model.", "default": "ноутбук" }, "category": { "title": "Category (mode=byCategory)", "enum": [ "", "kompyutery_i_noytbyki", "komplektyyuschie_dlya_pk_i_noytbykov", "periferiya_i_aksessyary", "ofisnaya_tehnika_i_mebel", "servery_i_shd", "setevoe_oborydovanie", "sistemy_bespereboynogo_pitaniya", "portativnaya_tehnika_i_bytovaya_elektronika", "programmnoe_obespechenie", "sredstva_i_sistemy_bezopasnosti", "elektrika_i_sistemy_elektropitaniya", "stryktyrirovannaya_kabelnaya_sistema_sks", "professionalnoe_aydiovideo_oborydovanie", "klimaticheskie_i_inzhenernye_sistemy", "instryment_izmeritelnoe_oborydovanie_i_tehnika", "ytsenennye_tovary" ], "type": "string", "description": "Top-level catalog category to browse. Leave as \"(none)\" and use \"Category URL / slug\" below for a specific sub-category instead.", "default": "" }, "categoryUrl": { "title": "Category URL / slug (mode=byCategory)", "type": "string", "description": "Exact sub-category path, slug, or full URL for deeper browsing, e.g. `kompyutery_i_noytbyki/noytbyki` or `https://www.xcom-shop.ru/catalog/kompyutery_i_noytbyki/noytbyki/`. Overrides \"Category\" above if set." }, "productUrls": { "title": "Product URLs (mode=productDetails)", "type": "array", "description": "Full XCOM-SHOP product page URLs to fetch details for, e.g. `https://www.xcom-shop.ru/huawei_mitchellg-w5611d_1106075.html`.", "default": [], "items": { "type": "string" } }, "sortBy": { "title": "Sort order (mode=byCategory)", "enum": [ "popularity", "priceAsc", "priceDesc", "name", "availability" ], "type": "string", "description": "Sort order for category listings. Ignored in other modes.", "default": "popularity" }, "minPrice": { "title": "Min price (RUB)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Drop products cheaper than this price, in Russian rubles." }, "maxPrice": { "title": "Max price (RUB)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Drop products more expensive than this price, in Russian rubles." }, "brand": { "title": "Filter by brand", "type": "string", "description": "Only keep products whose brand matches this text (case-insensitive), e.g. `Huawei`." }, "inStockOnly": { "title": "In stock only", "type": "boolean", "description": "Only emit products currently marked as available/in stock.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Hard cap on emitted records.", "default": 20 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not required for this site but kept available in case of future rate limiting. Defaults to Apify's free datacenter (AUTO) proxy group.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```