# Tsum Product Search Scraper (`stealth_mode/tsum-product-search-scraper`) Actor

Scrape product listings from TSUM.ru with precision. This scraper collects 28+ fields per item including brand details, SKU data, pricing, stock status, and images — designed for price monitoring, inventory tracking, and competitive market analysis.

- **URL**: https://apify.com/stealth\_mode/tsum-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.

- **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

## TSUM.ru Product Scraper: Extract Luxury E-commerce Data Fast

***

### What Is TSUM.ru?

TSUM (Центральный универсальный магазин) is Russia's premier luxury department store with a comprehensive online catalog spanning fashion, accessories, cosmetics, and home goods. The platform features thousands of brands and product variations across multiple categories. Manually extracting this data for price tracking, market research, or competitive analysis is impractical — the **TSUM.ru Product Scraper** automates large-scale product data collection from search results and category pages.

***

### Overview

The **TSUM Product Search Scraper** extracts product listing data from TSUM.ru search and category pages, delivering structured records with 28+ fields per item. It's built for:

- **Price monitoring services** tracking luxury goods pricing trends
- **Retail analysts** benchmarking competitor product assortments
- **Data aggregators** building multi-source luxury product databases
- **Market researchers** studying Russian e-commerce and luxury retail
- **Inventory managers** synchronizing TSUM product data with internal systems

The scraper handles pagination automatically, respects URL failures gracefully, and delivers clean, deduplicated product records with complete metadata.

***

### Input Format

The scraper accepts a JSON configuration object to control scraping behavior:

```json
{
  "urls": [
    "https://www.tsum.ru/catalog/odezhda-18413/?page=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}
```

| Field | Type | Description |
|---|---|---|
| `urls` | Array | Direct links to TSUM product listing pages (category pages, search results, or filtered product lists) |
| `max_items_per_url` | Integer | Maximum number of products to extract per URL (e.g., `200` for full category scraping) |
| `ignore_url_failures` | Boolean | If `true`, scraper continues on failed URLs; if `false`, stops execution on errors |

**Best practices:**

- Use full category or search result URLs with pagination parameters (e.g., `?page=2`)
- Set `max_items_per_url` to `200` for comprehensive category scrapes
- Enable `ignore_url_failures` for bulk runs across multiple URLs

***

### Output Format

**Example output:**

