# Taobao & Tmall 淘宝 Price Monitor · Мониторинг цен Taobao (`theshark/taobao-price-monitor`) Actor

Watch Taobao and Tmall prices and stock between runs: price drops and rises in %, your own threshold, sold out, back in stock, new and removed variants. Следите за ценами и остатками Taobao и Tmall: рост и падение цены в %, свой порог, распродано, снова в наличии, новые и пропавшие варианты.

- **URL**: https://apify.com/theshark/taobao-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, 80.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $7.64 / 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

## Taobao & Tmall 淘宝 Price Monitor · Мониторинг цен Taobao

Watch **Taobao and Tmall prices and stock** between runs: for every product the Actor remembers the previous check and tells **what
changed — price down or up in percent, sold out, back in stock, new and removed variants**. Run it on a schedule with your product
links or IDs and get a row only for the products that changed (or a row for every product, if you prefer). Every product also links to
buying agents that ship Taobao orders abroad, and the price can be given in your currency too (USD, EUR, GBP and more).

淘宝、天猫商品价格与库存监控：与上次检查相比的涨价、降价（百分比）、售罄、补货、SKU增减。支持商品链接、商品ID、淘宝分享文案和代购链接。

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

### What you get

- **A row per product** (`type = product`) with the usual product fields: `title`, `price`, `priceMin` and `priceMax` over the
  variants, `totalStock`, `inStockVariants`, `variants` (each with its own price and stock), `shop`, `shipFrom` and `agentLinks`.
- **What changed** since the previous check, in `changes`: `new` (first check), `price_up`, `price_down`, `stock_up`, `stock_down`,
  `sold_out`, `back_in_stock`, `variants_added`, `variants_removed`. The list is empty when nothing changed. With **Minimum price
  change, %**, a smaller price change is not listed.
- **`priceChangePercent`**: the price change in percent, to 0.1 (100 to 90 is `-10.0`), against the price in `previous`. It is
  there even when the change is below **Minimum price change, %** and `changes` is empty.
- **`previous`**: what the check was compared with — `price`, `priceBasis` and `priceCheckedAt` (the price it was compared with, and
  when that price was seen), and `totalStock` and `checkedAt` (the previous check).
- **`comparable`**: `true` when the price, the variants and the rise or fall of the stock were all compared; `false` when something
  was left out (see below).
- **The price in your currency**: `priceConverted`, `priceMinConverted`, `priceMaxConverted` with `fxRate` and `fxDate`.
- **Buying-agent links** in `agentLinks`: CNFans, Hoobuy, KakoBuy, Superbuy, AllChinaBuy and Sugargoo.

### Why this Actor

- **One read per product.** No reviews, no questions, no extras: you pay for the check and nothing else.
- **Price noise is not a change.** The price is compared only with the last price given the same way: `priceBasis` is `page` (the price on the
  product page) or `converted` (recalculated from US dollars, within 1–4 %), and the currency is the same. The last price of each
  basis is kept for 90 days, so 100 (`page`), then 98 (`converted`), then 90 (`page`) is still a drop of 10 %, found against the 100.
  If there is no earlier price of the same basis, the price is not compared and `previous` shows the last check. Variant
  changes are marked only when both checks got the full record of the product (`detailLevel` is `full` in both). A rise or a fall of
  the stock is marked when both records are equally full; sold out and back in stock are always marked. Whatever was left out
  makes `comparable` `false`.
- **Only the price changes you care about.** With **Minimum price change, %** set to, say, 5, a smaller price change (in percent to
  0.1, as in `priceChangePercent`) is not a change. The next check is then compared with the same earlier price, so small steps add up:
  100, then 97, then 94 is a drop of 6 % from 100, and `previous` shows the 100 and when it was seen. Stock and variant changes are
  marked as usual. The kept price is shared by all your runs of this Actor: a run with 0 moves it for the others too, and after you
  lower the threshold the next check is compared with the kept price, not with the previous check.
- **Your currency is not a change.** Changes are found on the yuan price, so switching **Price also in** between runs changes nothing.
- **Clear stock changes.** Stock going to zero is `sold_out` and coming back is `back_in_stock`, not just a number.
- **Only what changed.** With **Only changes** on, rows without changes are not written to the dataset: your table and integrations
  see just the news. The check itself is paid, because the product was read.
- **Every link form**: item.taobao.com, detail.tmall.com, detail.tmall.hk (Tmall Global), m.intl.taobao.com, world.taobao.com links
  with a number, bare IDs, the app's Share text and links from CNFans, Hoobuy, KakoBuy, Superbuy, Sugargoo, CSSBuy and other agents.
  The same product given twice is checked and paid once.
