Magnit Market (mm.ru) Scraper

Scrape mm.ru — Magnit Market (Магнит Маркет), the marketplace launched in May 2024 by Magnit, Russia's #2 grocery retailer, as the rebrand of KazanExpress. Search products, browse any category, pull full product detail pages (prices, ratings, stock, images, seller info, characteristics, SKU variants), list the category tree, or fetch real customer reviews — all without logging in or paying for a proxy.

What this actor does

• Five modes: search, byCategory, productDetails, categoryTree, reviews
• Search & browse: free-text search or full category listings, sortable by popularity/price/rating, with server-side price/rating/stock/adult filters
• Full product detail: description, characteristics, SKU variants with their own price/stock, seller info, delivery estimate, every photo, and up to 10 similar products
• Category discovery: the full mm.ru category hierarchy (or one branch) with per-category product counts, so you can find category IDs without guessing
• Customer reviews: star rating, review text, pros/cons, purchased variant, reviewer name, like/dislike counts, photos, seller replies, plus a full rating breakdown for the whole product
• Empty fields are omitted from every record — only fields mm.ru actually returned are included

Output per product (mode = search, byCategory)

• productId — mm.ru product ID
• title
• priceRub, oldPriceRub, isPromotion, discountPercent
• rating, reviewsCount, ratingsCount, ordersCount
• quantityAvailable, inStock, isLowStock
• isForAdults
• catalogType, storeCode — mm.ru's internal listing classification and store/warehouse code
• mainImageUrl, imageUrls[] — up to 10 photos
• skuGroupId, skuIds[] — up to 30 variant SKU IDs
• nearestDeliveryDate
• productUrl, sourceUrl
• recordType: "product", scrapedAt

Output per product detail (mode = productDetails)

• productId, title, description, shortDescription
• categoryId, categoryTitle, categoryPath[] — full breadcrumb from root to this product's category
• priceRub, fullPriceRub, discountPercent
• rating, externalRating — mm.ru's own rating plus any imported (e.g. legacy KazanExpress) rating
• ordersCount, reviewsCount, reviewsPhotoCount
• mainImageUrl, imageUrls[] — up to 20 photos
• shopId, shopTitle, shopUrl, shopRating, shopOfficial, shopOrdersCount, shopReviewsCount
• characteristics[] — full spec table (name/value pairs), grouped across SKU variants
• quickSpecs[] — the short bullet-point highlights shown at the top of the product page (name/value pairs)
• skus[] — every SKU variant: skuId, title, priceRub, fullPriceRub, availableAmount, characteristics[]
• nearestDeliveryDate
• similarProducts[] — up to 10 related items (unless includeSimilarProducts: false), each with productId, title, priceRub, fullPriceRub, rating, reviewsCount, ordersCount, imageUrl, deliveryDate, categoryId, isAdultCategory, productUrl
• productUrl, sourceUrl
• recordType: "productDetail", scrapedAt

Output per review (mode = reviews)

• reviewId, productId
• rating
• reviewText — full review text; pros/cons appear only on the (uncommon) reviews where the reviewer filled in those separate fields
• reviewDate
• reviewerName — shows *** if the reviewer posted anonymously (mm.ru's own masking, not this actor's), isAnonymous, isEdited
• likesCount, dislikesCount
• variantCharacteristics[] — the purchased variant (e.g. color/size/model), name/value pairs
• photoUrls[] — review photos
• sellerReply — content, shopName, date, present only if the seller replied
• productRatingBreakdown — 1-5 star histogram for the whole product (not just the returned subset)
• productReviewsTotal, productAvgRating — always reflect mm.ru's full review set for that product, regardless of reviewsLimit
• productUrl
• recordType: "review", scrapedAt

Output per category (mode = categoryTree)

• categoryId, title
• depth — 0 for a top-level category
• parentPath[] — titles of every ancestor category
• productAmount
• isLeaf — true if the category has no subcategories (directly usable as a byCategory seed)
• isAdult, isEco
• categoryUrl, sourceUrl
• recordType: "category"

Input

Field	Type	Default	Description
mode	string	search	search / byCategory / productDetails / categoryTree / reviews
searchQuery	string	–	Free-text query, e.g. iphone, ноутбук (mode=search)
categoryId	string	–	Numeric category ID or category URL. Overrides rootCategory if both are set (mode=byCategory, categoryTree)
rootCategory	string	–	Pick one of 20 built-in top-level categories (mode=byCategory, categoryTree)
productIds	array	–	Product IDs or full product URLs (mode=productDetails, reviews)
includeSimilarProducts	boolean	true	Add a similarProducts array (up to 10 related items) to each record (mode=productDetails)
reviewsLimit	integer	20	Max reviews emitted per product ID, newest first (mode=reviews)
sortBy	string	popularityDesc	Popularity / price / rating / newest / discount, asc or desc (mode=search, byCategory)
cityId	integer	1	Delivery-city ID (affects delivery-date estimates only; mode=search, byCategory, productDetails)
minPrice	integer	–	Minimum price in RUB (mode=search, byCategory)
maxPrice	integer	–	Maximum price in RUB (mode=search, byCategory)
minRating	number	–	Minimum rating, 0-5 (mode=search, byCategory)
inStockOnly	boolean	false	Only emit in-stock products (mode=search, byCategory)
excludeAdultItems	boolean	false	Skip 18+ flagged products (mode=search, byCategory)
leafCategoriesOnly	boolean	false	Only emit categories with no subcategories (mode=categoryTree)
maxItems	integer	10	Hard cap on emitted records (all modes)
proxyConfiguration	object	AUTO group	Apify proxy configuration (all modes)

