# Taobao & Tmall 淘宝 Item Details · Парсер Taobao и Tmall (`theshark/taobao-item-details`) Actor

Taobao and Tmall products by link, ID or share text: variants with price and stock, attributes, photos, shop, reviews with photos, buyer Q\&A. Товары Taobao и Tmall по ссылке или номеру: варианты с ценой и остатком, характеристики, фото, магазин, отзывы с фото и вопросы покупателей.

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

## Pricing

from $7.64 / 1,000 product · товар

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 淘宝 Item Details · Парсер Taobao и Tmall

Get **Taobao and Tmall product details** as clean rows: **every variant (SKU) with its own price, stock and image**, attributes,
photos, description, shop and where it ships from, and on request **buyer reviews with photos** and **buyer Q\&A (问大家)**. Give product
links, IDs, the text from the Taobao app's Share button or links from buying agents. Titles, variants and reviews can come in English,
Spanish, Portuguese, German, French, Polish or Russian, the price also in your currency (USD, EUR, GBP and more), and every product
links to buying agents that ship Taobao orders abroad.

淘宝、天猫商品详情：每个SKU的价格、库存和图片，商品属性、店铺、发货地，以及买家评价（含晒图）和问大家。支持商品链接、商品ID、淘宝分享文案和代购链接。支持英语、俄语、西班牙语、葡萄牙语、德语、法语和波兰语翻译，价格可换算为多种货币。

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

### What you get

- **A row per product** (`type = product`): `input` (the line you gave), `itemId`, `title`, `brand`, `price`, `priceMin` and `priceMax` over the variants, `totalStock`,
  `inStockVariants`, `reviewCount`, `favoriteCount`, `attributes`, `images`, `descriptionImages`, `descriptionHtml`, `videoUrl`,
  `shop` (`shopId`, `sellerId`, `name`, `itemCount`), `shipFrom`, `shippingFee`, `freeShipping`, `sevenDayReturn` and
  `platform` (`taobao`, `tmall` or `tmallGlobal`).
- **Every variant** in `variants`: `skuId`, `name`, `options` split by property (color → black, size → M; a value without a property
  name, like 均码, is under `option`), `price`, `couponPrice`, `stock` and `image`; `optionAxes` lists each property with its values.
- **Reviews** (`type = review`, with **Reviews**): `rating`, `text`, `postedAt`, the `variant` bought, `photos`, `followUp` and
  `usefulCount`. Buyers' names and avatars are never included; phone numbers, e-mails and QQ / WeChat IDs in the text become `***`.
- **A review summary** in the product row: rating counts, share of reviews with photos, reviews in the last 30 days and
  **`topVariants` — the variants buyers actually buy**, by the variant named in their reviews.
- **Buyer Q\&A** (`type = question`, with **Buyer Q\&A**): `question`, `answerCount`, an `answer` and the dates; contacts in the text are
  masked the same way.
- **Translation** next to the Chinese original: `titleTranslated`, `variants[].nameTranslated`, `attributes[].valueTranslated`,
  `textTranslated` and more. Text that is already in English stays as it is.
- **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

- **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 read and paid once.
- **The variants buyers buy.** The review summary shows which variants appear most in reviews: a ready answer to "what sells".
- **Clear rows.** `priceBasis` tells whether the price is the one on the product page (`page`) or recalculated from US dollars
  (`converted`, within 1–4 %). `detailLevel` tells whether the record is complete (`full`) or shorter (`basic`), and `missingFields`
  names what is empty. `stockCapped` is `true` when some variant shows exactly 200, the most that is often shown, and none shows more:
  then `totalStock` is at least that.
- **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 product links, IDs, Share texts or buying-agent links into **Products**, one per line, up to 1,000 per run.
2. Turn on **Reviews** and **Buyer Q\&A (问大家)** if you need them, and set how many per product: up to 1,000 reviews (Taobao shows
   no more) and up to 100 questions.
3. 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).
4. Run it. Rows appear in the dataset; the `Products`, `Variants`, `Reviews`, `Buyer Q&A` and `Agent links` views show them as tables.
   The run summary (`OUTPUT`) counts products, reviews and questions, and shows the rows by status and why the run stopped
   (`stopReason`).

### Examples

Input:

