# Taobao & Tmall 淘宝 Search & Shops · Поиск и магазины Taobao (`theshark/taobao-search-shop-scraper`) Actor

Search Taobao and Tmall by keyword: price, photos, sales in sorted searches. Shop products with shop scores. Full records, translation, your currency, agent links. Поиск по Taobao и Tmall: цена, фото, продажи при сортировке. Товары магазинов с оценками. Карточки, перевод, валюта, ссылки байеров.

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

## Pricing

from $4.24 / 1,000 search result · результат поиска

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 淘宝 Search & Shops · Поиск и магазины Taobao

Search **Taobao and Tmall by keyword** and read **shop products**: every result with its **price, where it ships from and photos**,
plus the **shop and sales** where Taobao gives them (sales in sorted, Tmall-only and price-range searches), a shop's products with
the **shop's scores**, and on request the **full product record** — variants with price and stock, attributes. Titles come in
English, Spanish, Portuguese, German, French, Polish or Russian, prices also in your currency (USD, EUR, GBP and more), and every
product links to buying agents that ship Taobao orders abroad.

淘宝、天猫关键词搜索和店铺商品：价格、发货地和图片（销量见排序、仅天猫和价格区间搜索），店铺评分，可附带完整商品详情（每个SKU的价格和库存）。支持英语、俄语、西班牙语、葡萄牙语、德语、法语和波兰语翻译标题，价格可换算为多种货币。

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

### What you get

- **A row per search result** (`type = search_result`): `query`, `page`, `rank`, `title`, `price` with `priceBasis`, `originalPrice`,
  `discountType`, `soldText` and `soldCount`, `shipFrom`, `shopName` and `shopId`, `isTmall`, `freeShipping`, `image` and `images`.
- **A row per shop product** (`type = shop_product`): the shop (`shopId`, `sellerId`, `shopName`, `shopUrl`, `shopLogo`,
  `shopItemCount`, `scoreDescription`, `scoreService`, `scoreDelivery`), `page`, `rank`, `title`, `originalPrice` (the price Taobao
  lists struck through; the selling price can be lower), `categoryId`, `freeShipping` and `image`. A shop row has no sales.
- **A free `partial` row** (`type = shop_product`, `status = partial`): this time the shop gave only its first products. The row has
  `input`, `shopId`, `shopName`, `page` and `itemsReturned` (how many products came); that shop is not asked for more pages.
- **The full product record on request** (`type = product`, with **Product details**): every variant with price and stock,
  attributes, photos, shop — the same product fields as in our Item Details Actor, without the review summary; `input` is the
  product ID.
- **Translation** of titles next to the Chinese original: `titleTranslated`.
- **The price in your currency**: `priceConverted` and `originalPriceConverted` with `fxRate` and `fxDate`.
- **Buying-agent links** in `agentLinks`: CNFans, Hoobuy, KakoBuy, Superbuy, AllChinaBuy and Sugargoo.

### Why this Actor

- **Searches and shops in one run.** Give search words, shops or both, up to 100 searches and shops per run; `max_items` is one
  number for all of them.
- **Deep lists.** A plain search reads up to 1,000 products over 50 pages. A shop that gives its whole list gives up to 2,060
  products (Taobao shows no more), but often a shop gives only its first products (see "Good to know").
- **Each product once per search.** A product that comes twice in the same search or shop gives one row and is paid once.
- **One product record per run.** With **Product details**, a product found in several searches or shops gets one full product record per run, paid once; its search or shop row stays in each.
- **Clear rows.** `priceBasis` says what `price` is. In search rows: `page` — the price on the page; `list` — the struck-through
  price before a discount, higher than the selling price; `promotion` — Taobao's affiliate promotion price, often well below the
  page price (a plain search gives mostly this from the third page). In full product rows: `page` or `converted` (recalculated from
  US dollars, within 1–4 %). Sales (`soldText`, `soldCount`) are on most rows of searches with a sort, Tmall only or a price range;
  a plain search has no sales, and its first two pages have no shop name. Where Taobao gives nothing, the field is empty.
- **Translation, the price in another currency and agent links cost nothing extra.**
- **No Taobao account, cookies or proxies of your own.**

### How to use

1. Put search words into **Search words** (one per line) and/or shop links or seller IDs into **Shops**: up to 100 searches and
   shops per run. A number in **Shops** is the seller ID (`sellerId`), not the number from the shop link: for a shop you know by
   its link, give the link itself.