```json
{
  "id": 13822855,
  "tags": [],
  "slug": "7116360-zhaket-iz-viskozy-i-lna-uma-wang-kremovyi",
  "brand_logo_url": "https://st-cdn.tsum.com/sig/587017dd3fe1068e8ad6450ccb866a2e/width/0/i/0a/5c/56/3d/0a5c563d-cb25-40eb-8dd6-7cf15a8d91c3.png",
  "category_id": 18643,
  "category_slug": "zhakety-18643",
  "color_code": "Белый_UW101",
  "image_alt": "Женский жакет из вискозы и льна UMA WANG, арт. S2 W UW6011",
  "image_title": "Женский жакет из вискозы и льна UMA WANG кремового цвета по цене 214500 руб., арт. S2 W UW6011 | Фото {photo}",
  "color_concrete": {
    "id": 661015,
    "title": "Кремовый",
    "slug": "Кремовый"
  },
  "ext_id": "7116360",
  "title": "Жакет из вискозы и льна",
  "model_id": 13887487,
  "photos": [
    {
      "tiny": "https://st-cdn.tsum.com/sig/e6ad9193471d5fcc29ca2611e4c5dbe4/width/237/i/85/df/3d/6d/6317ece9-6e79-4584-8527-1a427737b64a.jpg",
      "small": "https://st-cdn.tsum.com/sig/40cbe02c572b8df4345a557f58d7e535/width/434/i/85/df/3d/6d/6317ece9-6e79-4584-8527-1a427737b64a.jpg",
      "middle": "https://st-cdn.tsum.com/sig/67094ce766ea7ab962832434bf8e510e/width/763/i/85/df/3d/6d/6317ece9-6e79-4584-8527-1a427737b64a.jpg",
      "large": "https://st-cdn.tsum.com/sig/ada85ed2719469ffcef8ae2f7e8d3a91/width/1526/i/85/df/3d/6d/6317ece9-6e79-4584-8527-1a427737b64a.jpg",
      "w100": "https://st-cdn.tsum.com/sig/75e2465d2aa313f9da6fa3f43ca97ee1/width/100/i/85/df/3d/6d/6317ece9-6e79-4584-8527-1a427737b64a.jpg",
      "w100x2": "https://st-cdn.tsum.com/sig/faea837ea80697fbec5dc078ad437fb3/width/200/i/85/df/3d/6d/6317ece9-6e79-4584-8527-1a427737b64a.jpg",
      "w200": "https://st-cdn.tsum.com/sig/faea837ea80697fbec5dc078ad437fb3/width/200/i/85/df/3d/6d/6317ece9-6e79-4584-8527-1a427737b64a.jpg",
      "w200x2": "https://st-cdn.tsum.com/sig/1724dba394d92797fbcd1271fef53d74/width/400/i/85/df/3d/6d/6317ece9-6e79-4584-8527-1a427737b64a.jpg",
      "w320": "https://st-cdn.tsum.com/sig/00d643630e8468b21a0821bc7d9279ab/width/320/i/85/df/3d/6d/6317ece9-6e79-4584-8527-1a427737b64a.jpg",
      "w320x2": "https://st-cdn.tsum.com/sig/922754cfb3f6d9b41e995578bc52ef7c/width/640/i/85/df/3d/6d/6317ece9-6e79-4584-8527-1a427737b64a.jpg",
      "w600": "https://st-cdn.tsum.com/sig/8538c94887832fa21adc9c547a137498/width/600/i/85/df/3d/6d/6317ece9-6e79-4584-8527-1a427737b64a.jpg",
      "w600x2": "https://st-cdn.tsum.com/sig/0f900d368ffb4efc162caf15cde05f57/width/1200/i/85/df/3d/6d/6317ece9-6e79-4584-8527-1a427737b64a.jpg",
      "w1320": "https://st-cdn.tsum.com/sig/78d8b55d7f3b19b50a1db53eaeaed53d/width/1320/i/85/df/3d/6d/6317ece9-6e79-4584-8527-1a427737b64a.jpg",
      "w1320x2": "https://st-cdn.tsum.com/sig/11a1c1c51cc7d75c6c9017d66fe20917/width/2640/i/85/df/3d/6d/6317ece9-6e79-4584-8527-1a427737b64a.jpg"
    },
    {
      "tiny": "https://st-cdn.tsum.com/sig/cf4bad047398947984e8af030dd887d3/width/237/i/85/df/3d/6d/e000624c-36b8-4795-a5b8-d530e43dbc77.jpg",
      "small": "https://st-cdn.tsum.com/sig/d185f4defacadf30c692408dc9e89c9a/width/434/i/85/df/3d/6d/e000624c-36b8-4795-a5b8-d530e43dbc77.jpg",
      "middle": "https://st-cdn.tsum.com/sig/44f531db43e6f93c88530699eb1aba53/width/763/i/85/df/3d/6d/e000624c-36b8-4795-a5b8-d530e43dbc77.jpg",
      "large": "https://st-cdn.tsum.com/sig/e319de080ef1637ae25706b1d001e2b1/width/1526/i/85/df/3d/6d/e000624c-36b8-4795-a5b8-d530e43dbc77.jpg",
      "w100": "https://st-cdn.tsum.com/sig/ad56f621dbcd96d6aedda8f32d7e5805/width/100/i/85/df/3d/6d/e000624c-36b8-4795-a5b8-d530e43dbc77.jpg",
      "w100x2": "https://st-cdn.tsum.com/sig/bfb8fa488596d69a4fbca00b98dd604c/width/200/i/85/df/3d/6d/e000624c-36b8-4795-a5b8-d530e43dbc77.jpg",
      "w200": "https://st-cdn.tsum.com/sig/bfb8fa488596d69a4fbca00b98dd604c/width/200/i/85/df/3d/6d/e000624c-36b8-4795-a5b8-d530e43dbc77.jpg",
      "w200x2": "https://st-cdn.tsum.com/sig/315d27c422ae1826c808950617041b3e/width/400/i/85/df/3d/6d/e000624c-36b8-4795-a5b8-d530e43dbc77.jpg",
      "w320": "https://st-cdn.tsum.com/sig/41b7c27e8c2aaff3b193b946af91b585/width/320/i/85/df/3d/6d/e000624c-36b8-4795-a5b8-d530e43dbc77.jpg",
      "w320x2": "https://st-cdn.tsum.com/sig/257ef54702c2a38f807e0bd67b0e8cff/width/640/i/85/df/3d/6d/e000624c-36b8-4795-a5b8-d530e43dbc77.jpg",
      "w600": "https://st-cdn.tsum.com/sig/8363a97a8fab89f84082477770c57d1e/width/600/i/85/df/3d/6d/e000624c-36b8-4795-a5b8-d530e43dbc77.jpg",
      "w600x2": "https://st-cdn.tsum.com/sig/3499fc242afe4be67ecec823cc72c3ed/width/1200/i/85/df/3d/6d/e000624c-36b8-4795-a5b8-d530e43dbc77.jpg",
      "w1320": "https://st-cdn.tsum.com/sig/f99560bebd3b21b245db4c7fcb7471e0/width/1320/i/85/df/3d/6d/e000624c-36b8-4795-a5b8-d530e43dbc77.jpg",
      "w1320x2": "https://st-cdn.tsum.com/sig/33c2b93a53a35ee25d9de89c1b0a36ad/width/2640/i/85/df/3d/6d/e000624c-36b8-4795-a5b8-d530e43dbc77.jpg"
    },
    {
      "tiny": "https://st-cdn.tsum.com/sig/29e69277276aeb5e9f69c33410994c56/width/237/i/85/df/3d/6d/895160c5-a2ae-4778-9ddf-6d8df2b0f0e1.jpg",
      "small": "https://st-cdn.tsum.com/sig/14fafb820ae5c6dcc390a229429cf8c2/width/434/i/85/df/3d/6d/895160c5-a2ae-4778-9ddf-6d8df2b0f0e1.jpg",
      "middle": "https://st-cdn.tsum.com/sig/b4b1a51f11ba86c2b563fb880422c9cd/width/763/i/85/df/3d/6d/895160c5-a2ae-4778-9ddf-6d8df2b0f0e1.jpg",
      "large": "https://st-cdn.tsum.com/sig/620ddec99f1fd7adea685a5e8a2a6f7c/width/1526/i/85/df/3d/6d/895160c5-a2ae-4778-9ddf-6d8df2b0f0e1.jpg",
      "w100": "https://st-cdn.tsum.com/sig/7d7911341d0bf8c855dd15c5bf0c17d8/width/100/i/85/df/3d/6d/895160c5-a2ae-4778-9ddf-6d8df2b0f0e1.jpg",
      "w100x2": "https://st-cdn.tsum.com/sig/f2a146a2c900d9207a606809da46e86f/width/200/i/85/df/3d/6d/895160c5-a2ae-4778-9ddf-6d8df2b0f0e1.jpg",
      "w200": "https://st-cdn.tsum.com/sig/f2a146a2c900d9207a606809da46e86f/width/200/i/85/df/3d/6d/895160c5-a2ae-4778-9ddf-6d8df2b0f0e1.jpg",
      "w200x2": "https://st-cdn.tsum.com/sig/27c131787191f54e9fe940f0f15b3dba/width/400/i/85/df/3d/6d/895160c5-a2ae-4778-9ddf-6d8df2b0f0e1.jpg",
      "w320": "https://st-cdn.tsum.com/sig/81d47506e5f186ecbf8a6834284eff3c/width/320/i/85/df/3d/6d/895160c5-a2ae-4778-9ddf-6d8df2b0f0e1.jpg",
      "w320x2": "https://st-cdn.tsum.com/sig/a285169cc5ec1dd2a2663ff0550a5467/width/640/i/85/df/3d/6d/895160c5-a2ae-4778-9ddf-6d8df2b0f0e1.jpg",
      "w600": "https://st-cdn.tsum.com/sig/d5e68e5ce6d59a141542de22cc9e9385/width/600/i/85/df/3d/6d/895160c5-a2ae-4778-9ddf-6d8df2b0f0e1.jpg",
      "w600x2": "https://st-cdn.tsum.com/sig/4783f963603cd1ebcc51b7621f40b3bc/width/1200/i/85/df/3d/6d/895160c5-a2ae-4778-9ddf-6d8df2b0f0e1.jpg",
      "w1320": "https://st-cdn.tsum.com/sig/4ab8e9935af5b5d712b8a2f46cfb6630/width/1320/i/85/df/3d/6d/895160c5-a2ae-4778-9ddf-6d8df2b0f0e1.jpg",
      "w1320x2": "https://st-cdn.tsum.com/sig/685df9282c3bfc70bc001225fc1a5ce3/width/2640/i/85/df/3d/6d/895160c5-a2ae-4778-9ddf-6d8df2b0f0e1.jpg"
    },
    {
      "tiny": "https://st-cdn.tsum.com/sig/5771623bc12bb4b0af22386a8be1cece/width/237/i/85/df/3d/6d/89a84503-d976-4ce4-bddf-2124701e4600.jpg",
      "small": "https://st-cdn.tsum.com/sig/802621a728cf1238c7dbff152e322497/width/434/i/85/df/3d/6d/89a84503-d976-4ce4-bddf-2124701e4600.jpg",
      "middle": "https://st-cdn.tsum.com/sig/a94abbdee8a2755d9e00d6c20babb49d/width/763/i/85/df/3d/6d/89a84503-d976-4ce4-bddf-2124701e4600.jpg",
      "large": "https://st-cdn.tsum.com/sig/d254898cd4c391e3cd60fbecb1746f2e/width/1526/i/85/df/3d/6d/89a84503-d976-4ce4-bddf-2124701e4600.jpg",
      "w100": "https://st-cdn.tsum.com/sig/70087df63dce4efbc45c3b30899c9c20/width/100/i/85/df/3d/6d/89a84503-d976-4ce4-bddf-2124701e4600.jpg",
      "w100x2": "https://st-cdn.tsum.com/sig/9f9bacce78768396dcc8a81d96059495/width/200/i/85/df/3d/6d/89a84503-d976-4ce4-bddf-2124701e4600.jpg",
      "w200": "https://st-cdn.tsum.com/sig/9f9bacce78768396dcc8a81d96059495/width/200/i/85/df/3d/6d/89a84503-d976-4ce4-bddf-2124701e4600.jpg",
      "w200x2": "https://st-cdn.tsum.com/sig/a5d6f341c371cb002ca823780e7d7476/width/400/i/85/df/3d/6d/89a84503-d976-4ce4-bddf-2124701e4600.jpg",
      "w320": "https://st-cdn.tsum.com/sig/bbebda3f064af196ca116ef07a59de1b/width/320/i/85/df/3d/6d/89a84503-d976-4ce4-bddf-2124701e4600.jpg",
      "w320x2": "https://st-cdn.tsum.com/sig/98585d1b0d31b4074ecf1a2707b10075/width/640/i/85/df/3d/6d/89a84503-d976-4ce4-bddf-2124701e4600.jpg",
      "w600": "https://st-cdn.tsum.com/sig/1a0edb9e51076cce08699ff97e583721/width/600/i/85/df/3d/6d/89a84503-d976-4ce4-bddf-2124701e4600.jpg",
      "w600x2": "https://st-cdn.tsum.com/sig/30ebee97374ad1f9e6233c162e6ad545/width/1200/i/85/df/3d/6d/89a84503-d976-4ce4-bddf-2124701e4600.jpg",
      "w1320": "https://st-cdn.tsum.com/sig/bf1b301f9a8ab504cceeba832a339feb/width/1320/i/85/df/3d/6d/89a84503-d976-4ce4-bddf-2124701e4600.jpg",
      "w1320x2": "https://st-cdn.tsum.com/sig/b0309bb7ae1b4d0d88a528426582dcc6/width/2640/i/85/df/3d/6d/89a84503-d976-4ce4-bddf-2124701e4600.jpg"
    },
    {
      "tiny": "https://st-cdn.tsum.com/sig/a3ca904ee22ad0ba0290b46c212d397e/width/237/i/85/df/3d/6d/29d9c027-8059-4b30-9a19-206d043ed007.jpg",
      "small": "https://st-cdn.tsum.com/sig/84799a40567aa0717b7a5260c7a91369/width/434/i/85/df/3d/6d/29d9c027-8059-4b30-9a19-206d043ed007.jpg",
      "middle": "https://st-cdn.tsum.com/sig/651a98dcaa6d1bb6371b0f5e42634b0c/width/763/i/85/df/3d/6d/29d9c027-8059-4b30-9a19-206d043ed007.jpg",
      "large": "https://st-cdn.tsum.com/sig/a3a0b2dac19bd39ea5fb9b80e3ffb728/width/1526/i/85/df/3d/6d/29d9c027-8059-4b30-9a19-206d043ed007.jpg",
      "w100": "https://st-cdn.tsum.com/sig/def0c6b81dbb378790cbd8e8b11a163b/width/100/i/85/df/3d/6d/29d9c027-8059-4b30-9a19-206d043ed007.jpg",
      "w100x2": "https://st-cdn.tsum.com/sig/603e20e2150f370fc24baa50480d721d/width/200/i/85/df/3d/6d/29d9c027-8059-4b30-9a19-206d043ed007.jpg",
      "w200": "https://st-cdn.tsum.com/sig/603e20e2150f370fc24baa50480d721d/width/200/i/85/df/3d/6d/29d9c027-8059-4b30-9a19-206d043ed007.jpg",
      "w200x2": "https://st-cdn.tsum.com/sig/fc6b334f778b1a6d87d0362f9bd2a6da/width/400/i/85/df/3d/6d/29d9c027-8059-4b30-9a19-206d043ed007.jpg",
      "w320": "https://st-cdn.tsum.com/sig/088e57a8f765db17719df9fc8044ea96/width/320/i/85/df/3d/6d/29d9c027-8059-4b30-9a19-206d043ed007.jpg",
      "w320x2": "https://st-cdn.tsum.com/sig/908a3f721d104c3a69ec8cf38f337ee7/width/640/i/85/df/3d/6d/29d9c027-8059-4b30-9a19-206d043ed007.jpg",
      "w600": "https://st-cdn.tsum.com/sig/d7b53d2232ac47ed96fd92560b8cf097/width/600/i/85/df/3d/6d/29d9c027-8059-4b30-9a19-206d043ed007.jpg",
      "w600x2": "https://st-cdn.tsum.com/sig/05321e275c3539e210b4ab1045b666b1/width/1200/i/85/df/3d/6d/29d9c027-8059-4b30-9a19-206d043ed007.jpg",
      "w1320": "https://st-cdn.tsum.com/sig/6d8ca2679e6931cdbbb1a9e99fe3d9bc/width/1320/i/85/df/3d/6d/29d9c027-8059-4b30-9a19-206d043ed007.jpg",
      "w1320x2": "https://st-cdn.tsum.com/sig/13e7d43815c534107bf769d1ef74c135/width/2640/i/85/df/3d/6d/29d9c027-8059-4b30-9a19-206d043ed007.jpg"
    }
  ],
  "is_mercury": false,
  "sku_list": [
    {
      "is_last": false,
      "availability_in_stock": true,
      "item_id": 13822855,
      "size": {
        "id": 164450,
        "russian_label": "RU",
        "russian_size": "44",
        "vendor_label": "INT",
        "vendor_size": "S"
      },
      "id": 14955329,
      "ext_id": "56488205",
      "quantity": 2,
      "is_buyable": true,
      "price_discount": 214500,
      "price_original": 214500,
      "size_attributes": {
        "id": 164450,
        "russian_label": "RU",
        "russian_size": "44",
        "vendor_label": "INT",
        "vendor_size": "S"
      },
      "international_price": {
        "base": {
          "currency": "RUB",
          "discounted": 214500,
          "original": 214500
        },
        "displayed": {
          "currency": "RUB",
          "discounted": 214500,
          "original": 214500
        }
      }
    },
    {
      "is_last": false,
      "availability_in_stock": true,
      "item_id": 13822855,
      "size": {
        "id": 712157,
        "russian_label": "RU",
        "russian_size": "46",
        "vendor_label": "INT",
        "vendor_size": "M"
      },
      "id": 14955330,
      "ext_id": "56488204",
      "quantity": 2,
      "is_buyable": true,
      "price_discount": 214500,
      "price_original": 214500,
      "size_attributes": {
        "id": 712157,
        "russian_label": "RU",
        "russian_size": "46",
        "vendor_label": "INT",
        "vendor_size": "M"
      },
      "international_price": {
        "base": {
          "currency": "RUB",
          "discounted": 214500,
          "original": 214500
        },
        "displayed": {
          "currency": "RUB",
          "discounted": 214500,
          "original": 214500
        }
      }
    },
    {
      "is_last": true,
      "availability_in_stock": true,
      "item_id": 13822855,
      "size": {
        "id": 712156,
        "russian_label": "RU",
        "russian_size": "48",
        "vendor_label": "INT",
        "vendor_size": "L"
      },
      "id": 14955150,
      "ext_id": "56488203",
      "quantity": 1,
      "is_buyable": true,
      "price_discount": 214500,
      "price_original": 214500,
      "size_attributes": {
        "id": 712156,
        "russian_label": "RU",
        "russian_size": "48",
        "vendor_label": "INT",
        "vendor_size": "L"
      },
      "international_price": {
        "base": {
          "currency": "RUB",
          "discounted": 214500,
          "original": 214500
        },
        "displayed": {
          "currency": "RUB",
          "discounted": 214500,
          "original": 214500
        }
      }
    }
  ],
  "brand_id": 3388944,
  "brand_name": "Uma Wang",
  "brand_ios_logo_url": "https://st-cdn.tsum.com/sig/587017dd3fe1068e8ad6450ccb866a2e/width/0/i/0a/5c/56/3d/0a5c563d-cb25-40eb-8dd6-7cf15a8d91c3.png",
  "brand_list_logo_url": "https://st-cdn.tsum.com/sig/587017dd3fe1068e8ad6450ccb866a2e/width/0/i/0a/5c/56/3d/0a5c563d-cb25-40eb-8dd6-7cf15a8d91c3.png",
  "sku_ids_as_array": [
    14955329,
    14955330,
    14955150
  ],
  "in_stock": true,
  "is_prepay": false,
  "is_special_offer": false,
  "is_preorder": false,
  "is_sizeable": true,
  "category_type": "clothes",
  "season": "SS 2026",
  "from_url": "https://www.tsum.ru/catalog/odezhda-18413/"
}
```

