# Wildberries Price Monitor · Мониторинг цен Wildberries (`theshark/wildberries-price-monitor`) Actor

Live Wildberries prices and stock for your article numbers, and what changed since your last run: up, down, sold out, back in stock. Цены и наличие Wildberries по вашим артикулам и что изменилось с прошлого запуска: подорожало, подешевело, кончилось, вернулось.

- **URL**: https://apify.com/theshark/wildberries-price-monitor.md
- **Developed by:** [TheShark](https://apify.com/theshark) (community)
- **Categories:** E-commerce, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.30 / 1,000 price check · проверка цены

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

## Wildberries Price Monitor · Мониторинг цен Wildberries

Watch **Wildberries prices and stock** for your list of article numbers. Every run returns the price to pay now, availability and
stock as the site shows it, and **what changed since your last run**: `up`, `down`, `out_of_stock`, `back_in_stock`, `same` or
`new` — with the change in rubles and percent, review growth and the rating change. Schedule it daily or hourly; nothing to set up.

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

### What you get

- **A row per article number**: `article`, `name`, `brand`, `price` (to pay, rubles), `price_before_discount`,
  `discount_percent`, `in_stock`, `stock_quantity`, `sizes`, `rating`, `reviews_count`, `url`.
- **Delivery and new**: `delivery_hours` — hours until delivery to your region as the site counts it (the product page shows it as
  the delivery date), and `is_new` — the site's «new» badge.
- **The change**: `change`, `previous_price`, `price_change`, `price_change_percent`, `previous_in_stock`,
  `previous_checked_at`, `previous_reviews_count`, `reviews_change`, `previous_rating`, `rating_change`.
- **History**: `tracked_history` — this monitor's own points from your runs, a point each time the price or stock changed (the
  last 20); and, if you ask for it, `price_history` — the site's own weekly price file.
- **A status in every row**: `ok`, `out_of_stock`, `not_found`, `error`.

### Why this Actor

- **No false alarms.** A failed check or a missing product is not a change: the previous price stays and the next run compares
  with it.
- **Only changes.** Turn on **Only changes** and the dataset gets only products whose price or stock changed, plus new ones and
  errors — easy to send to a sheet or an alert.
- **Your own history.** The monitor keeps the last 20 changes of every product in a store of your account and adds them to the
  row.
- **Review growth.** `reviews_change` shows how many reviews a product got since the last run — a trace of demand.
- **Per region.** Every delivery region keeps its own history.
- **Alerts without code.** A schedule plus Apify integrations (email, Slack, webhook, Zapier, Make) bring you the changes of
  every run.

### How to use

1. Put **article numbers** or **product links** into the input (up to 50,000 per run).
2. Pick the delivery region, and turn on **Only changes** or **Add price history** if you need them.
3. Schedule the Actor (Apify **Schedules**). The first run gives `new` for every product; the next ones show what changed.
4. Keep the same **History store** for one list; give another name to keep a separate history.
5. **Get alerts.** In the **Integrations** tab of the Actor (or of your saved task) add an email, Slack or webhook integration
   for a succeeded run, or connect Zapier or Make. With **Only changes** every run's dataset holds only what changed, so each
   alert leads straight to the changes — no code needed.

### Examples

Input:

```json
{
  "articles": ["12011340", "683146715", "1190104887"],
  "region": "moscow",
  "only_changes": false
}
```

A row (shortened, illustrative numbers):

```json
{
  "status": "ok",
  "article": 683146715,
  "change": "down",
  "price": 1290.0,
  "previous_price": 1390.0,
  "price_change": -100.0,
  "price_change_percent": -7.2,
  "in_stock": true,
  "stock_quantity": 12,
  "reviews_count": 1040,
  "reviews_change": 6,
  "rating": 4.8,
  "rating_change": 0.0,
  "checked_at": "2026-11-08T07:00:00+00:00"
}
```

### Pricing

| Event | Price | What it is |
|---|---|---|
| `price-check` | $0.0033 ($3.30 per 1,000) | a checked product with `ok` or `out_of_stock`, in the dataset or not |
| Actor start | $0.0085 | once per run at the default 1 GB of memory (Apify counts one more start for every GB above) |

`not_found` and `error` rows are free. With **Only changes**, unchanged products are still checked and charged as a check; their
count is in the run summary. A run never charges more than its maximum total charge. The **Pricing** tab always shows the current
prices.

### Good to know

- **Stock is what the site shows to a visitor.** Wildberries shows no more than a top number, and that number moves during the day
  (we saw 43, 49 and 54), so the monitor does not report stock changes as sales.