```json
{
  "items": ["https://detail.tmall.com/item.htm?id=582890145005", "1079060893785"],
  "include_reviews": true,
  "max_reviews": 40,
  "translate_to": "en",
  "currency": "USD"
}
```

A product row, shortened:

```json
{
  "type": "product",
  "status": "ok",
  "input": "1079060893785",
  "itemId": "1079060893785",
  "platform": "tmall",
  "title": "第一卫适用苹果18Pro手机壳iPhone18ProMax新款磨砂…",
  "price": 54.7,
  "priceBasis": "page",
  "priceMin": 54.7,
  "priceMax": 66.5,
  "priceConverted": 8.2,
  "convertedCurrency": "USD",
  "totalStock": 43394,
  "stockCapped": true,
  "inStockVariants": 217,
  "reviewCount": 1149,
  "variants": [
    {"skuId": "6295454587946", "options": {"颜色分类": "【酒红色】…", "适用手机型号": "iPhone 18 Pro Max"}, "price": 54.7, "stock": 194}
  ],
  "shop": {"shopId": "117548108", "name": "第一卫旗舰店", "itemCount": 715},
  "shipFrom": "广东深圳",
  "freeShipping": true,
  "agentLinks": {"hoobuy": "https://www.hoobuy.com/product/1/1079060893785"},
  "detailLevel": "full",
  "missingFields": ["descriptionHtml", "soldCount", "couponPrice", "originalPrice"]
}
```

### Pricing

| Event | Price | What it is |
|---|---|---|
| `product` | $0.00764 ($7.64 per 1,000) | a product row with data |
| `review` | $0.0039 ($3.90 per 1,000) | a review row, with **Reviews** |
| `question` | $0.0068 ($6.80 per 1,000) | a buyer question row, with **Buyer Q\&A** |
| Actor start | $0.0077 | once per run |

Rows with `not_found`, `invalid_input` and `unavailable` are free. A run never charges more than its maximum total charge. On the
Apify free plan a run reads up to 2 different products, 20 reviews and 10 questions per product, 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