Each product record contains 28 comprehensive fields:

#### Product Identification

| Field | Meaning |
|---|---|
| `ID` | Unique TSUM product identifier |
| `Title` | Full product name as displayed |
| `Slug` | URL-friendly product identifier |
| `External ID` | Third-party or manufacturer product ID |
| `Model ID` | Product model or variant identifier |

#### Categorization & Tags

| Field | Meaning |
|---|---|
| `Tags` | Metadata tags (e.g., "new arrival", "sale", "limited edition") |
| `Category ID` | Numeric category identifier |
| `Category Slug` | URL-friendly category name |
| `Category Type` | Product type classification within the category |
| `Season` | Season indicator (e.g., "Spring/Summer", "Autumn/Winter") |

#### Brand Information

| Field | Meaning |
|---|---|
| `Brand ID` | Unique brand identifier in TSUM system |
| `Brand Name` | Official brand or designer name |
| `Brand Logo URL` | Direct link to brand logo image |
| `Brand iOS Logo URL` | Optimized logo for iOS app display |
| `Brand List Logo URL` | Logo variant for product list views |

#### Product Details & Variants

| Field | Meaning |
|---|---|
| `Color Code` | Internal color code (e.g., "10", "20") |
| `Color Concrete` | Human-readable color name (e.g., "Black", "Navy Blue") |
| `Is Sizeable` | Boolean flag: product has size variations (clothing, shoes) |
| `SKU List` | Array of all SKU variants for this product |
| `SKU IDs As Array` | SKU identifiers as structured array for database import |