- **No Taobao account, cookies or proxies of your own.**

### How to use

1. Put product links, IDs, Share texts or buying-agent links into **Products**, one per line, up to 1,000 per run.
2. Choose **Only changes**, **Minimum price change, %** (0 for every change) and **Price also in** (USD, EUR, RUB, GBP, PLN, UAH, KZT,
   BRL, CAD or AUD).
3. Run it. The first run marks every product `new`; the next runs compare with it. To watch prices, put the run on a schedule (for
   example once a day) in Apify.
4. Rows appear in the dataset; the `Changes`, `Variants` and `Agent links` views show them as tables. The run summary (`OUTPUT`)
   counts the checked products, and shows the rows by status and why the run stopped (`stopReason`).

### Examples

Input:

```json
{
  "items": ["https://detail.tmall.com/item.htm?id=1077492506594", "582890145005"],
  "only_changes": true,
  "currency": "USD"
}
```

A row of the first check, shortened:

```json
{
  "type": "product",
  "status": "ok",
  "input": "https://detail.tmall.com/item.htm?id=1077492506594",
  "itemId": "1077492506594",
  "platform": "tmall",
  "title": "ELLE法式假两件荡领长袖连衣裙女2026冬新款松弛感气质显瘦长裙子",
  "price": 361.34,
  "priceBasis": "page",
  "priceMin": 361.34,
  "priceMax": 361.34,
  "totalStock": 351,
  "inStockVariants": 4,
  "detailLevel": "basic",
  "previous": null,
  "changes": ["new"],
  "priceChangePercent": null,
  "comparable": null,
  "scrapedAt": "2026-11-14T17:46:17+00:00"
}
```

A row of the check an hour later, shortened — the price went down. The product came as a short record (`detailLevel` is `basic`), so its variants were not compared and `comparable` is `false`:

```json
{
  "type": "product",
  "status": "ok",
  "input": "https://detail.tmall.com/item.htm?id=1077492506594",
  "itemId": "1077492506594",
  "platform": "tmall",
  "title": "ELLE法式假两件荡领长袖连衣裙女2026冬新款松弛感气质显瘦长裙子",
  "price": 349.0,
  "priceBasis": "page",
  "priceMin": 349.0,
  "priceMax": 349.0,
  "totalStock": 351,
  "inStockVariants": 4,
  "detailLevel": "basic",
  "previous": {
    "price": 361.34,
    "priceBasis": "page",
    "priceCheckedAt": "2026-11-14T17:46:17+00:00",
    "totalStock": 351,
    "checkedAt": "2026-11-14T17:46:17+00:00"
  },
  "changes": ["price_down"],
  "priceChangePercent": -3.4,
  "comparable": false,
  "scrapedAt": "2026-11-14T18:51:57+00:00"
}
```

### Pricing

| Event | Price | What it is |
|---|---|---|
| `price-check` | $0.00764 ($7.64 per 1,000) | a checked product with data, also when **Only changes** hides its row |
| Actor start | $0.0077 | once per run |

Rows with `not_found`, `invalid_input` and `unavailable` are free and always shown. A run never charges more than its maximum total
charge. On the Apify free plan a run checks up to 2 different products, 3 runs a day. The **Pricing** tab always shows the current prices.

When a free run cannot go — its 3 runs of the day are used up, or free runs are not available right now — the dataset gets one free
`free_limit` row and the run ends: run again tomorrow or on a paid Apify plan.

### Good to know

- The Actor remembers the previous check of every product in your account, in `taobao-price-monitor-history`: only
  prices (the last one of each price basis, or the kept one with **Minimum price change, %**), stock, the list of variants (their IDs, without their prices and stock) and the dates of
  the checks. A product not checked for 90 days is forgotten. Up to 2,000
  products are kept, the most recently checked ones; fewer if your products have hundreds of variants each. A product that did not
  fit is `new` again at its next check. If you delete it, every product is `new` again.
- If the history is not available at the start, the run still checks the products and charges them as usual, but does not
  compare them with the past: `changes` is empty, `previous` is `null` and `comparable` is `false`, and every row is shown, also
  with **Only changes**. Such a run does not save the history, so the next run compares with it as usual. The run's status says so.