2. Set **Products per search or shop**: one number for the whole run, from 20 (rows come in pages of 20). With search words it is
   at most 1,000, shops included; without them a shop can give up to 2,060.
3. For a search choose **Sort searches by** and, if needed, **Tmall only** or a price range — these give one page of up to 10
   products (up to 20 with a price range alone), not a long list.
4. Turn on **Product details** if you need the full record of each product; choose **Translate to** (English, Spanish, Portuguese, German, French, Polish or Russian) and
   **Price also in** (USD, EUR, RUB, GBP, PLN, UAH, KZT, BRL, CAD or AUD).
5. Run it. Rows appear in the dataset; the `Search results`, `Shop products`, `Product details` and `Agent links` views show them as
   tables. The run summary (`OUTPUT`) counts search results, shop products and product rows, and shows the rows by status and why the
   run stopped (`stopReason`).

### Examples

Input:

```json
{
  "keywords": ["手机壳"],
  "shops": ["https://shop72104903.taobao.com", "https://shop117548108.taobao.com"],
  "max_items": 40,
  "translate_to": "en",
  "currency": "USD"
}
```

A search result row, shortened:

```json
{
  "type": "search_result",
  "status": "ok",
  "query": "手机壳",
  "page": 3,
  "rank": 41,
  "itemId": "754538498431",
  "title": "适用苹果13手机壳iphone15ProMax新款16透明18无边框电镀硬壳…",
  "titleTranslated": "Fits iPhone 13 phone case, iPhone 15 Pro Max, new 16 clear…",
  "price": 2.88,
  "priceBasis": "promotion",
  "originalPrice": 4.88,
  "priceConverted": 0.4,
  "convertedCurrency": "USD",
  "shipFrom": "广东 佛山",
  "shopName": "啵啵啵工作室",
  "isTmall": false,
  "freeShipping": false,
  "agentLinks": {"hoobuy": "https://www.hoobuy.com/product/1/754538498431"}
}
```

A shop product row, shortened. `input` is the shop line as you gave it; `shopId` is the real ID of the shop (empty in a row without data):

```json
{
  "type": "shop_product",
  "status": "ok",
  "input": "https://shop72104903.taobao.com",
  "shopId": "72104903",
  "sellerId": "896588234",
  "shopName": "图拉斯数码旗舰店",
  "shopUrl": "https://shop72104903.taobao.com",
  "shopItemCount": 201,
  "scoreDescription": 4.7,
  "page": 1,
  "rank": 1,
  "itemId": "890935783764",
  "title": "图拉斯新无界膜AR抗反射适用苹果18Pro钢化膜iPhone17promax无黑边17手机保护膜16pm保护屏幕防摔15pro防指纹官",
  "originalPrice": 96.0,
  "categoryId": "50012587",
  "freeShipping": false
}
```

A `partial` row: the second shop of the input gave only its first 5 products this time (its 5 rows come first, then this free
row):

```json
{
  "type": "shop_product",
  "status": "partial",
  "input": "https://shop117548108.taobao.com",
  "shopId": "117548108",
  "shopName": "第一卫旗舰店",
  "page": 1,
  "itemsReturned": 5
}
```

### Pricing

| Event | Price | What it is |
|---|---|---|
| `search-result` | $0.00424 ($4.24 per 1,000) | a search result row with data |
| `shop-product` | $0.00424 ($4.24 per 1,000) | a shop product row with data |
| `product` | $0.00764 ($7.64 per 1,000) | a full product row, with **Product details** |
| Actor start | $0.0425 | once per run |

Rows with `no_results`, `not_found`, `partial`, `invalid_input` and `unavailable` are free. A run never charges more than its maximum total
charge. On the Apify free plan a run reads one search or one shop, up to 20 products, without Product details, 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

- **Sorted, Tmall-only and price-range searches give one page** of up to 10 products (up to 20 with a price range alone, not
  together with Tmall only); only a plain search by relevance has pages. Use several search words to get more. Most popular and Price, high to low do not combine with a
  price range (the run stops with a message); Tmall only does.
- In a plain search the first two pages have no shop name; from the third page it is there. Sales are only in searches with a sort,
  Tmall only or a price range.
- `promotion` prices are often well below the price on the page, and `list` prices are above the selling price: compare prices on
  rows with `priceBasis` `page`.
- Often a shop gives only its first products (up to 20) for a request: you get those rows and one free `partial` row, and the run
  goes on to the next shop. Within 12 hours the same shop gives the same short list again, and its rows are charged again: read it
  again not earlier than 12 hours later.