#### Pricing & Availability

| Field | Meaning |
|---|---|
| `In Stock` | Current inventory status: `true` (in stock) or `false` (out of stock) |
| `Is Prepay` | Requires prepayment to purchase |
| `Is Preorder` | Available for preorder only |
| `Is Special Offer` | Included in promotional pricing or bundled deal |

#### Visuals & Metadata

| Field | Meaning |
|---|---|
| `Photos` | Array of product image URLs (multiple angles/colors) |
| `Image Alt` | Alternative text for accessibility |
| `Image Title` | Title attribute for images |

#### Special Flags

| Field | Meaning |
|---|---|
| `Is Mercury` | Internal TSUM flag (special product handling or system) |

***

### How to Use

1. **Identify target URLs** — Browse TSUM.ru and find product listing pages. Copy category URLs or search result links (pagination URLs work best).
2. **Set configuration** — Paste URLs into the `urls` array. Adjust `max_items_per_url` based on expected products per page.
3. **Enable failure tolerance** — Set `ignore_url_failures: true` for multi-URL runs to prevent interruptions.
4. **Execute the scraper** — Start the job and monitor progress in the logs.
5. **Export data** — Download results as JSON, CSV, or Excel for analysis or database import.

**Troubleshooting:**

- **No results returned:** Verify the URL is a product listing (category or search), not a single product page
- **Incomplete SKU data:** Some products may have limited variant information; this reflects TSUM's data availability
- **Image links expire:** Store photos locally or use CDN caching for long-term preservation