- A product that comes back as `not_found` or `unavailable` does not touch its history: the next check compares with the last good one.
  `unavailable` is a product without data this time: it is closed or needs a login, or it no longer exists (a removed ID often comes
  this way; `not_found` is for products that Taobao says do not exist). If ten products in a row come back `unavailable`, the run stops
  with a "try later" message; closed products do not count, and a run in which every product is closed ends with a message saying so.
- `couponPrice` and `soldCount` are often empty: the price after a coupon depends on the buyer, and Taobao shows sales only for some
  products. Personal prices (88VIP, 百亿补贴, 淘金币) are not included.
- A product can come as a `full` or a `basic` (shorter) record, and its price can be `page` or `converted` — both are marked in the
  row. A short record lists the variants differently from one check to the next, so variants are compared only between two full
  records, and the rise or fall of the stock only between two equally full ones. The price is compared with the last price given
  the same way (with **Minimum price change, %**, the last one marked as a change); until such a price is known, it is not compared. That is why some rows have `comparable: false` even though the
  price changed.
- A variant's stock is often shown only up to 200, so `totalStock` can be a lower bound (`stockCapped` is `true` when some variant shows
  exactly 200 and none shows more).
- Variants are compared by the list of their IDs: `variants_added` and `variants_removed` say that a variant appeared or went away. A
  change in the price or stock of a single variant is not reported on its own; price and stock changes are found on the product's
  `price` and `totalStock`.
- If Apify moves or restarts a run, it goes on from where it stopped: products already checked are not checked or charged again, and
  their history is kept. Only if a run stops abruptly, without a notice from the platform, can the checks of its last half-minute
  miss the history: the next run then compares those products with their earlier check.
- A large list takes hours: rows are written to the dataset as they come, and the default run timeout is 24 hours.
- `stopReason` in `OUTPUT`: `null` (finished), `spending_limit`, `source_unavailable` (no data right now), `actor_error` (an error of
  the Actor itself), `aborted` (the run was stopped), `free_limit` (the Apify free plan did not let the run go) or `unfinished` (cut
  short, for example by the timeout, or still running); the counts are what was done so far.

### Our other Actors

Taobao:

