# Usmall Product Search Scraper (`stealth_mode/usmall-product-search-scraper`) Actor Scrape product listings from USMall.ru including prices, ratings, stock levels, and 35+ attributes per item. Perfect for price monitoring, market research, and e-commerce data aggregation from Russia's growing online marketplace. - **URL**: https://apify.com/stealth\_mode/usmall-product-search-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Automation, Developer tools, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results 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/platform/actors/running/actors-in-store#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. 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 ## USMall Product Search Scraper: Extract Russian E-commerce Data Fast --- ### What Is USMall.ru? USMall.ru is a prominent Russian e-commerce platform offering millions of products across beauty, electronics, fashion, and household categories. It connects consumers with vendors and brands, making it a valuable source for market intelligence, competitive pricing analysis, and product trend research. However, extracting structured data from search result pages manually is inefficient — the **USMall Product Search Scraper** automates this workflow, collecting detailed product information at scale. --- ### Overview The **USMall Product Search Scraper** extracts product listings from USMall.ru category and search pages, converting each item into a structured record with 35+ data fields. This scraper is ideal for: - **E-commerce analysts** tracking market trends and competitor pricing - **Price monitoring services** building datasets for comparison platforms - **Market researchers** studying Russian online retail - **Data engineers** feeding product data into inventory or analytics systems - **Dropshippers and resellers** sourcing product information The scraper handles pagination automatically, respects server resources via configurable item limits, and includes robust error handling to ensure reliable data collection across multiple URLs. --- ### Input Format The scraper accepts a JSON configuration object specifying which product pages to scrape and how many items to collect: ```json { "urls": [ "https://usmall.ru/products/all/beauty/fragrances-and-perfumes-for-women?page=2" ], "ignore_url_failures": true, "max_items_per_url": 200 } ```` | Field | Description | |---|---| | `urls` | Array of USMall product list page URLs (e.g., category pages, search results, filtered collections) | | `max_items_per_url` | Maximum number of products to extract per URL (default: `20`, can be set up to `200`) | | `ignore_url_failures` | Boolean flag; if `true`, the scraper continues even if some URLs fail to load | **Best practices:** - Paste complete category or search result URLs including pagination parameters - Set `max_items_per_url` based on your data needs (higher values = longer run time) - Use `ignore_url_failures: true` for bulk runs to prevent interruption from temporary failures *** ### Output Format **Example output row:** ```json { "id": 113297181, "product_id": 13381628, "market_id": 51, "name": "Mini Cheirosa 91 Rosa Charmosa Body & Hair Perfume Mist", "image_has_bg": false, "brand": { "id": 20031, "name": "Sol de Janeiro", "brand_rating": 4.59948 }, "size_plus": null, "size_kids": null, "image": { "url": "https://usmall.ru/image/1338/16/25/26041f43f763dff84ee7999cf08fd6fe.jpeg", "width": 2000, "height": 2000, "size": 40998, "is_manual": 0 }, "images": [ { "url": "https://usmall.ru/image/1338/16/25/26041f43f763dff84ee7999cf08fd6fe.jpeg", "width": 2000, "height": 2000, "size": 40998, "is_manual": 0 }, { "url": "https://usmall.ru/image/1338/16/25/cd0bc2a058a3128f6cde20a940f1f907.jpeg", "width": 1500, "height": 1500, "size": 568450, "is_manual": 0 }, { "url": "https://usmall.ru/image/1338/16/25/cbe1dbd90fd1f08423f1d66eb737e93c.jpeg", "width": 1500, "height": 1500, "size": 251438, "is_manual": 0 }, { "url": "https://usmall.ru/image/1338/16/25/cd22965622a8c79e39bd70ed23fe1634.jpeg", "width": 1500, "height": 1500, "size": 312798, "is_manual": 0 }, { "url": "https://usmall.ru/image/1338/16/25/e2ab79b926b0c5952f544e1d4f0a7c5b.jpeg", "width": 1500, "height": 1500, "size": 434775, "is_manual": 0 }, { "url": "https://usmall.ru/image/1338/16/25/2d5c65bac3c93734acd71788dbbf6dbc.jpeg", "width": 1500, "height": 1499, "size": 411636, "is_manual": 0 }, { "url": "https://usmall.ru/image/1338/16/25/b74567ddc2f3434204fb5713b8cd4f5f.jpeg", "width": 1500, "height": 1500, "size": 483957, "is_manual": 0 }, { "url": "https://usmall.ru/image/1338/16/25/a19db9698e64e10b772eec3e437467c0.jpeg", "width": 1500, "height": 1499, "size": 494929, "is_manual": 0 }, { "url": "https://usmall.ru/image/1338/16/25/398e3bbd6513a8796ee91bac90be7e0d.jpeg", "width": 1500, "height": 1499, "size": 282905, "is_manual": 0 }, { "url": "https://usmall.ru/image/1338/16/25/6d9bad75be4791cfc01e8d5adeb67e13.jpeg", "width": 1500, "height": 1500, "size": 529788, "is_manual": 0 }, { "url": "https://usmall.ru/image/1338/16/25/c4138d6348e90a6c6b808ccd5b6f2980.jpeg", "width": 1500, "height": 1500, "size": 211521, "is_manual": 0 }, { "url": "https://usmall.ru/image/1338/16/25/403823cd6fe13bbbdd637fd51adb9602.jpeg", "width": 1500, "height": 1500, "size": 345723, "is_manual": 0 } ], "sgr": null, "dosage": null, "flavor": null, "price": 4140, "price_full": null, "promo_offer": { "code": "ДЕЛЬФИН", "price": 3110, "discount": 25, "min_price": 3000, "expiration_date": 1782507540 }, "discount": null, "product_is_lost": 0, "stock_count": 1, "origin_color": "N/A", "origin_name": "Mini Cheirosa 91 Rosa Charmosa Body & Hair Perfume Mist", "color_name": "No Color", "color_name_ru": "Нет цвета", "origin_size": "Mini 3 oz / 90 ml", "sub_size": "R", "item_weight_real_time": "0", "average_rating": 5, "popular_count": null, "delivery_days": null, "weight": null, "product_variant_book": null, "color_id": 23023, "recommend_name": "google", "from_url": "https://usmall.ru/products/all/beauty/fragrances-and-perfumes-for-women?page=2" } ``` Each product extracted returns a comprehensive record with 35+ fields: #### Identification & Product Basics | Field | Meaning | |---|---| | `ID` | Unique system identifier for the product record | | `Product ID` | USMall's internal product identifier | | `Market ID` | Marketplace or vendor identifier | | `Name` | Official product name as listed | | `Brand` | Product brand name | | `Recommend Name` | Alternative recommended product name | #### Visual & Image Data | Field | Meaning | |---|---| | `Image` | Primary product image URL | | `Images` | Array of all product image URLs | | `Image Has Background` | Boolean flag indicating if the primary image has a background | #### Product Specifications | Field | Meaning | |---|---| | `Origin Name` | Original product name (if different from translated name) | | `Origin Size` | Original size designation | | `Sub Size` | Secondary size attribute | | `Size Plus` | Whether product is available in plus sizes | | `Size Kids` | Whether product is available in kids sizes | | `SGR` | Product classification code | | `Dosage` | Dosage/concentration (common for beauty/health products) | | `Flavor` | Flavor variant (if applicable) | | `Origin Color` | Original color name from supplier | | `Color Name` | Standardized color name (English) | | `Color Name RU` | Standardized color name (Russian) | | `Color ID` | Numeric identifier for the color variant | #### Pricing & Availability | Field | Meaning | |---|---| | `Price` | Current selling price in local currency | | `Price Full` | Full original price before any discounts | | `Discount` | Discount percentage or amount applied | | `Promo Offer` | Active promotional offer description | | `Stock Count` | Number of units currently in stock | | `Product Is Lost` | Boolean flag indicating if product is out of stock or discontinued | #### Engagement & Logistics | Field | Meaning | |---|---| | `Average Rating` | Customer review rating (typically 1-5 scale) | | `Popular Count` | Number of purchases or popularity metric | | `Delivery Days` | Estimated delivery timeframe | | `Weight` | Product weight in standard units | | `Item Weight Real Time` | Real-time updated weight information | | `Product Variant Book` | Reference to product variants or SKU grouping | *** ### How to Use 1. **Find product list URLs** — Navigate to USMall.ru and browse to a category or search results page. Copy the full URL (including pagination parameters like `?page=2`). 2. **Add URLs to input** — Paste one or more product list URLs into the `urls` array in the JSON configuration. 3. **Set item limit** — Define `max_items_per_url` based on your needs: - Small datasets: `20–50` - Medium datasets: `50–100` - Large bulk runs: `100–200` 4. **Configure error handling** — Set `ignore_url_failures` to `true` if running multiple URLs; this prevents the entire job from failing if one URL has temporary issues. 5. **Run the scraper** — Execute the actor and monitor the progress in real time. 6. **Export results** — Download the dataset as JSON, CSV, or Excel for analysis, import, or integration. **Troubleshooting:** - If a URL returns no data, verify it points to a product list page (not a single product detail page). - USMall occasionally changes page structure; if scraping fails for many URLs, clear your browser cache and try again. - For large volumes, split URLs across multiple runs to avoid timeouts. *** ### Use Cases & Business Value **Price Intelligence:** Monitor competitor pricing, track promotional trends, and identify price gaps across vendors. **Market Research:** Analyze product availability, rating distribution, and stock levels across categories to spot opportunities. **Inventory Integration:** Feed USMall product data into internal inventory systems, dashboards, or price comparison platforms. **Dropshipping & Reselling:** Quickly gather product details, images, and pricing to list on other platforms or in your own storefront. **Trend Analysis:** Track which products are gaining popularity, which variants are best-sellers, and seasonal demand patterns. The **USMall Product Search Scraper** transforms hours of manual browsing into minutes of automated data collection, enabling data-driven decisions in highly competitive Russian e-commerce markets. *** ### Conclusion The **USMall Product Search Scraper** is a powerful tool for anyone operating in or analyzing the Russian e-commerce space. With 35+ fields per product and reliable bulk processing, it delivers the structured data needed to compete, optimize, and innovate. Start scraping today and unlock insights that drive smarter business decisions. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the product search list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## `max_items_per_url` (type: `integer`): The maximum number of items to scrape per URL. ## Actor input object example ```json { "urls": [ "https://usmall.ru/products/all/beauty/fragrances-and-perfumes-for-women?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 } ``` # 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 = { "urls": [ "https://usmall.ru/products/all/beauty/fragrances-and-perfumes-for-women?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("stealth_mode/usmall-product-search-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 = { "urls": ["https://usmall.ru/products/all/beauty/fragrances-and-perfumes-for-women?page=2"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/usmall-product-search-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 '{ "urls": [ "https://usmall.ru/products/all/beauty/fragrances-and-perfumes-for-women?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/usmall-product-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/usmall-product-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Usmall Product Search Scraper", "description": "Scrape product listings from USMall.ru including prices, ratings, stock levels, and 35+ attributes per item. Perfect for price monitoring, market research, and e-commerce data aggregation from Russia's growing online marketplace.", "version": "0.0", "x-build-id": "W65uJ12HPmWWCvOOn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~usmall-product-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-usmall-product-search-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/stealth_mode~usmall-product-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-usmall-product-search-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/stealth_mode~usmall-product-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-usmall-product-search-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": { "urls": { "title": "URLs of the product search list urls to scrape", "type": "array", "description": "Add the URLs of the product search list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." } } }, "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 } } } } } } } } } } ```