***

### Use Cases & Business Value

- **Price monitoring:** Track luxury brand pricing across TSUM's catalog weekly or monthly
- **Competitive intelligence:** Analyze product assortments, new arrivals, and seasonal collections
- **Data integration:** Feed TSUM product feeds into price comparison platforms or aggregators
- **Inventory sync:** Maintain accurate stock status for third-party retail partners
- **Fashion research:** Study luxury market trends, color palettes, and seasonal patterns

The TSUM Product Scraper eliminates manual data entry, enabling real-time insights into Russia's luxury e-commerce landscape at scale.

***

### Conclusion

The **TSUM.ru Product Search Scraper** is an essential tool for price monitoring, retail analytics, and data aggregation in the luxury segment. With 28+ fields per product and configurable pagination, it transforms TSUM's dynamic product catalog into clean, structured data ready for analysis, comparison, or system integration. Launch your first run today and unlock competitive intelligence on Russian luxury retail.

# 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://www.tsum.ru/catalog/odezhda-18413/?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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.tsum.ru/catalog/odezhda-18413/?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/tsum-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://www.tsum.ru/catalog/odezhda-18413/?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/tsum-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://www.tsum.ru/catalog/odezhda-18413/?page=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}' |
apify call stealth_mode/tsum-product-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=stealth_mode/tsum-product-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/gPNSbyZaGOJJbOtWz/builds/OaOCtPpQTAzIeQGys/openapi.json