- [Taobao & Tmall Item Details](https://apify.com/theshark/taobao-item-details) — Taobao and Tmall products by link or ID: variants with price and stock, reviews, buyer Q\&A.
- [Taobao & Tmall Search & Shops](https://apify.com/theshark/taobao-search-shop-scraper) — search Taobao and Tmall by keyword (price, sales in sorted searches) and read shop products with shop scores.
- [Taobao & Tmall Reviews & Q\&A](https://apify.com/theshark/taobao-reviews-qa-scraper) — reviews with photos and buyer Q\&A for any product: rating, variant bought, review summary, free summary row.

Wildberries:

- [Wildberries Scraper](https://apify.com/theshark/wildberries-scraper) — Wildberries products from search and categories: price to pay, stock, sizes, rating, sellers.
- [Wildberries Reviews Scraper](https://apify.com/theshark/wildberries-reviews-scraper) — reviews and questions of products, only new ones if you like.
- [Wildberries Price Monitor](https://apify.com/theshark/wildberries-price-monitor) — prices and stock of your articles and what changed since the last run.
- [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.

***

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

**Цены и остатки Taobao и Tmall** от запуска к запуску: актор помнит прошлую проверку каждого товара и говорит, **что изменилось —
цена упала или выросла (в процентах), товар распродан, снова в наличии, появились и пропали варианты**. Запускайте его по расписанию со
ссылками или номерами товаров и получайте строку только по тем товарам, что изменились (или по каждому, если так удобнее). К каждому
товару — ссылки на байеров, что отправляют заказы с Taobao за границу, а цену можно получить ещё и в вашей валюте (доллары, евро,
фунты и другие).

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

- **Строка на товар** (`type = product`) с обычными полями товара: `title`, `price`, `priceMin` и `priceMax` по вариантам,
  `totalStock`, `inStockVariants`, `variants` (у каждого своя цена и остаток), `shop`, `shipFrom` и `agentLinks`.
- **Что изменилось** с прошлой проверки, в `changes`: `new` (первая проверка), `price_up`, `price_down`, `stock_up`, `stock_down`,
  `sold_out`, `back_in_stock`, `variants_added`, `variants_removed`. Если ничего не изменилось — список пуст.
- **`priceChangePercent`**: изменение цены в процентах, до 0,1 (со 100 до 90 — `-10.0`), относительно цены в `previous`. Есть и
  тогда, когда изменение меньше **Порог изменения цены, %** и `changes` пуст.
- **`previous`**: с чем сравнивали — `price`, `priceBasis` и `priceCheckedAt` (цена, с которой сравнили, и когда её видели), а также
  `totalStock` и `checkedAt` (прошлая проверка).
- **`comparable`**: `true` — сравнены цена, варианты и рост или падение остатка; `false` — что-то не сравнивали (см. ниже).
- **Цена в вашей валюте**: `priceConverted`, `priceMinConverted`, `priceMaxConverted` с `fxRate` и `fxDate`.
- **Ссылки байеров** в `agentLinks`: CNFans, Hoobuy, KakoBuy, Superbuy, AllChinaBuy и Sugargoo.

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

- **Одно чтение на товар.** Ни отзывов, ни вопросов, ничего лишнего: платите за проверку и только за неё.
- **Шум цены — не изменение.** Цену сравниваем только с последней ценой, данной тем же способом: `priceBasis` — `page` (цена со страницы
  товара) или `converted` (пересчитана из долларов США, в пределах 1–4 %), и валюта та же. Последнюю цену каждого способа помним 90
  дней, поэтому 100 (`page`), потом 98 (`converted`), потом 90 (`page`) — всё равно падение на 10 % относительно 100. Если ранней цены
  того же способа нет, цену не сравниваем, а `previous` показывает прошлую проверку. Изменения вариантов
  отмечаем, только когда обе проверки получили полную запись товара (`detailLevel` — `full` в обеих). Рост и падение остатка — когда
  записи одинаково полные; «распродан» и «снова в наличии» — всегда. Всё, что пропущено, делает `comparable` равным `false`.
- **Только те изменения цены, что важны вам.** Если задать **Порог изменения цены, %**, например 5, изменение цены меньше этого (в
  процентах до 0,1, как в `priceChangePercent`) — не изменение. Следующая проверка тогда сравнивается с той же прежней ценой, поэтому
  мелкие шаги складываются: 100, потом 97, потом 94 — падение на 6 % от 100, а `previous` показывает эти 100 и когда их видели.
  Изменения остатка и вариантов отмечаются как обычно. Прежнюю цену помнят все ваши запуски этого актора вместе: запуск с порогом 0
  сдвигает её и для остальных, а после того как вы снизили порог, следующая проверка сравнивается с этой прежней ценой, а не с
  прошлой проверкой.
- **Смена вашей валюты — не изменение.** Изменения ищутся по цене в юанях, поэтому смена **Цена ещё и в** между запусками ничего не меняет.
- **Понятные изменения остатка.** Остаток упал до нуля — `sold_out`, вернулся — `back_in_stock`, а не просто число.
- **Только новости.** С включённым **Только изменения** строки без изменений в датасет не попадают: в таблице и интеграциях — только
  то, что изменилось. Сама проверка оплачивается: товар прочитан.
- **Любые ссылки**: item.taobao.com, detail.tmall.com, detail.tmall.hk (Tmall Global), m.intl.taobao.com, world.taobao.com с номером,
  просто номера, текст кнопки «Поделиться» и ссылки CNFans, Hoobuy, KakoBuy, Superbuy, Sugargoo, CSSBuy и других байеров. Один товар,
  данный дважды, проверяется и оплачивается один раз.
- **Не нужны ни аккаунт Taobao, ни cookies, ни свои прокси.**

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

1. Положите в **Товары** ссылки, номера, тексты «Поделиться» или ссылки байеров — по одной на строку, до 1000 за запуск.
2. Выберите **Только изменения**, **Порог изменения цены, %** (0 — любое изменение) и **Цена ещё и в** (USD, EUR, RUB, GBP, PLN, UAH, KZT,
   BRL, CAD или AUD).
3. Запустите. Первый запуск помечает каждый товар `new`; следующие сравнивают с ним. Чтобы следить за ценами, поставьте запуск в Apify
   по расписанию (например, раз в день).
4. Строки появятся в датасете; виды `Changes`, `Variants` и `Agent links` показывают их таблицами. Итоги запуска (`OUTPUT`) — сколько
   товаров проверено, строки по статусам и почему запуск остановился (`stopReason`).

#### Примеры

Пример входа и строк первой и следующей проверки — выше, в разделе «Examples»: поля и значения те же на любом языке.

#### Цена

| Событие | Цена | За что |
|---|---|---|
| `price-check` | $0,00764 ($7,64 за 1000) | проверенный товар с данными, в том числе когда **Только изменения** скрывает его строку |
| Запуск | $0,0077 | раз на запуск |

Строки `not_found`, `invalid_input` и `unavailable` бесплатны и показываются всегда. Запуск не спишет больше своего лимита трат. На
бесплатном тарифе Apify за запуск — до 2 разных товаров, 3 запуска в сутки. Точные текущие цены — на вкладке **Pricing**.

Если бесплатный запуск идти не может — 3 запуска за сутки уже были или бесплатные запуски сейчас недоступны, — в датасете одна
бесплатная строка `free_limit`, и запуск кончается: запустите завтра или на платном тарифе Apify.

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

- Прошлую проверку каждого товара актор помнит в вашем аккаунте, в `taobao-price-monitor-history`: только цены
  (последняя по каждому способу цены, а с **Порог изменения цены, %** — прежняя, с которой сравниваем), остатки, список вариантов (их номера, без цен и остатков) и даты проверок. Товар, который не проверяли 90 дней, забывается. Хранится до 2000 товаров — те,
  что проверяли позже всех; меньше, если у товаров по сотне вариантов. Товар, который не поместился, при следующей проверке снова
  `new`. Если её удалить, все товары снова станут `new`.
- Если в начале запуска история недоступна, товары всё равно проверяются и оплачиваются как обычно, но без сравнения с прошлым:
  `changes` пустой, `previous` — `null`, `comparable` — `false`, и видны все строки, в том числе с **Только изменения**. Такой запуск
  историю не записывает — следующий сравнит с ней как обычно. Об этом сказано в статусе запуска.
- Товар со статусом `not_found` или `unavailable` свою историю не меняет: следующая проверка сравнится с последней удачной.
  `unavailable` — товар без данных в этот раз: он закрыт или требует входа, либо его больше нет (снятый товар часто приходит так;
  `not_found` — товар, которого, по словам Taobao, нет). Если десять товаров подряд пришли `unavailable`, запуск останавливается с
  сообщением «попробуйте позже»; закрытые товары в счёт не идут, а запуск, где закрыты все товары, кончается сообщением об этом.
- `couponPrice` и `soldCount` часто пусты: цена по купону зависит от покупателя, а продажи Taobao показывает не у всех товаров.
  Личные цены (88VIP, 百亿补贴, 淘金币) не входят.
- Товар может прийти полной записью `full` или короткой `basic`, а цена — `page` или `converted`: оба признака — в строке. Короткая
  запись от проверки к проверке перечисляет варианты по-разному, поэтому варианты сравниваем только между двумя полными записями, а
  рост и падение остатка — только между одинаково полными. Цену сравниваем с последней ценой, полученной тем же способом (с **Порог
  изменения цены, %** — с последней, отмеченной как изменение); пока такой нет, цену не сравниваем. Потому у части строк `comparable: false`, хотя цена изменилась.
- Остаток варианта часто показывают только до 200, поэтому `totalStock` может быть «не меньше» (`stockCapped` — `true`, если у какого-то
  варианта ровно 200 и ни у одного нет больше).
- Варианты сравниваются по списку их номеров: `variants_added` и `variants_removed` говорят, что вариант появился или пропал. Изменение
  цены или остатка одного варианта само по себе не отмечается; изменения цены и остатка ищутся по `price` и `totalStock` товара.
- Если Apify переносит или перезапускает запуск, он продолжает с того места, где остановился: уже проверенные товары не проверяются и
  не списываются второй раз, а их история сохраняется. Только если запуск оборвётся внезапно, без предупреждения платформы, проверки
  его последних полминуты могут не попасть в историю: следующий запуск сравнит эти товары с их прошлой проверкой.
- Большой список идёт часами: строки пишутся в датасет по мере готовности, а таймаут запуска по умолчанию — 24 часа.
- `stopReason` в `OUTPUT`: `null` (дошли до конца), `spending_limit`, `source_unavailable` (сейчас нет данных), `actor_error`
  (ошибка самого актора), `aborted` (запуск остановили), `free_limit` (бесплатный тариф Apify не пустил запуск) или `unfinished`
  (оборван, например таймаутом, или ещё идёт); счётчики — то, что сделано к этому моменту.

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

Taobao:

- [Парсер Taobao и Tmall](https://apify.com/theshark/taobao-item-details) — товары Taobao и Tmall по ссылке или номеру: варианты с ценой и остатком, отзывы, вопросы покупателей.
- [Поиск и магазины Taobao](https://apify.com/theshark/taobao-search-shop-scraper) — поиск по Taobao и Tmall (цена, продажи у поиска с сортировкой) и товары магазинов с оценками магазина.
- [Отзывы и вопросы Taobao](https://apify.com/theshark/taobao-reviews-qa-scraper) — отзывы с фото и вопросы покупателей к любому товару: оценка, купленный вариант, сводка по отзывам.

Wildberries:

- [Парсер Wildberries](https://apify.com/theshark/wildberries-scraper) — товары Wildberries из поиска и категорий: цена к оплате, остатки, размеры, рейтинг, продавцы.
- [Парсер отзывов Wildberries](https://apify.com/theshark/wildberries-reviews-scraper) — отзывы и вопросы о товарах, можно только новые.
- [Мониторинг цен Wildberries](https://apify.com/theshark/wildberries-price-monitor) — цены и наличие ваших артикулов и что изменилось с прошлого запуска.
- [Парсер продавцов 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

## `items` (type: `array`):

One product per line: a link (item.taobao.com, detail.tmall.com, detail.tmall.hk, m.intl.taobao.com, world.taobao.com with a number), a product ID, the text copied from the Taobao app's Share button, or a link from a buying agent (CNFans, Hoobuy, KakoBuy, Superbuy, CSSBuy and others). The same product given twice is checked once.<br><br>По товару на строку: ссылка (item.taobao.com, detail.tmall.com, detail.tmall.hk, m.intl.taobao.com, world.taobao.com с номером), номер товара, текст из кнопки «Поделиться» приложения Taobao или ссылка байера (CNFans, Hoobuy, KakoBuy, Superbuy, CSSBuy и другие). Один товар, данный дважды, проверяется один раз.

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

On: a product with no change since the previous check is not written to the dataset, but the check is paid. A product checked for the first time is always written. Off: every checked product gets a row.<br><br>Включено: товар без изменений с прошлой проверки в датасет не попадает, но проверка оплачивается. Товар, проверенный впервые, попадает всегда. Выключено: строка на каждый проверенный товар.

## `min_price_change` (type: `integer`):

A price change smaller than this, in percent to 0.1, is not a change. The next check is then compared with the same earlier price, so small steps add up: with 5, a price of 100, then 97, then 94 is a drop of 6 % from 100. 0: every price change counts. Stock and variant changes are marked as usual.<br><br>Изменение цены меньше этого, в процентах до 0,1, — не изменение. Следующая проверка тогда сравнивается с той же прежней ценой, поэтому мелкие шаги складываются: при 5 цена 100, потом 97, потом 94 — падение на 6 % от 100. 0 — считается любое изменение цены. Изменения остатка и вариантов отмечаются как обычно.

## `currency` (type: `string`):

Besides the price in yuan (CNY), give it in this currency at today's exchange rate. Changes are always found on the yuan price, so switching the currency between runs does not make a change. Included in the price.<br><br>Кроме цены в юанях (CNY), дать её в этой валюте по курсу дня. Изменения ищутся всегда по цене в юанях, поэтому смена валюты между запусками изменением не считается. Входит в цену.

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

Language of the run log and status messages. Product data stays as Taobao gives it.<br><br>Язык лога и сообщений запуска. Данные товаров — как их даёт Taobao.

## Actor input object example

```json
{
  "items": [
    "582890145005",
    "1078907312106"
  ],
  "only_changes": false,
  "min_price_change": 0,
  "currency": "USD",
  "output_language": "en"
}
```

# Actor output Schema

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

A row per product that changed (or per checked product, when Only changes is off) with what changed since the previous check. Строка на товар, который изменился (или на каждый проверенный, если «Только изменения» выключено), и что изменилось с прошлой проверки.

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

How many products were checked, rows by status and why the run stopped. Сколько товаров проверено, строки по статусам и почему запуск остановился.

# 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 = {
    "items": [
        "582890145005",
        "1078907312106"
    ],
    "only_changes": false,
    "currency": "USD"
};

// Run the Actor and wait for it to finish
const run = await client.actor("theshark/taobao-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 = {
    "items": [
        "582890145005",
        "1078907312106",
    ],
    "only_changes": False,
    "currency": "USD",
}

# Run the Actor and wait for it to finish
run = client.actor("theshark/taobao-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 '{
  "items": [
    "582890145005",
    "1078907312106"
  ],
  "only_changes": false,
  "currency": "USD"
}' |
apify call theshark/taobao-price-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,theshark/taobao-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/lu9pXeLYbC6KERcMB/builds/I4duwvo4TJeF7p2dK/openapi.json
