M.Video Russia Electronics Product & Review Scraper

{
  "description": "Search mvideo.ru, browse a category, or fetch full details for specific products.",
  "properties": {
    "brands": {
      "default": [],
      "description": "Only return products from these brands. Accepts brand names or mvideo.ru slugs (e.g. `Samsung`, `samsung`, `LG`). The matching facet is resolved from the live response, so no hardcoded IDs are needed. Multiple values are OR'd together.",
      "editor": "stringList",
      "prefill": [],
      "title": "Brands (mode=search / byCategory)",
      "type": "array"
    },
    "category": {
      "default": "",
      "description": "Top-level mvideo.ru category to browse. Use `categoryUrl` for any sub-category not listed here.",
      "editor": "select",
      "enum": [
        "",
        "5",
        "19",
        "6327",
        "7",
        "32156",
        "6247",
        "55394",
        "37",
        "50",
        "34821",
        "51",
        "47",
        "41",
        "58",
        "42",
        "21",
        "9",
        "2287",
        "20",
        "4",
        "64",
        "32",
        "56461",
        "55882",
        "31034",
        "27763",
        "11",
        "3787",
        "4107",
        "24",
        "5427",
        "34",
        "31517",
        "32328",
        "23226",
        "3",
        "56077",
        "55",
        "17",
        "54",
        "8",
        "57404",
        "57446",
        "56457",
        "57445",
        "9375",
        "23",
        "4147",
        "25",
        "53",
        "29",
        "57366",
        "2428",
        "56",
        "31713",
        "8027",
        "30420",
        "1461",
        "28153",
        "10",
        "5487",
        "28151",
        "2427",
        "9491",
        "1",
        "31",
        "31018",
        "5927",
        "33737",
        "26087",
        "23497",
        "35",
        "14",
        "25841",
        "8410",
        "4887",
        "36",
        "2",
        "36546",
        "35284",
        "7672",
        "59",
        "12",
        "28",
        "2687",
        "2468",
        "25344",
        "7950",
        "4507"
      ],
      "enumTitles": [
        "(none - required for byCategory)",
        "Hi-Fi техника",
        "PC игры и софт",
        "Автодиагностика и сервис",
        "Автозвук",
        "Автомобильная безопасность",
        "Автомобильная электрика",
        "Аксессуары",
        "Аксессуары для автомобилей",
        "Аксессуары для дома",
        "Аксессуары для домашней техники",
        "Аксессуары для кухонной техники",
        "Аксессуары для планшетов",
        "Аксессуары для телевизоров",
        "Аксессуары для телефонов",
        "Аксессуары для фото и видеотехники",
        "Аудиодиски и кассеты",
        "Аудиотехника и DJ оборудование",
        "Видеокамеры и экшн-камеры",
        "Видеотехника",
        "Встраиваемая техника",
        "Гаджеты",
        "Домашние и офисные телефоны/Радиостанции",
        "Запчасти и аксессуары для садовой техники",
        "Игровые консоли и игры",
        "Игрушки, игры и творчество",
        "Канцелярия",
        "Климатическая техника",
        "Коды для фильмов, музыки и книг",
        "Компьютерная техника",
        "Компьютерные аксессуары",
        "Компьютерные комплектующие",
        "Крупная кухонная техника",
        "Кухонные принадлежности",
        "Мебель",
        "Медицинские товары",
        "Мелкая кухонная техника",
        "Мототовары",
        "Музыкальные инструменты",
        "Навигаторы и автомобильная электроника",
        "Наушники",
        "Ноутбуки, планшеты, компьютеры",
        "Обувь",
        "Одежда детская",
        "Одежда женская",
        "Одежда мужская",
        "Освещение",
        "Периферийные устройства",
        "Планшеты и электронные книги",
        "Портативное аудио",
        "Посуда",
        "Приготовление кофе",
        "Продукты",
        "Пылесосы и аксессуары",
        "Радиоуправляемые устройства",
        "Ручной инструмент и наборы",
        "Садовая техника и оборудование",
        "Сантехника",
        "Сервисы",
        "Силовая техника и строительное оборудование",
        "Смартфоны и связь",
        "Спутниковое/цифровое ТВ",
        "Станки",
        "Стиральные и сушильные машины",
        "Строительные расходные материалы и оснастка",
        "Телевизоры и цифровое ТВ",
        "Товары для авто",
        "Товары для активного отдыха",
        "Товары для бритья и стрижки",
        "Товары для дачи и сада",
        "Товары для дома",
        "Товары для животных",
        "Товары для здоровья",
        "Товары для красоты",
        "Товары для праздников",
        "Товары для спорта",
        "Товары для укладки волос",
        "Товары для ухода за детьми",
        "Товары для ухода за одеждой",
        "Транспортные средства",
        "Тренажёры",
        "Устройства для \"Умного дома\"",
        "Устройства охраны и видеонаблюдения",
        "Фотоаппараты",
        "Хобби",
        "Холодильники и морозильники",
        "Цифровые фоторамки и фотопринтеры",
        "Электрика",
        "Электроинструменты",
        "Электротранспорт"
      ],
      "prefill": "1",
      "title": "Category (mode=byCategory)",
      "type": "string"
    },
    "categoryUrl": {
      "description": "Overrides `category`. Accepts a full mvideo.ru category URL (e.g. https://www.mvideo.ru/televizory-i-cifrovoe-tv-1/televizory-65) or a bare numeric category ID, for sub-categories not in the dropdown.",
      "editor": "textfield",
      "title": "Custom category URL or ID (mode=byCategory)",
      "type": "string"
    },
    "city": {
      "default": "Москва",
      "description": "Russian city name or mvideo city ID (e.g. Москва, Санкт-Петербург, CityCZ_975). City changes stock availability, pickup stores and delivery dates.",
      "editor": "textfield",
      "prefill": "Москва",
      "title": "City",
      "type": "string"
    },
    "condition": {
      "default": "any",
      "description": "Filter by item condition. The matching facet is resolved from the live response; if it is unavailable for a query/category, the run stops with a clear message instead of returning unfiltered results.",
      "editor": "select",
      "enum": [
        "any",
        "new",
        "refurbished",
        "used",
        "markdown",
        "showcase"
      ],
      "enumTitles": [
        "Any condition",
        "New",
        "Refurbished",
        "Used",
        "Markdown / clearance",
        "Showcase / display unit"
      ],
      "prefill": "any",
      "title": "Condition (mode=search / byCategory)",
      "type": "string"
    },
    "failOnEmpty": {
      "default": false,
      "description": "Mark the run as failed when zero records are emitted (for example a blocked connection or an empty query).",
      "prefill": false,
      "title": "Fail when nothing is found",
      "type": "boolean"
    },
    "fromAbroad": {
      "default": false,
      "description": "Only return parallel-import listings. Applies to search mode only; ignored in category mode.",
      "prefill": false,
      "title": "Parallel import only (mode=search)",
      "type": "boolean"
    },
    "includeOtherOffers": {
      "default": true,
      "description": "Fetch the seller/buybox block and attach `otherOffers[]` with prices and seller details when available.",
      "prefill": false,
      "title": "Include other seller offers (mode=productDetails)",
      "type": "boolean"
    },
    "includeStoreStock": {
      "default": false,
      "description": "Fetch per-store pickup availability for the selected city and attach a `stores[]` list.",
      "prefill": false,
      "title": "Include store stock (mode=productDetails)",
      "type": "boolean"
    },
    "maxItems": {
      "default": 100,
      "description": "Hard cap on emitted records (products, or review rows in mode=reviews). Search covers the full result set across all pages, de-duplicated by product ID. Use 0 for all (up to the 10,000 cap).",
      "maximum": 10000,
      "minimum": 0,
      "prefill": 3,
      "title": "Max items",
      "type": "integer"
    },
    "maxPrice": {
      "description": "Drop products more expensive than this (sale price, in Russian rubles). Applied server-side in search/category mode and client-side for detail records.",
      "maximum": 10000000,
      "minimum": 0,
      "title": "Max price (RUB)",
      "type": "integer"
    },
    "maxReviews": {
      "default": 20,
      "description": "Reviews to fetch per product in mode=productDetails (attached as `reviews[]`) and mode=reviews (one row per review). Paginated 20 at a time; 0 skips review fetching.",
      "maximum": 200,
      "minimum": 0,
      "prefill": 0,
      "title": "Max customer reviews per product",
      "type": "integer"
    },
    "minDiscount": {
      "description": "Drop products with a smaller discount than this (0-99 percent). Applied after catalog fetches (the API has no discount facet). Products without a discount are excluded when this filter is set.",
      "editor": "number",
      "maximum": 99,
      "minimum": 0,
      "title": "Min discount (%)",
      "type": "integer"
    },
    "minPrice": {
      "description": "Drop products cheaper than this (sale price, in Russian rubles). Applied server-side in search/category mode and client-side for detail records.",
      "maximum": 10000000,
      "minimum": 0,
      "title": "Min price (RUB)",
      "type": "integer"
    },
    "minRating": {
      "description": "Drop products with a customer rating below this (0-5 stars). Applied after catalog fetches (the API has no rating facet). Products with no rating are excluded when this filter is set.",
      "editor": "number",
      "maximum": 5,
      "minimum": 0,
      "title": "Min rating",
      "type": "number"
    },
    "mode": {
      "default": "search",
      "description": "What to fetch.",
      "editor": "select",
      "enum": [
        "search",
        "byCategory",
        "productDetails",
        "reviews"
      ],
      "enumTitles": [
        "Search products by keyword",
        "Browse a category",
        "Fetch product details by URL/ID",
        "Fetch customer reviews by product URL/ID"
      ],
      "prefill": "search",
      "title": "Mode",
      "type": "string"
    },
    "productUrls": {
      "default": [],
      "description": "mvideo.ru product URLs (e.g. https://www.mvideo.ru/products/televizor-...-401211841) or bare numeric product IDs. Used by productDetails and reviews modes.",
      "editor": "stringList",
      "prefill": [
        "https://www.mvideo.ru/products/televizor-general-electronics-ge55lqs2-401211841"
      ],
      "title": "Product URLs or IDs (mode=productDetails / reviews)",
      "type": "array"
    },
    "proxyConfiguration": {
      "default": {
        "useApifyProxy": true
      },
      "description": "Optional. The actor connects directly first and only escalates to Apify Proxy if mvideo.ru blocks a request. Change this only if you need a specific proxy setup.",
      "editor": "proxy",
      "prefill": {
        "useApifyProxy": true
      },
      "title": "Proxy configuration",
      "type": "object"
    },
    "searchQuery": {
      "default": "телевизор",
      "description": "Free-text product search, e.g. телевизор, ноутбук, холодильник. The full result set is paginated automatically.",
      "editor": "textfield",
      "prefill": "телевизор",
      "title": "Search query (mode=search)",
      "type": "string"
    },
    "sellers": {
      "default": [],
      "description": "Only return products from these marketplace sellers. Accepts seller names or mvideo.ru seller slugs (e.g. `BQ.ru`, `bqru`). The seller facet exists in category browsing only; the search response has no seller facet, so a search run with sellers set stops with a clear message. Multiple values are OR'd together.",
      "editor": "stringList",
      "prefill": [],
      "title": "Sellers (mode=byCategory)",
      "type": "array"
    },
    "sortOrder": {
      "default": "popularity",
      "description": "Result ordering. Only popularity and price ordering are supported by the source; other orderings are not promised.",
      "editor": "select",
      "enum": [
        "popularity",
        "priceAsc",
        "priceDesc"
      ],
      "enumTitles": [
        "Popularity (default)",
        "Price: low to high",
        "Price: high to low"
      ],
      "prefill": "popularity",
      "title": "Sort order (mode=search / byCategory)",
      "type": "string"
    },
    "storeLimit": {
      "default": 20,
      "description": "Cap on `stores[]` entries per product when store stock is included.",
      "maximum": 200,
      "minimum": 1,
      "prefill": 20,
      "title": "Max stores per product",
      "type": "integer"
    }
  },
  "required": [
    "mode"
  ],
  "schemaVersion": 1,
  "title": "M.Video Scraper Input",
  "type": "object"
}

{
  "actorOutputSchemaVersion": 1,
  "description": "mvideo.ru product records with price, stock, rating, specifications, images, seller and store availability, plus standalone review records from reviews mode.",
  "properties": {
    "products": {
      "description": "Dataset containing scraped M.Video products (recordType=product), customer reviews (recordType=review), and invalid-input error rows (recordType=error).",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "M.Video products and reviews",
      "type": "string"
    }
  },
  "title": "M.Video Russia Electronics Product & Review Scraper Output"
}

{
  "actorSpecification": 1,
  "views": {
    "overview": {
      "display": {
        "component": "table",
        "properties": {}
      },
      "title": "Products",
      "transformation": {
        "fields": [
          "recordType",
          "name",
          "brandName",
          "salePrice",
          "currency",
          "ratingStar",
          "inStock",
          "cityName",
          "productUrl"
        ]
      }
    }
  }
}