Notes on filtering: minPrice/maxPrice/minRating/inStockOnly only exclude products that actually carry the relevant field in mm.ru's response — products missing price, rating, or stock-quantity data on the listing pass the filter through unfiltered rather than being dropped, since they can't be classified either way.

Sort note: sortBy is always sent to mm.ru's API as requested. Popularity, price, and rating sorting are confirmed to reorder results server-side (sponsored/promoted listings can still appear out of strict order — mm.ru's own placement, not something this actor re-sorts). Newest and discount sorting are accepted without an error but confirmed to have no effect — mm.ru silently falls back to its default order for those two.

Example: search for a product

{
  "mode": "search",
  "searchQuery": "iphone",
  "sortBy": "priceAsc",
  "inStockOnly": true,
  "maxItems": 20
}

Example: browse a built-in category, filtered by price and rating

{
  "mode": "byCategory",
  "rootCategory": "10004",
  "minPrice": 1000,
  "maxPrice": 50000,
  "minRating": 4,
  "excludeAdultItems": true,
  "maxItems": 50
}

Example: fetch full product details by URL

{
  "mode": "productDetails",
  "productIds": ["https://mm.ru/product/2560933"],
  "includeSimilarProducts": true,
  "maxItems": 10
}

Example: pull reviews for a product

{
  "mode": "reviews",
  "productIds": ["2560933"],
  "reviewsLimit": 50,
  "maxItems": 50
}

Example: discover category IDs

{
  "mode": "categoryTree",
  "leafCategoriesOnly": true,
  "maxItems": 200
}

Use cases

• Price monitoring — track a product line's prices and discounts over time
• Assortment research — pull every product in a category to analyze the catalog
• Competitive intelligence — compare seller ratings, stock levels, and pricing across a niche
• Catalog enrichment — fetch full spec sheets (characteristics, SKUs, images) for a known product list
• Category discovery — list the full category tree with per-category product counts to plan what to scrape next
• Voice of customer / sentiment analysis — pull real review text, star ratings, and pros/cons for a known product list

Other Russian marketplace actors by CrawlerBros

Actor	URL
Citilink Scraper - Russian Electronics Store Products	https://apify.com/crawlerbros/citilink-scraper
DNS-Shop Scraper	https://apify.com/crawlerbros/dns-shop-scraper
Eldorado Scraper	https://apify.com/crawlerbros/eldorado-scraper
ETM Electrical Equipment Scraper	https://apify.com/crawlerbros/etm-scraper
Holodilnik.ru Scraper	https://apify.com/crawlerbros/holodilnik-scraper
Lemanapro Scraper	https://apify.com/crawlerbros/lemanapro-scraper
Magnit Market (mm.ru) Scraper (this actor)	https://apify.com/crawlerbros/magnit-market-scraper
Maxidom Scraper	https://apify.com/crawlerbros/maxidom-scraper
Megamarket.ru Scraper	https://apify.com/crawlerbros/megamarket-scraper
M.Video Scraper	https://apify.com/crawlerbros/mvideo-scraper
Onlinetrade.ru Scraper	https://apify.com/crawlerbros/onlinetrade-scraper
Ozon Scraper - Products, Categories & Search	https://apify.com/crawlerbros/ozon-scraper
Petrovich Building Materials Scraper	https://apify.com/crawlerbros/petrovich-scraper
Regard Scraper	https://apify.com/crawlerbros/regard-scraper
Russkiy Svet (rs24.ru) Electrical Equipment Scraper	https://apify.com/crawlerbros/russkiysvet-scraper
Technopark.ru Scraper - Products, Categories & Search	https://apify.com/crawlerbros/technopark-scraper
VseInstrumenti.ru Scraper	https://apify.com/crawlerbros/vseinstrumenti-scraper
Wildberries Scraper	https://apify.com/crawlerbros/wildberries-scraper
X-Com Shop Scraper	https://apify.com/crawlerbros/xcom-shop-scraper
Yandex Market Pro Scraper	https://apify.com/crawlerbros/yandex-pro-scraper

FAQ

Do I need an mm.ru account or cookies? No. Every mode uses mm.ru's own public web-app APIs with no login required.

Does this cost extra for proxy? No. mm.ru's APIs are reachable directly without a proxy; the actor uses the free Apify AUTO proxy group by default for resilience, at no extra cost.

Where do I find a category ID? Run the actor once with mode=categoryTree to get every category ID, title, and product count in one dataset. Or browse mm.ru, open a category, and copy the number from the URL (https://mm.ru/category/10044 → ID is 10044). Or pick one of the 20 built-in top-level categories via rootCategory.

Are prices in rubles? Yes — priceRub and related fields are converted to whole rubles for you, regardless of the currency unit mm.ru's own API happens to return internally.

Why do some products have no rating or priceRub field? mm.ru simply doesn't return that data for every listing (e.g. brand-new products with no reviews yet). This actor omits fields it can't populate rather than sending misleading zeros or nulls.

Why does productRatingBreakdown not match the number of reviews returned? It always reflects mm.ru's full review set for the product, not just the subset emitted for a given run (capped by reviewsLimit/maxItems).

Is this affiliated with Magnit or mm.ru? No, this is an independent third-party actor that uses mm.ru's public APIs. It is not affiliated with, endorsed by, or sponsored by Magnit or mm.ru.

How fresh is the data? Every run fetches live data directly from mm.ru at the moment the actor runs — nothing is cached or pre-scraped.