# Yandex Market Reviews Scraper · Отзывы Яндекс Маркета (`theshark/yandex-market-reviews-scraper`) Actor

Yandex Market product reviews: score, date, text, pros, cons, author, photos, seller reply, plus a free product summary. Отзывы о товарах Яндекс Маркета: оценка, дата, текст, плюсы, минусы, автор, фото, ответ продавца и бесплатная сводка по товару.

- **URL**: https://apify.com/theshark/yandex-market-reviews-scraper.md
- **Developed by:** [TheShark](https://apify.com/theshark) (community)
- **Categories:** E-commerce, Automation
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 92.3% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.64 / 1,000 reviews

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Yandex Market Reviews Scraper · Отзывы Яндекс Маркета

Scrape **product reviews from Yandex Market** (market.yandex.ru): paste product links, or enter search queries and
categories — and get a row per review: score, date, text, pros and cons, author, photos and videos, helpful votes and
the number of replies, and on request **the seller's reply**. Every product also gets a **free summary row**: its rating,
ratings by stars, how many ratings and reviews it has. No Yandex account needed, proxies included.

*Описание на русском — ниже, в разделе «По-русски».*

### Why this Actor

- **Free product summary** — rating, ratings by stars (1–5), total ratings and reviews for every product, at no charge.
- **Seller replies** — the seller's answer under a review, with its date (**Seller replies**), free.
- **Any review order** — Yandex Market's own (most helpful first), newest, highest or lowest score first.
- **Only new reviews** — with **Newest first** a scheduled run reads only up to the first review it has already
  delivered: usually one page per product, and you pay only for new reviews.
- **Reviews of a whole search** — queries and categories give the reviews of the products found, with sort, price and
  rating filters.
- **No duplicates** — variants of one model (colors, sizes) share reviews on Yandex Market; a review comes once per run.

### What you can use it for

- **Customer feedback analysis** — pros, cons and low-score reviews of your products.
- **Competitor research** — what buyers praise and complain about in rival products.
- **Seller service** — how sellers answer reviews and how fast.
- **Review monitoring** — new reviews of your products every day.

### How to use

1. Paste **Product links** (market.yandex.ru/card/…) — or enter **Search queries** or **Categories by id** and set
   **Maximum products per run**.
2. Set **Reviews per product** and **Review order**.
3. Turn on **Seller replies** if you need them.
4. Run it — a free summary row per product, then a row per review. For a scheduled run choose **Newest first** and turn
   on **Only new reviews**.

### Input example

```json
{
  "urls": ["https://market.yandex.ru/card/vertikalnyy-pylesos-dreame-r10s-lite-dlya-sukhoy-i-vlazhnoy-uborki-do-45-minut-20000-pa-gibkaya-trubka-akkumulyator-2200-mach-pyatisloynyy-filtr-syemnyy-konteyner/5345332636"],
  "reviews_count": 50,
  "reviews_sort": "newest",
  "review_replies": true
}
```

### Output example

A product summary and one of its reviews from a real run (trimmed: links and the reply are shortened, the author is
replaced):

```json
[
  {
    "type": "product_reviews",
    "sku": "5345332636",
    "url": "https://market.yandex.ru/card/vertikalnyy-pylesos-dreame-r10s-lite…/5345332636",
    "name": "Вертикальный пылесос Dreame R10S Lite для сухой и влажной уборки до 45 минут, 20000 Па, гибкая трубка, 2200 мАч",
    "source": "https://market.yandex.ru/card/vertikalnyy-pylesos-dreame-r10s-lite…/5345332636",
    "status": "ok",
    "rating": 4.73,
    "ratings_count": 1147,
    "reviews_total": 448,
    "reviews_collected": 10,
    "new_reviews": null,
    "ratings_by_stars": {"1": 40, "2": 14, "3": 27, "4": 50, "5": 1016}
  },
  {
    "type": "review",
    "product_sku": "5345332636",
    "product_url": "https://market.yandex.ru/card/vertikalnyy-pylesos-dreame-r10s-lite…/5345332636",
    "product_name": "Вертикальный пылесос Dreame R10S Lite для сухой и влажной уборки до 45 минут, 20000 Па, гибкая трубка, 2200 мАч",
    "source": "https://market.yandex.ru/card/vertikalnyy-pylesos-dreame-r10s-lite…/5345332636",
    "id": "457135234",
    "rating": 5,
    "date": "2026-08-12",
    "text": "Режим самоочищения, великолепная вещь.",
    "pros": "Красивый и стильный, автоматически определяет уровень загрязнения.",
    "cons": "Посмотрим в процессе эксплуатации.",
    "author": "Анна К.",
    "author_id": "a0b1c2d3e4f5g6h7i8j9k0l1m2",
    "photos": [
      "https://avatars.mds.yandex.net/get-market-ugc/13294633/11F94475-A3AC-42DB-ADAC-B2E6C6AF2D3E.JPG/orig",
      "https://avatars.mds.yandex.net/get-market-ugc/13280904/4ED14F43-D5ED-46C0-9A30-32003AD02686.JPG/orig"
    ],
    "videos": ["https://runtime.strm.yandex.ru/player/video/vplvvar5nyhvv6tki5qo"],
    "useful": 2,
    "unuseful": 0,
    "comments_count": 1,
    "reply": "Здравствуйте! Благодарим за оставленный отзыв. Мы рады, что оценили стиль и функции аппарата… С уважением, Dreame фирменный магазин",
    "reply_date": "2026-08-12"
  }
]
```

### What you get

A summary row per product (`type`: `product_reviews`, free): `sku`, `url`, `name`, `source`, `status`, `rating`,
`ratings_count`, `reviews_total`, `reviews_collected`, `new_reviews` (with **Only new reviews**) and `ratings_by_stars`.

A row per review (`type`: `review`): `product_sku`, `product_url`, `product_name`, `source`, `id`, `rating` (1–5),
`date`, `text`, `pros`, `cons`, `author`, `author_id` (the public profile number), `photos` (full size), `videos`
(links to the Yandex player), `useful`, `unuseful`, `comments_count`, and with **Seller replies** — `reply` and
`reply_date`.

### Pricing

| Event | Price | What it is |
|---|---|---|
| `review` | $0.64 / 1,000 | a review row |
| Actor start | $0.00004 | once per run |

For example, 50 reviews of each of 20 products — 1,000 reviews — cost $0.64 + $0.00004 for the start. Summary rows,
seller replies and products whose reviews did not open are free. The **Pricing** tab always has the up-to-date prices.

### Good to know

- `ratings_count` is bigger than `reviews_total`: many buyers rate a product without writing a review.
- Variants of one model share reviews on Yandex Market, so products of one model may have the same summary numbers.
- The author is shown as on the site («Имя скрыто» when hidden); `author_id` is empty when the site does not show the author's profile.
- Dates are YYYY-MM-DD.

***

### По-русски

Собирает **отзывы о товарах Яндекс Маркета** (market.yandex.ru): вставьте ссылки на товары или задайте поисковые запросы
и разделы — и получите строку на отзыв: оценка, дата, текст, достоинства и недостатки, автор, фото и видео, голоса
«полезно» и число ответов, а по запросу — **ответ продавца**. На каждый товар есть и **бесплатная сводка**: рейтинг,
оценки по звёздам, сколько у него оценок и отзывов. Аккаунт Яндекса не нужен, прокси уже включены.

#### Зачем этот актор

- **Бесплатная сводка по товару** — рейтинг, оценки по звёздам (1–5), всего оценок и отзывов у каждого товара, без
  оплаты.
- **Ответы продавца** — ответ продавца под отзывом, с датой (**Ответы продавца**), бесплатно.
- **Любой порядок отзывов** — порядок самого Маркета (сначала полезные), сначала новые, с высокой или с низкой оценкой.
- **Только новые отзывы** — со **Сначала новые** запуск по расписанию читает только до первого уже отданного отзыва:
  обычно одну страницу на товар, и платите вы только за новые.
- **Отзывы по всему поиску** — запросы и разделы дают отзывы о найденных товарах, с фильтрами порядка, цены и рейтинга.
- **Без повторов** — у вариантов одной модели (цвета, размеры) отзывы на Маркете общие; отзыв приходит один раз за запуск.

#### Для чего подходит

- **Анализ отзывов покупателей** — достоинства, недостатки и отзывы с низкой оценкой о ваших товарах.
- **Исследование конкурентов** — что покупатели хвалят и за что ругают товары конкурентов.
- **Сервис продавцов** — как и как быстро продавцы отвечают на отзывы.
- **Мониторинг отзывов** — новые отзывы о ваших товарах каждый день.

#### Как запустить

1. Вставьте **Ссылки на товары** (market.yandex.ru/card/…) — или задайте **Поисковые запросы** или **Разделы по номеру**
   и **Товаров за запуск, не больше**.
2. Задайте **Отзывов на товар** и **Порядок отзывов**.
3. Включите **Ответы продавца**, если они нужны.
4. Запустите — бесплатная сводка на каждый товар, за ней строка на каждый отзыв. Для запуска по расписанию выберите
   **Сначала новые** и включите **Только новые отзывы**.

#### Пример входа

```json
{
  "urls": ["https://market.yandex.ru/card/vertikalnyy-pylesos-dreame-r10s-lite-dlya-sukhoy-i-vlazhnoy-uborki-do-45-minut-20000-pa-gibkaya-trubka-akkumulyator-2200-mach-pyatisloynyy-filtr-syemnyy-konteyner/5345332636"],
  "reviews_count": 50,
  "reviews_sort": "newest",
  "review_replies": true
}
```

#### Пример результата

Сводка по товару и один из его отзывов из настоящего запуска (сокращено: ссылки и ответ подрезаны, автор заменён):

```json
[
  {
    "type": "product_reviews",
    "sku": "5345332636",
    "url": "https://market.yandex.ru/card/vertikalnyy-pylesos-dreame-r10s-lite…/5345332636",
    "name": "Вертикальный пылесос Dreame R10S Lite для сухой и влажной уборки до 45 минут, 20000 Па, гибкая трубка, 2200 мАч",
    "source": "https://market.yandex.ru/card/vertikalnyy-pylesos-dreame-r10s-lite…/5345332636",
    "status": "ok",
    "rating": 4.73,
    "ratings_count": 1147,
    "reviews_total": 448,
    "reviews_collected": 10,
    "new_reviews": null,
    "ratings_by_stars": {"1": 40, "2": 14, "3": 27, "4": 50, "5": 1016}
  },
  {
    "type": "review",
    "product_sku": "5345332636",
    "product_url": "https://market.yandex.ru/card/vertikalnyy-pylesos-dreame-r10s-lite…/5345332636",
    "product_name": "Вертикальный пылесос Dreame R10S Lite для сухой и влажной уборки до 45 минут, 20000 Па, гибкая трубка, 2200 мАч",
    "source": "https://market.yandex.ru/card/vertikalnyy-pylesos-dreame-r10s-lite…/5345332636",
    "id": "457135234",
    "rating": 5,
    "date": "2026-08-12",
    "text": "Режим самоочищения, великолепная вещь.",
    "pros": "Красивый и стильный, автоматически определяет уровень загрязнения.",
    "cons": "Посмотрим в процессе эксплуатации.",
    "author": "Анна К.",
    "author_id": "a0b1c2d3e4f5g6h7i8j9k0l1m2",
    "photos": [
      "https://avatars.mds.yandex.net/get-market-ugc/13294633/11F94475-A3AC-42DB-ADAC-B2E6C6AF2D3E.JPG/orig",
      "https://avatars.mds.yandex.net/get-market-ugc/13280904/4ED14F43-D5ED-46C0-9A30-32003AD02686.JPG/orig"
    ],
    "videos": ["https://runtime.strm.yandex.ru/player/video/vplvvar5nyhvv6tki5qo"],
    "useful": 2,
    "unuseful": 0,
    "comments_count": 1,
    "reply": "Здравствуйте! Благодарим за оставленный отзыв. Мы рады, что оценили стиль и функции аппарата… С уважением, Dreame фирменный магазин",
    "reply_date": "2026-08-12"
  }
]
```

#### Что вы получите

Строка-сводка на товар (`type`: `product_reviews`, бесплатно): `sku`, `url`, `name`, `source`, `status`, `rating`,
`ratings_count`, `reviews_total`, `reviews_collected`, `new_reviews` (с **Только новые отзывы**) и `ratings_by_stars`.

Строка на отзыв (`type`: `review`): `product_sku`, `product_url`, `product_name`, `source`, `id`, `rating` (1–5), `date`,
`text`, `pros`, `cons`, `author`, `author_id` (публичный номер профиля), `photos` (полный размер), `videos` (ссылки на
плеер Яндекса), `useful`, `unuseful`, `comments_count`, а с **Ответами продавца** — `reply` и `reply_date`.

#### Цены

| Событие | Цена | Что это |
|---|---|---|
| `review` | $0,64 / 1000 | строка отзыва |
| Запуск актора | $0,00004 | один раз за запуск |

Например, по 50 отзывов о 20 товарах — 1000 отзывов — стоят $0,64 + $0,00004 за запуск. Сводки, ответы продавца и товары,
чьи отзывы не открылись, — бесплатно. Актуальные цены — всегда на вкладке **Pricing**.

#### Полезно знать

- `ratings_count` больше, чем `reviews_total`: многие покупатели ставят оценку, не написав отзыва.
- У вариантов одной модели отзывы на Маркете общие, поэтому у товаров одной модели цифры сводки могут совпадать.
- Автор — как на сайте («Имя скрыто», если он скрыт); `author_id` пуст, если сайт не показывает профиль автора.
- Даты — в виде ГГГГ-ММ-ДД.

# Actor input Schema

## `urls` (type: `array`):

Products whose reviews to collect (market.yandex.ru/card/…). Search and category links work too: reviews of the products they list.<br><br>Товары, чьи отзывы собрать (market.yandex.ru/card/…). Подойдут и ссылки на поиск и разделы: отзывы о товарах из них.

## `queries` (type: `array`):

Words to search on Yandex Market, as on the site: «пылесос dreame». Reviews of the products found.<br><br>Что искать на Яндекс Маркете — как на сайте: «пылесос dreame». Собираются отзывы о найденных товарах.

## `hids` (type: `array`):

Yandex Market categories by id (hid), as in the site's links (…?hid=91491 — smartphones): reviews of the products listed there.<br><br>Разделы Яндекс Маркета по номеру (hid), как в ссылках сайта (…?hid=91491 — смартфоны): отзывы о товарах раздела.

## `sort` (type: `string`):

Which products of a search or category come first. Reviews themselves come in Review order.<br><br>Какие товары поиска или раздела идут первыми. Сами отзывы идут в порядке из поля «Порядок отзывов».

## `price_from` (type: `integer`):

Only products from this price. Yandex Market applies the filter loosely.<br><br>Только товары от этой цены. Маркет применяет фильтр нестрого.

## `price_to` (type: `integer`):

Only products up to this price. Yandex Market applies the filter loosely.<br><br>Только товары до этой цены. Маркет применяет фильтр нестрого.

## `rating_from` (type: `number`):

Only products whose search card rates at least this high (0–5, for example 4.5). Applies to searches and categories, not to product links.<br><br>Только товары с рейтингом в карточке выдачи не ниже этого (0–5, например 4.5). Действует на поиск и разделы, не на ссылки на товар.

## `max_items` (type: `integer`):

How many products to take from queries, categories and links, across all of them.<br><br>Сколько товаров взять из запросов, разделов и ссылок — всего, по всем вместе.

## `reviews_count` (type: `integer`):

How many reviews of each product to collect, in Review order. A charge per review row.<br><br>Сколько отзывов о каждом товаре собрать — в порядке из поля «Порядок отзывов». Оплата — за каждую строку отзыва.

## `reviews_sort` (type: `string`):

Empty keeps Yandex Market's own order: most helpful first. Newest first together with Only new reviews reads only up to the first review already delivered — usually one page per product.<br><br>Пусто — порядок самого Маркета: сначала полезные. «Сначала новые» вместе с «Только новые отзывы» читает только до первого уже отданного отзыва — обычно одну страницу на товар.

## `review_replies` (type: `boolean`):

Adds the seller's reply under each review that has one, with its date. One extra small request per review with replies, so the run gets slower. Free.<br><br>Добавляет ответ продавца под каждым отзывом, где он есть, с датой. Ещё один небольшой запрос на отзыв с ответами, поэтому запуск медленнее. Бесплатно.

## `new_only` (type: `boolean`):

Skip reviews this history store has already delivered, and pay only for new ones. With Newest first, reading stops at the first review already delivered.<br><br>Пропускать отзывы, которые это хранилище истории уже отдавало, и платить только за новые. Со «Сначала новые» чтение останавливается на первом уже отданном отзыве.

## `sessions` (type: `integer`):

How many anonymous visitors work at the same time, each with its own IP.<br><br>Сколько анонимных посетителей работают одновременно, у каждого свой IP.

## `proxy` (type: `string`):

Optional. One per line: user:pass@host:port, Russian IPs. Without them the run uses its own Russian proxies.<br><br>Необязательно. По одному в строке: user:pass@host:port, российские IP. Без них запуск идёт через свои российские прокси.

## `history_store` (type: `string`):

Named key-value store that keeps sessions and delivered reviews between runs.<br><br>Именованное key-value хранилище, где между запусками лежат сессии и отданные отзывы.

## `output_language` (type: `string`):

Reviews and other Yandex Market data stay as the site gives them.<br><br>Отзывы и другие данные Яндекс Маркета остаются такими, как отдаёт сайт.

## Actor input object example

```json
{
  "urls": [
    "https://market.yandex.ru/card/chaynik-na-podstavke-steklyannyy-sc-ek27g90-1800vt-17l/102218923777"
  ],
  "queries": [],
  "hids": [],
  "max_items": 100,
  "reviews_count": 10,
  "review_replies": false,
  "new_only": false,
  "sessions": 4,
  "history_store": "yandex-reviews-history",
  "output_language": "en"
}
```

# Actor output Schema

## `results` (type: `string`):

A free summary row per product, then one row per review. Бесплатная сводка по каждому товару, за ней — строка на каждый отзыв.

## `summary` (type: `string`):

OUTPUT record: how many rows were delivered. Запись OUTPUT: сколько строк отдано.

# 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://market.yandex.ru/card/chaynik-na-podstavke-steklyannyy-sc-ek27g90-1800vt-17l/102218923777"
    ],
    "reviews_count": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("theshark/yandex-market-reviews-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://market.yandex.ru/card/chaynik-na-podstavke-steklyannyy-sc-ek27g90-1800vt-17l/102218923777"],
    "reviews_count": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("theshark/yandex-market-reviews-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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://market.yandex.ru/card/chaynik-na-podstavke-steklyannyy-sc-ek27g90-1800vt-17l/102218923777"
  ],
  "reviews_count": 10
}' |
apify call theshark/yandex-market-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,theshark/yandex-market-reviews-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/ud6dguICrDiIrtuy6/builds/FqYsO18ni7xJlOauU/openapi.json