- **The site's price history is weekly.** `price_history` comes from the site's own file with weekly points, and the site updates
  it rarely, so the current price is always in `price`. The monitor's own `tracked_history` keeps every change from your first run
  (the last 20).
- **The history store** keeps per product only the price, availability, rating, number of reviews, dates and the last 20 changes.
  A product not checked for 90 days is forgotten. One store serves one run at a time.
- A run of a few products takes about 20–50 s on Apify at the default 1 GB of memory, most of it the browser start.
- **No charge for failures.** If the run gets no data, it ends with an error instead of empty rows; nothing is charged for products
  it could not check.
- **Browser cache.** To start faster and spend less traffic, the run keeps the site's own scripts that its browser downloaded in a
  named store in your account, `wildberries-browser-cache-monitor`: no cookies, tokens or passwords. Delete it any time — the next run just starts slower.
- The Actor is not connected with Wildberries; it reads only what the site shows to any visitor.

### What is not in the data

- Only the product's public data: price, stock, rating and reviews count. No seller details and no buyer data.
- The history store holds numbers and dates only: no cookies and no proxies.

### Our other Actors

Wildberries:

- [Wildberries Scraper](https://apify.com/theshark/wildberries-scraper) — products by article, link, search or category: price to pay, stock, sizes, details.
- [Wildberries Reviews Scraper](https://apify.com/theshark/wildberries-reviews-scraper) — reviews and questions of products, only new ones if you like.
- [Wildberries Seller Scraper](https://apify.com/theshark/wildberries-seller-scraper) — seller profiles: items sold, rating, reviews; for companies also name, INN, OGRN.
- [Wildberries Position Tracker](https://apify.com/theshark/wildberries-search-position-tracker) — where your products rank for every keyword, and the top of a keyword.
- [Wildberries Niche Analyzer](https://apify.com/theshark/wildberries-niche-analyzer) — a niche by keyword, category, shop or brand: brands, sellers, shares, prices.
- [Wildberries Keyword Scraper](https://apify.com/theshark/wildberries-keyword-scraper) — search box suggestions and related searches for your seed words.

Other marketplaces:

- [Ozon Scraper](https://apify.com/theshark/ozon-scraper) — Ozon products from search, links and categories, with price history.
- [Ozon Reviews Scraper](https://apify.com/theshark/ozon-reviews-scraper) — Ozon reviews and questions, only new ones if you like.
- [Ozon Seller Scraper](https://apify.com/theshark/ozon-seller-scraper) — Ozon seller profiles: company name, OGRN, rating, orders.
- [Ozon Buy Box Scraper](https://apify.com/theshark/ozon-buybox-scraper) — every seller of an Ozon product with price and delivery.
- [Yandex Market Scraper](https://apify.com/theshark/yandex-market-scraper) — Yandex Market products: price with and without the card, stock, seller.
- [Yandex Market Reviews Scraper](https://apify.com/theshark/yandex-market-reviews-scraper) — Yandex Market reviews: score, text, pros, cons, seller reply.

***

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

**Мониторинг цен Wildberries** по вашему списку артикулов. Каждый запуск даёт цену к оплате сейчас, наличие и остаток, как его
показывает сайт, и **что изменилось с прошлого запуска**: `up`, `down`, `out_of_stock`, `back_in_stock`, `same` или `new` — с
изменением в рублях и процентах, приростом отзывов и сдвигом рейтинга. Поставьте в расписание раз в день или в час; настраивать
ничего не нужно.

#### Что в строке

- **Строка на артикул**: `article`, `name`, `brand`, `price` (к оплате, рубли), `price_before_discount`, `discount_percent`,
  `in_stock`, `stock_quantity`, `sizes`, `rating`, `reviews_count`, `url`.
- **Доставка и новинка**: `delivery_hours` — часов до доставки в ваш регион, как считает сайт (страница товара показывает его датой
  доставки), и `is_new` — метка сайта «новинка».
- **Изменение**: `change`, `previous_price`, `price_change`, `price_change_percent`, `previous_in_stock`,
  `previous_checked_at`, `previous_reviews_count`, `reviews_change`, `previous_rating`, `rating_change`.
- **История**: `tracked_history` — свои точки монитора по вашим запускам, точка каждый раз, когда менялись цена или наличие
  (последние 20); и, если попросить, `price_history` — недельный файл цен самого сайта.
- **Статус в каждой строке**: `ok`, `out_of_stock`, `not_found`, `error`.

#### Почему этот актор

- **Без ложных тревог.** Сбой проверки или пропавший товар — не изменение: прошлая цена остаётся, и следующий запуск сравнит с ней.
- **Только изменения.** С опцией **Только изменения** в датасет попадают только товары, у которых изменились цена или наличие, плюс новые и
  ошибки — удобно отправлять в таблицу или в оповещение.
- **Своя история.** Монитор хранит последние 20 изменений каждого товара в хранилище вашего аккаунта и добавляет их в строку.
- **Прирост отзывов.** `reviews_change` — сколько отзывов товар получил с прошлого запуска: след спроса.
- **По регионам.** У каждого региона доставки своя история.
- **Уведомления без кода.** Расписание и интеграции Apify (почта, Slack, вебхук, Zapier, Make) приносят изменения каждого
  запуска.

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

1. Укажите **артикулы** или **ссылки на товары** (до 50 000 за запуск).
2. Выберите регион доставки, если нужно — включите **Только изменения** или **Добавить историю цен**.
3. Поставьте актор в расписание (**Schedules** в Apify). Первый запуск даст `new` у каждого товара, следующие — что изменилось.
4. Для одного списка держите одно **Хранилище истории**; другое имя — отдельная история.
5. **Уведомления.** На вкладке **Integrations** актора (или вашей сохранённой задачи) добавьте письмо, Slack или вебхук на удачный
   запуск либо подключите Zapier или Make. С **Только изменения** в датасете каждого запуска — только то, что изменилось, поэтому
   каждое уведомление ведёт прямо к изменениям — без кода.

#### Примеры

Пример входа и строки — выше, в английской части: поля одни и те же. Числа в примере строки — для наглядности.

#### Цена

| Событие | Цена | За что |
|---|---|---|
| `price-check` | $0,0033 ($3,30 за 1000) | проверенный товар со статусом `ok` или `out_of_stock`, в датасете он или нет |
| Запуск | $0,0085 | раз на запуск при памяти по умолчанию 1 ГБ (Apify считает ещё один запуск за каждый ГБ сверх) |

Строки `not_found` и `error` бесплатны. С опцией **Только изменения** товары без изменений всё равно проверяются и оплачиваются как проверка;
их число — в итоге запуска. Запуск не спишет больше своего лимита трат. Точные текущие цены — на вкладке **Pricing**.

#### Что важно знать

- **Остаток — тот, что сайт показывает посетителю.** Wildberries показывает не больше некоторого потолка, а потолок меняется в
  течение дня (мы видели 43, 49 и 54), поэтому изменение остатка монитор продажами не называет.
- **История цен сайта — по неделям.** `price_history` — из файла самого сайта, точки по неделям, и сайт обновляет его редко, поэтому
  текущая цена — всегда в `price`. Своя история монитора `tracked_history` хранит каждое изменение с вашего первого запуска
  (последние 20).
- **Хранилище истории** держит у товара только цену, наличие, рейтинг, число отзывов, даты и последние 20 изменений. Товар, который
  90 дней не проверяли, забывается. Одно хранилище — для одного запуска за раз.
- Запуск на несколько товаров на Apify занимает около 20–50 с при памяти по умолчанию 1 ГБ, большая часть — запуск браузера.
- **Сбой не оплачивается.** Если данных получить не удалось, запуск кончается ошибкой, а не пустыми строками; за товары, которые не
  удалось проверить, денег не берут.
- **Кеш браузера.** Чтобы запуск начинался быстрее и тратил меньше трафика, скрипты сайта, которые скачал браузер, лежат в именованном
  хранилище в вашем аккаунте — `wildberries-browser-cache-monitor`: без cookies, токенов и паролей. Его можно удалить в любой момент: следующий запуск просто
  начнётся медленнее.
- Актор не связан с Wildberries и читает только то, что сайт показывает любому посетителю.

#### Чего нет в данных

- Только открытые данные товара: цена, наличие, рейтинг и число отзывов. Ни реквизитов продавца, ни данных покупателей.
- В хранилище истории — только числа и даты: ни cookies, ни прокси.

#### Другие наши акторы

Wildberries:

- [Парсер Wildberries](https://apify.com/theshark/wildberries-scraper) — товары по артикулу, ссылке, поиску или категории: цена к оплате, остаток, размеры, характеристики.
- [Парсер отзывов Wildberries](https://apify.com/theshark/wildberries-reviews-scraper) — отзывы и вопросы о товарах, можно только новые.
- [Парсер продавцов Wildberries](https://apify.com/theshark/wildberries-seller-scraper) — профили продавцов: продано за всё время, рейтинг, отзывы; у компаний — ещё название, ИНН, ОГРН.
- [Позиции товаров Wildberries](https://apify.com/theshark/wildberries-search-position-tracker) — места ваших товаров по каждому запросу и топ запроса.
- [Анализ ниши Wildberries](https://apify.com/theshark/wildberries-niche-analyzer) — ниша по запросу, категории, магазину или бренду: бренды, продавцы, доли, цены.
- [Ключевые слова Wildberries](https://apify.com/theshark/wildberries-keyword-scraper) — подсказки строки поиска и связанные запросы к вашим словам.

Другие площадки:

- [Парсер Ozon](https://apify.com/theshark/ozon-scraper) — товары Ozon из поиска, ссылок и категорий, с историей цен.
- [Парсер отзывов Ozon](https://apify.com/theshark/ozon-reviews-scraper) — отзывы и вопросы о товарах Ozon, можно только новые.
- [Парсер продавцов Ozon](https://apify.com/theshark/ozon-seller-scraper) — профили продавцов Ozon: юрлицо, ОГРН, рейтинг, заказы.
- [Все продавцы товара Ozon](https://apify.com/theshark/ozon-buybox-scraper) — все продавцы товара с ценой и доставкой.
- [Парсер Яндекс Маркета](https://apify.com/theshark/yandex-market-scraper) — товары Яндекс Маркета: цена с картой и без, остаток, продавец.
- [Отзывы Яндекс Маркета](https://apify.com/theshark/yandex-market-reviews-scraper) — отзывы о товарах: оценка, текст, плюсы, минусы, ответ продавца.

# Actor input Schema

## `articles` (type: `array`):

Wildberries article numbers (nmId) to watch. Every number gets its own row with a status, so an empty result never looks like a failure.<br><br>Артикулы Wildberries (nmId) для наблюдения. У каждого — своя строка со статусом, поэтому пустой результат не выглядит как сбой.

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

Links to a product on wildberries.ru. Search, category and seller pages are not collected.<br><br>Ссылки на товар на wildberries.ru. Страницы поиска, категорий и продавцов не собираются.

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

The run checks no more than this number.<br><br>Больше этого числа запуск не проверяет.

## `region` (type: `string`):

Availability, and sometimes the price, depends on the delivery region. Every region has its own history.<br><br>От региона доставки зависит наличие, а иногда и цена. У каждого региона своя история.

## `dest` (type: `integer`):

Optional. The site's dest code for another delivery zone; replaces the region above.<br><br>Необязательно. Код dest сайта для другой зоны доставки; заменяет регион выше.

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

Named key-value store in your account with the prices of earlier runs: per article number only the price, availability, date and the last 20 changes (tracked_history). Change it to keep separate histories.<br><br>Именованное хранилище в вашем аккаунте с ценами прошлых запусков: у артикула только цена, наличие, дата и последние 20 изменений (tracked_history). Смените имя, чтобы вести отдельные истории.

## `with_price_history` (type: `boolean`):

Adds the site's own price history file to every row: up to about 12 weekly points. The site updates this file rarely, so the current price is always in the price field. One more request per article number.<br><br>Добавляет в каждую строку историю цен из файла сайта: примерно до 12 точек по неделям. Сайт обновляет этот файл редко, поэтому текущая цена — всегда в поле price. Ещё один запрос на артикул.

## `only_changes` (type: `boolean`):

Puts into the dataset only the products whose price or stock changed since the last run, plus new ones and errors. Unchanged products are still checked and charged as a check; their count is in the run summary and status.<br><br>Кладёт в датасет только товары, у которых с прошлого запуска изменилась цена или наличие, а ещё новые и ошибки. Остальные всё равно проверяются и оплачиваются как проверка; их число — в итоге и статусе запуска.

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

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

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

Wildberries's own data stays as the site gives it.<br><br>Данные Wildberries остаются такими, как их отдаёт сайт.

## Actor input object example

```json
{
  "articles": [
    "12011340",
    "683146715",
    "1190104887"
  ],
  "urls": [],
  "max_items": 1000,
  "region": "moscow",
  "history_store": "wildberries-price-history",
  "with_price_history": false,
  "only_changes": false,
  "output_language": "en"
}
```

# Actor output Schema

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

One row per article number, with what changed since the last run. Строка на артикул и что изменилось с прошлого запуска.

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

OUTPUT record: rows and their statuses, how many changed, traffic and the reason of a failure. Запись 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 = {
    "articles": [
        "12011340",
        "683146715",
        "1190104887"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("theshark/wildberries-price-monitor").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 = { "articles": [
        "12011340",
        "683146715",
        "1190104887",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("theshark/wildberries-price-monitor").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 '{
  "articles": [
    "12011340",
    "683146715",
    "1190104887"
  ]
}' |
apify call theshark/wildberries-price-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,theshark/wildberries-price-monitor"
        }
    }
}
```

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/5fZ18bPdYlOjA9fYF/builds/mYFb2ZARAQnntpkfI/openapi.json