- `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, 百亿补贴, 淘金币) depend on the buyer's account and are not included.
- A product can come as a `full` or a `basic` record, and its price can be `page` or `converted` — both are marked in the row.
- A variant's stock is often shown only up to 200 (see `stockCapped`), and a product has at most 1,000 reviews to read.
- Each question comes with one answer; `answerCount` tells how many Taobao has.
- With **Reviews**, `reviewsComplete` is `false` when fewer reviews came than you asked for and the product has more, or when the
  spending limit was reached; the review summary covers what was read.
- `unavailable` is a product without data this time: it is closed or needs a login, or it no longer exists (a mistyped or removed ID
  often comes this way; `not_found` is for products that Taobao says do not exist). Such rows are free. 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.
- If Apify moves or restarts a run, it goes on from where it stopped: products 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 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.
- [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** чистыми строками: **каждый вариант (SKU) со своей ценой, остатком и картинкой**, характеристики,
фото, описание, магазин и откуда отправка, а по желанию — **отзывы покупателей с фото** и **вопросы покупателей (问大家)**. Дайте
ссылки, номера товаров, текст из кнопки «Поделиться» приложения Taobao или ссылки байеров. Названия, варианты и отзывы можно получить
на английском, русском, испанском, португальском, немецком, французском или польском, цену — ещё и в вашей валюте (доллары, евро,
фунты и другие), а к каждому товару — ссылки на байеров, что отправляют заказы с Taobao за границу.

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

- **Строка на товар** (`type = product`): `input` (строка, которую вы дали), `itemId`, название, бренд, цена, диапазон цен по вариантам (`priceMin`, `priceMax`), остаток всех
  вариантов (`totalStock`), сколько вариантов в наличии, число отзывов и добавлений в избранное, характеристики, фото, описание,
  видео, магазин (`shop`), откуда отправка (`shipFrom`), доставка, возврат за 7 дней и площадка (`taobao`, `tmall` или
  `tmallGlobal`).
- **Каждый вариант** в `variants`: `skuId`, название, свойства по отдельности (`options`: цвет → чёрный, размер → M; значение без
  имени свойства, например 均码, — под ключом `option`), цена, цена после купона, остаток и картинка; `optionAxes` — какие есть
  значения у каждого свойства.
- **Отзывы** (`type = review`, с «Отзывы»): оценка, текст, дата, купленный вариант, фото, дополнение к отзыву, «полезно». Имён и
  аватаров покупателей нет никогда; телефоны, почта и ID в QQ и WeChat в тексте заменены на `***`.
- **Сводка по отзывам** в строке товара: сколько каких оценок, доля с фото, отзывы за 30 дней и **`topVariants` — какие варианты
  покупают на самом деле** (по варианту, названному в отзыве).
- **Вопросы покупателей** (`type = question`, с «Вопросы покупателей»): вопрос, число ответов, ответ и даты; контакты в тексте
  заменены так же.
- **Перевод** рядом с китайским оригиналом: `titleTranslated`, `variants[].nameTranslated`, `attributes[].valueTranslated`,
  `textTranslated` и другие. Текст, уже написанный по-английски, остаётся как есть.
- **Цена в вашей валюте**: `priceConverted`, `priceMinConverted`, `priceMaxConverted`, курс `fxRate` и его дата `fxDate`.
- **Ссылки байеров** в `agentLinks`: CNFans, Hoobuy, KakoBuy, Superbuy, AllChinaBuy и Sugargoo.

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

- **Любая ссылка**: item.taobao.com, detail.tmall.com, detail.tmall.hk (Tmall Global), m.intl.taobao.com, world.taobao.com с номером,
  номера товаров, текст «Поделиться» и ссылки CNFans, Hoobuy, KakoBuy, Superbuy, Sugargoo, CSSBuy и других байеров. Один товар, данный
  дважды, читается и оплачивается один раз.
- **Какие варианты покупают.** Сводка по отзывам показывает, какие варианты чаще всего называют покупатели: готовый ответ на вопрос
  «что продаётся».
- **Понятные строки.** `priceBasis`: `page` — цена со страницы товара, `converted` — пересчёт из долларов (в пределах 1–4 %).
  `detailLevel`: `full` — полная запись, `basic` — короче; что пусто — в `missingFields`. `stockCapped` — `true`, если у какого-то варианта
  ровно 200 (чаще всего показывают не больше) и ни у одного нет больше: тогда `totalStock` — не меньше этого.
- **Перевод, цена в другой валюте и ссылки байеров — без доплаты.**
- **Не нужны ни аккаунт Taobao, ни cookies, ни свои прокси.**

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

1. Положите в **Товары** ссылки, номера, тексты «Поделиться» или ссылки байеров — по одной на строку, до 1000 за запуск.
2. Включите **Отзывы** и **Вопросы покупателей (问大家)**, если нужны, и задайте, сколько на товар: до 1000 отзывов (больше Taobao не
   показывает) и до 100 вопросов.
3. Выберите **Перевести на** (английский, русский, испанский, португальский, немецкий, французский или польский) и **Цена ещё и в** (USD, EUR, RUB, GBP, PLN, UAH, KZT, BRL, CAD или AUD).
4. Запустите. Строки появятся в датасете; виды `Products`, `Variants`, `Reviews`, `Buyer Q&A` и `Agent links` показывают их
   таблицами. Итоги запуска (`OUTPUT`) — сколько товаров, отзывов и вопросов, строки по статусам и почему запуск остановился
   (`stopReason`).

#### Примеры

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

#### Цена

| Событие | Цена | За что |
|---|---|---|
| `product` | $0,00764 ($7,64 за 1000) | строка товара с данными |
| `review` | $0,0039 ($3,90 за 1000) | строка отзыва, с «Отзывы» |
| `question` | $0,0068 ($6,80 за 1000) | строка вопроса покупателя, с «Вопросы покупателей» |
| Запуск | $0,0077 | раз на запуск |

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

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

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

- `couponPrice` и `soldCount` часто пустые: цена после купона зависит от покупателя, а продажи Taobao показывает не у всех товаров.
- Персональных цен (88VIP, 百亿补贴, 淘金币) нет: они зависят от аккаунта покупателя.
- Товар может прийти полной (`full`) или краткой (`basic`) записью, а цена — со страницы (`page`) или пересчётом (`converted`): и то,
  и другое отмечено в строке.
- Остаток варианта часто показывают лишь до 200 (см. `stockCapped`), а отзывов у товара можно прочитать не больше 1000.
- У вопроса — один ответ; сколько их на Taobao, говорит `answerCount`.
- С «Отзывы» `reviewsComplete` — `false`, если отзывов пришло меньше, чем просили, а у товара есть ещё, или не хватило лимита трат;
  сводка описывает то, что прочитано.
- `unavailable` — товар без данных в этот раз: он закрыт или требует входа, либо его больше нет (опечатка в номере или снятый товар
  часто приходят так; `not_found` — товар, которого, по словам Taobao, нет). Такие строки бесплатны. Если десять товаров подряд
  пришли `unavailable`, запуск останавливается с сообщением «попробуйте позже»; закрытые товары в счёт не идут, а запуск, где
  закрыты все товары, кончается сообщением об этом.
- Если Apify переносит или перезапускает запуск, он продолжает с того места, где остановился: уже сделанные товары не читаются,
  не пишутся и не списываются второй раз.
- Большой список идёт часами: строки пишутся в датасет по мере готовности, а таймаут запуска по умолчанию — 24 часа.
- `stopReason` в `OUTPUT`: `null` (дошли до конца), `spending_limit`, `source_unavailable` (сейчас нет данных), `actor_error`
  (ошибка самого актора), `aborted` (запуск остановили), `free_limit` (бесплатный тариф Apify не пустил запуск) или `unfinished`
  (оборван, например таймаутом, или ещё идёт); счётчики — то, что сделано к этому моменту.

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

Taobao:

- [Поиск и магазины Taobao](https://apify.com/theshark/taobao-search-shop-scraper) — поиск по 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

## `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 read 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 и другие). Один товар, данный дважды, читается один раз.

