Taobao & Tmall 淘宝 Search & Shops · Поиск и магазины Taobao avatar

Taobao & Tmall 淘宝 Search & Shops · Поиск и магазины Taobao

Pricing

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

Go to Apify Store
Taobao & Tmall 淘宝 Search & Shops · Поиск и магазины Taobao

Taobao & Tmall 淘宝 Search & Shops · Поиск и магазины Taobao

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: цена, фото, продажи при сортировке. Товары магазинов с оценками. Карточки, перевод, валюта, ссылки байеров.

Pricing

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

Rating

0.0

(0)

Developer

TheShark

TheShark

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

0

Monthly active users

4 days ago

Last modified

Features

Limited permissions

Share

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:

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

A search result row, shortened:

{
"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):

{
"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):

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

Pricing

EventPriceWhat 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.0425once 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:

Wildberries:

Other marketplaces:


По-русски

Поиск по 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 — товары Taobao и Tmall по ссылке или номеру: варианты с ценой и остатком, отзывы, вопросы покупателей.
  • Отзывы и вопросы Taobao — отзывы с фото и вопросы покупателей к любому товару: оценка, купленный вариант, сводка по отзывам.
  • Мониторинг цен Taobao — цены и остатки ваших товаров и что изменилось с прошлого запуска.

Wildberries:

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