- Taobao shows a shop's first ~2,060 products per order; a bigger shop cannot be taken in full.
- The same product can come at a slightly different price on the next run: Taobao changes prices and the order of results all the
  time.
- Personal prices (88VIP, 百亿补贴, 淘金币) depend on the buyer's account and are not included.
- `unavailable` is a search, a shop or a product that gave no data this time (a closed product, a removed one); it is free. If ten in
  a row come back `unavailable`, the run stops with a "try later" message; closed products do not count, and a run in which
  everything is closed ends with a message saying so.
- If Apify moves or restarts a run, it goes on from where it stopped: searches, shops and pages already done are not read, written
  or charged again.
- 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 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.
- [Taobao & Tmall Price Monitor](https://apify.com/theshark/taobao-price-monitor) — prices and stock of your products and what changed since the last run.

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 (продажи — у поиска с сортировкой, «Только Tmall» или диапазоном цены), у товара магазина — **оценки
магазина**, а по желанию — **полная строка товара**: варианты с ценой и остатком, характеристики.
Названия можно получить на английском, русском, испанском, португальском, немецком, французском или польском, цены — ещё и в вашей
валюте (доллары, евро, фунты и другие), а к каждому товару — ссылки на байеров, что отправляют заказы с Taobao за границу.

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

- **Строка на результат поиска** (`type = search_result`): запрос (`query`), страница, место (`rank`), название, цена и её основа
  (`priceBasis`), цена до скидки, название акции, продажи (`soldText`, `soldCount`), откуда отправка, магазин (`shopName`, `shopId`),
  `isTmall`, бесплатная доставка, фото.
- **Строка на товар магазина** (`type = shop_product`): магазин (`shopId`, `sellerId`, `shopName`, `shopUrl`, `shopLogo`,
  `shopItemCount`, оценки `scoreDescription`, `scoreService`, `scoreDelivery`), страница, место, название, цена (`originalPrice` —
  та, что Taobao показывает зачёркнутой; цена продажи может быть ниже), категория, бесплатная доставка, фото. Продаж у строки
  магазина нет.
- **Бесплатная строка `partial`** (`type = shop_product`, `status = partial`): магазин в этот раз отдал только первые товары. В строке
  `input`, `shopId`, `shopName`, `page` и `itemsReturned` (сколько товаров пришло); больше страниц у этого магазина не просим.
- **Полная строка товара по желанию** (`type = product`, с «Карточки товаров»): все варианты с ценой и остатком, характеристики, фото,
  магазин — те же поля товара, что у нашего актора карточек, без сводки по отзывам; `input` — номер товара.
- **Перевод** названий рядом с китайским оригиналом: `titleTranslated`.
- **Цена в вашей валюте**: `priceConverted` и `originalPriceConverted`, курс `fxRate` и его дата `fxDate`.
- **Ссылки байеров** в `agentLinks`: CNFans, Hoobuy, KakoBuy, Superbuy, AllChinaBuy и Sugargoo.

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

- **Поиск и магазины за один запуск.** Дайте слова, магазины или то и другое — до 100 запросов и магазинов за запуск; `max_items` — одно число для всех.
- **Глубокие списки.** Обычный поиск читает до 1000 товаров на 50 страницах. Магазин, который отдаёт весь список, даёт до 2060
  товаров (больше Taobao не показывает), но часто магазин отдаёт только первые товары — см. «Что важно знать».
- **Каждый товар — раз на запрос.** Товар, пришедший дважды в одном поиске или магазине, даёт одну строку и оплачивается один раз.
- **Полная строка товара — одна на запуск.** С «Карточки товаров» товар, найденный в нескольких запросах или магазинах, получает одну полную строку за запуск и оплачивается один раз; его строка поиска или магазина остаётся в каждом.
- **Понятные строки.** `priceBasis` говорит, что такое `price`. В строках поиска: `page` — цена со страницы; `list` — зачёркнутая цена
  до скидки, выше цены продажи; `promotion` — цена по акции для реферальной программы Taobao, часто заметно ниже цены на странице
  (обычный поиск с третьей страницы даёт в основном её). В полных строках товара: `page` или `converted` (пересчёт из долларов,
  в пределах 1–4 %). Продажи (`soldText`, `soldCount`) есть у большинства строк поиска с сортировкой, «Только Tmall» или диапазоном
  цены; у обычного поиска продаж нет, а на первых двух страницах нет и названия магазина. Где Taobao ничего не даёт, поле пустое.
- **Перевод, цена в другой валюте и ссылки байеров — без доплаты.**
- **Не нужны ни аккаунт Taobao, ни cookies, ни свои прокси.**

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

1. Положите слова в **Поисковые слова** (по одному на строку) и/или ссылки магазинов или ID продавцов в **Магазины**: до 100
   запросов и магазинов за запуск. Число в **Магазины** — это ID продавца (`sellerId`), а не номер из ссылки магазина: магазин,
   который вы знаете по ссылке, давайте самой ссылкой.
2. Задайте **Товаров на запрос или магазин**: одно число на весь запуск, от 20 (строки приходят страницами по 20). Со словами для
   поиска — не больше 1000, магазины тоже; без слов магазин даёт до 2060.
3. Для поиска выберите **Сортировка поиска** и, если нужно, **Только Tmall** или диапазон цены — они дают одну страницу до 10
   товаров (до 20 с одним диапазоном цены), а не длинный список.
4. Включите **Карточки товаров**, если нужна полная запись каждого товара; выберите **Перевести на** (английский, русский, испанский, португальский, немецкий, французский или польский) и
   **Цена ещё и в** (USD, EUR, RUB, GBP, PLN, UAH, KZT, BRL, CAD или AUD).
5. Запустите. Строки появятся в датасете; виды `Search results`, `Shop products`, `Product details` и `Agent links` показывают их
   таблицами. Итоги запуска (`OUTPUT`) — сколько результатов поиска, товаров магазинов и карточек, строки по статусам и почему запуск
   остановился (`stopReason`).

#### Примеры

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

#### Цена

| Событие | Цена | За что |
|---|---|---|
| `search-result` | $0,00424 ($4,24 за 1000) | строка результата поиска с данными |
| `shop-product` | $0,00424 ($4,24 за 1000) | строка товара магазина с данными |
| `product` | $0,00764 ($7,64 за 1000) | полная строка товара, с «Карточки товаров» |
| Запуск | $0,0425 | раз на запуск |

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

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

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

- **Поиск с сортировкой, «Только Tmall» и диапазоном цены даёт одну страницу** — до 10 товаров (до 20 с одним диапазоном цены, без
  «Только Tmall»); страницы есть только у обычного поиска по релевантности. Чтобы получить больше, дайте несколько слов. «Самые популярные» и «Цена по
  убыванию» не сочетаются с диапазоном цены (запуск остановится с сообщением), «Только Tmall» — сочетается.
- У обычного поиска на первых двух страницах нет названия магазина, с третьей — есть. Продажи бывают только у поиска с сортировкой,
  «Только Tmall» или диапазоном цены.
- Цены `promotion` часто заметно ниже цены на странице, а цены `list` выше цены продажи: сравнивайте цены по строкам с `priceBasis`
  `page`.
- Часто магазин отдаёт только первые товары (до 20): вы получите эти строки и одну бесплатную строку `partial`, а запуск пойдёт к
  следующему магазину. В течение 12 часов тот же магазин снова отдаст тот же короткий список, и его строки оплачиваются снова:
  читайте его ещё раз не раньше чем через 12 часов.
- Taobao показывает первые ~2060 товаров магазина в одном порядке; у большого магазина целиком товары не получить.
- Один и тот же товар в следующий запуск может прийти по чуть другой цене: Taobao постоянно меняет цены и порядок выдачи.
- Персональных цен (88VIP, 百亿补贴, 淘金币) нет: они зависят от аккаунта покупателя.
- `unavailable` — запрос, магазин или товар, по которому в этот раз нет данных (закрытый или снятый товар); строка бесплатна. Если
  десять подряд пришли `unavailable`, запуск останавливается с сообщением «попробуйте позже»; закрытые товары в счёт не идут, а
  запуск, где закрыто всё, кончается сообщением об этом.
- Если 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-reviews-qa-scraper) — отзывы с фото и вопросы покупателей к любому товару: оценка, купленный вариант, сводка по отзывам.
- [Мониторинг цен Taobao](https://apify.com/theshark/taobao-price-monitor) — цены и остатки ваших товаров и что изменилось с прошлого запуска.

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

## `keywords` (type: `array`):

One search per line; Chinese words work best (for example 手机壳, a phone case). Plain search lists up to 1,000 products over 50 pages. With a sort other than Relevance, Tmall only or a price range a search gives one page of up to 10 products (up to 20 with a price range alone). Up to 100 searches and shops per run.<br><br>По запросу на строку; лучше всего работают китайские слова (например 手机壳, чехол для телефона). Обычный поиск даёт до 1000 товаров на 50 страницах. С сортировкой не по релевантности, «Только Tmall» или диапазоном цены поиск даёт одну страницу — до 10 товаров (до 20 с одним диапазоном цены). До 100 запросов и магазинов за запуск.

## `shops` (type: `array`):

One shop per line: a shop link (shop12345678.taobao.com, the mobile one too) or the seller's numeric ID (sellerId). A number is read as the seller ID, not the number from the shop link: for a shop you know by its link, give the link itself. You get the shop's products, best sellers first, up to 2,060 per shop (Taobao shows no more). Up to 100 searches and shops per run.<br><br>По магазину на строку: ссылка магазина (shop12345678.taobao.com, мобильная тоже) или числовой ID продавца (sellerId). Число — это ID продавца, а не номер из ссылки магазина: магазин, который вы знаете по ссылке, давайте самой ссылкой. Товары магазина, сначала самые продаваемые, до 2060 на магазин (больше Taobao не показывает). До 100 запросов и магазинов за запуск.

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

How many products to take per search and per shop: one number for the whole run. With search words it is at most 1,000, shops included; without search words a shop can give up to 2,060. From 20: rows come in pages of 20. You pay per product row.<br><br>Сколько товаров брать на запрос и на магазин: одно число на весь запуск. Со словами для поиска — не больше 1000, магазины тоже; без слов магазин даёт до 2060. От 20: строки приходят страницами по 20. Платите за строку товара.

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

Order of search results. Most popular and Price, high to low give one page of up to 10 products and do not combine with a price range. Shops are always sorted by best sellers.<br><br>Порядок результатов поиска. «Самые популярные» и «Цена по убыванию» дают одну страницу — до 10 товаров — и не сочетаются с диапазоном цены. Магазины всегда идут по продажам.

## `tmall_only` (type: `boolean`):

Search only Tmall products. Gives one page of up to 10 products.<br><br>Искать только товары Tmall. Даёт одну страницу — до 10 товаров.

## `min_price` (type: `integer`):

Search only products from this price, in yuan. A price range gives one page of up to 20 products (up to 10 together with Tmall only).<br><br>Искать товары от этой цены, в юанях. Диапазон цены даёт одну страницу — до 20 товаров (до 10 вместе с «Только Tmall»).

## `max_price` (type: `integer`):

Search only products up to this price, in yuan.<br><br>Искать товары до этой цены, в юанях.

## `include_details` (type: `boolean`):

After each result add the full product row: every variant with price and stock, attributes, photos and the shop. You pay for it on top of the result row. Not on the Apify free plan.<br><br>После каждого результата добавить полную строку товара: все варианты с ценой и остатком, характеристики, фото и магазин. Оплачивается сверх строки результата. На бесплатном тарифе Apify недоступно.

## `translate_to` (type: `string`):

Translate product titles. The Chinese original stays next to the translation. A title that is already in English stays as it is. Included in the price.<br><br>Перевести названия товаров. Китайский оригинал остаётся рядом с переводом. Название, уже написанное по-английски, остаётся как есть. Входит в цену.

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

Besides the price in yuan (CNY), give it in this currency at today's exchange rate. 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
{
  "keywords": [
    "手机壳"
  ],
  "max_items": 20,
  "sort": "relevance",
  "tmall_only": false,
  "include_details": false,
  "translate_to": "en",
  "currency": "USD",
  "output_language": "en"
}
```

# Actor output Schema

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

A row per search result and per shop product and, when asked, a full product row. Строка на результат поиска и на товар магазина и, если просили, полная строка товара.

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

How many search results, shop products and product rows, 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 = {
    "keywords": [
        "手机壳"
    ],
    "max_items": 20,
    "translate_to": "en",
    "currency": "USD"
};

// Run the Actor and wait for it to finish
const run = await client.actor("theshark/taobao-search-shop-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 = {
    "keywords": ["手机壳"],
    "max_items": 20,
    "translate_to": "en",
    "currency": "USD",
}

# Run the Actor and wait for it to finish
run = client.actor("theshark/taobao-search-shop-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 '{
  "keywords": [
    "手机壳"
  ],
  "max_items": 20,
  "translate_to": "en",
  "currency": "USD"
}' |
apify call theshark/taobao-search-shop-scraper --silent --output-dataset

```

## MCP server setup

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