## `include_reviews` (type: `boolean`):

Add the newest buyer reviews of each product as rows of their own: rating, text, the variant bought, photos, follow-up review. Buyers' names and avatars are never included. The product row gets a review summary: rating counts, share with photos, reviews in the last 30 days and the variants bought most often.<br><br>Добавить новые отзывы о каждом товаре отдельными строками: оценка, текст, купленный вариант, фото, дополнение к отзыву. Имён и аватаров покупателей нет никогда. В строке товара — сводка: сколько каких оценок, доля с фото, отзывы за 30 дней и какие варианты покупают чаще.

## `max_reviews` (type: `integer`):

How many of the newest reviews to take per product, up to 1,000 (Taobao shows no more). You pay per review row.<br><br>Сколько новых отзывов брать на товар, до 1000 (больше Taobao не показывает). Платите за строку отзыва.

## `include_questions` (type: `boolean`):

Add the buyers' questions about each product with an answer as rows of their own. Who asked and who answered is not included.<br><br>Добавить вопросы покупателей о каждом товаре с ответом отдельными строками. Кто спросил и кто ответил — не выводится.

## `max_questions` (type: `integer`):

How many questions to take per product, up to 100. You pay per question row.<br><br>Сколько вопросов брать на товар, до 100. Платите за строку вопроса.

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

Translate titles, variant names, attributes, reviews and questions. The Chinese original stays next to the translation. Text 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
{
  "items": [
    "582890145005",
    "1078907312106"
  ],
  "include_reviews": false,
  "max_reviews": 20,
  "include_questions": false,
  "max_questions": 10,
  "translate_to": "en",
  "currency": "USD",
  "output_language": "en"
}
```

# Actor output Schema

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

A row per product and, when asked, a row per review and per question. Строка на товар и, если просили, строка на отзыв и на вопрос.

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

How many products, reviews and questions, 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"
    ],
    "translate_to": "en",
    "currency": "USD"
};

// Run the Actor and wait for it to finish
const run = await client.actor("theshark/taobao-item-details").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",
    ],
    "translate_to": "en",
    "currency": "USD",
}

# Run the Actor and wait for it to finish
run = client.actor("theshark/taobao-item-details").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"
  ],
  "translate_to": "en",
  "currency": "USD"
}' |
apify call theshark/taobao-item-details --silent --output-dataset

```

## MCP server setup

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

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/8eu2NVS39bnQkGcqQ/builds/ysTfvwWxg1aUxhRvq/openapi.json
