Taobao Tmall 淘宝 Product Scraper - Prices, SKUs, Reviews avatar

Taobao Tmall 淘宝 Product Scraper - Prices, SKUs, Reviews

Pricing

from $3.99 / 1,000 products

Go to Apify Store
Taobao Tmall 淘宝 Product Scraper - Prices, SKUs, Reviews

Taobao Tmall 淘宝 Product Scraper - Prices, SKUs, Reviews

Extract Taobao (淘宝) and Tmall (天猫) prices, SKUs, reviews, shop data, images, and attributes by keyword. Supports Chinese searches like 女装, 口红, 手机壳; exports JSON, CSV, and Excel.

Pricing

from $3.99 / 1,000 products

Rating

4.7

(3)

Developer

Zen Studio

Zen Studio

Maintained by Community

Actor stats

5

Bookmarked

6.1K

Total users

924

Monthly active users

21 hours

Issues response

2 hours ago

Last modified

Features

Limited permissions

Share

Taobao 淘宝 Product Scraper - Prices, SKUs & Reviews (2026)

Every Taobao variant: current price, list price, stock and sold out. 现价 · 原价 · 库存 · 售罄. Artwork based on the Taobao app's variant selector.

From Zen Studio, creators of 1688 Products and Taobao Product Detail, with 130,000+ combined lifetime runs.

Why choose this actor? 为什么选择

  • Every variant priced 每个规格的价格. Each variant comes with its own current price, plus its list price when it is discounted. Not just the lowest price shown in search results.
  • Stock and sold out, per variant 库存与售罄. See the remaining stock of each variant and which ones are sold out, so you know what can actually be ordered.
  • The listing around it 店铺与销量. Every row also carries the sales band, shop name, seller level and store scores, plus photos, specs and ship-from city with details on.

Search Taobao →

Try it 快速试用

Open the actor's input page, switch to JSON and paste this. Then start the run.

{
"keyword": "iphone 17 钢化膜",
"maxItems": 10,
"enrichWithDetails": true
}

Variant prices and stock come with Detail enrichment (enrichWithDetails), which is on by default and billed as a separate add-on per product. Taobao shows stock up to 200 per variant; a variant at 0 is sold out. Free trial runs enrich the first product only.

Need the checked current price and the coupon price (券后价)? Add "verifiedPrice": true as well. See Verified price below.

Copy to your AI assistant

zen-studio/taobao-search-scraper on Apify. Searches Taobao by keyword and returns one product row per result with itemId, title, titleOriginal, url, CNY price fields, enriched SKU matrix, attributes, shop object, category IDs, gallery media, product metadata, search metadata, and optional nested customer reviews. Call ApifyClient("TOKEN").actor("zen-studio/taobao-search-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items. Required: keyword. Optional: maxItems, sort (relevance, sales, highest_price), tmallOnly, enrichWithDetails, verifiedPrice (checked price and coupon price per row, needs enrichWithDetails, not with tmallOnly, adds miId), fetchReviews, maxReviewsPerItem, minPrice, maxPrice. Already have item IDs or product URLs? Use zen-studio/taobao-detail-scraper instead: pass them as items (up to 1,000 per run) for the same SKU matrix, attributes, shop and media fields, with no keyword search. PPE: product $5.99/1k, detail add-on $9.99/1k from 19 August 2026 ($5.99/1k until then), review add-on $4.99/1k before Store discounts. Free tier: 5 lifetime runs, 1 page of results, detail enrichment on the first product only, no customer reviews. Token: https://console.apify.com/account/integrations To reach the maintainers, add feedback="<what you needed and did not get>" to any run, including one that worked: feature requests, a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. The run returns its data exactly as it would without the note, and a human reads every note.

Zen Studio · China Scrapers

Taobao: You are here 1688: Wholesale JD.com: Prices and reviews Goofish Items: Resale listings Dewu: Sneaker resale

How to Search Taobao

Use English or Chinese product keywords. Common searches include 女装, 口红, 手机壳, 机械键盘, 连衣裙, 淘宝商品, and Tmall brand terms.

Basic - enriched products

{
"keyword": "iphone 15",
"maxItems": 20
}

Search-only rows

{
"keyword": "机械键盘",
"maxItems": 50,
"enrichWithDetails": false
}

Highest-price products with reviews

{
"keyword": "女装",
"maxItems": 10,
"sort": "highest_price",
"fetchReviews": true,
"maxReviewsPerItem": 20
}

Price range filter

{
"keyword": "iphone 15",
"maxItems": 50,
"minPrice": 3000,
"maxPrice": 10000,
"sort": "sales"
}

Input Parameters

ParameterTypeDefaultDescription
keywordstringrequiredTaobao search keyword. Chinese and English terms work.
maxItemsinteger100Maximum products to return, 10 to 1000. A value below 10 is rejected before the run starts. Test runs are capped at 5 products; free-tier runs return one page of results.
sortstringrelevancerelevance, sales, or highest_price. Low-price sorting is not available.
tmallOnlybooleanfalseReturn only Tmall listings.
enrichWithDetailsbooleantrueAdds SKU matrix, attributes, shop metadata, media (images, description gallery, video), stock, sales, and category data.
verifiedPricebooleanfalseAdds the checked current price and, when Taobao shows one, the coupon price. Works only with enrichWithDetails; not available with tmallOnly. See Verified price.
fetchReviewsbooleanfalseAdds nested customer reviews. Reviews are billed separately.
maxReviewsPerIteminteger100Maximum reviews per product when fetchReviews is enabled.
minPrice / maxPriceintegerblankOptional price range in Chinese yuan.

One dataset row represents one Taobao product.

  • Product identity: itemId, title, titleOriginal, product URL, category IDs, search rank, scrape timestamp.
  • Pricing and stock: CNY price, originalPrice, couponPrice (price after public shop and official promotions, at product and SKU level), search-side price fields, SKU-level price fields, stock, sales signals. priceVerified: true and couponPrice come with verifiedPrice; without it, enriched rows currently carry priceVerified: false and no coupon price.
  • Shop ratings: seller level, positive rate sellerGoodrat (percent), and the three store scores out of 5: miaoshuDsr (description), fuwuDsr (service), fahuoDsr (shipping).
  • SKU matrix: SKU ID, quantity, sales count, configurator IDs, and per-SKU CNY price details.
  • Attributes, shop, and media: translated and original attributes, per-variant swatch images (propsImages), shop object, primary image, gallery images, description HTML, product metadata.
  • Optional reviews: nested customer review objects with content, dates, photos, user profile, rating, append list, and seller reply fields when returned.

Output Example

One enriched product. All top-level fields are shown; large arrays (SKUs, pictures, description images) are cropped to a few representative entries. Fields such as video, titleEn, relatedItems, and shopItems are populated when the product provides them. title and titleOriginal carry the Chinese title shown in Taobao search results; titleEn is filled when Taobao provides an English title. discountRate is the discounted price as a percentage of the search price (100.0 means no discount). Counts and ratings Taobao does not provide are null. isTmall is set on every row, enriched or not: true for Tmall listings, false for Taobao stores. Tmall rows link to their detail.tmall.com page, Taobao rows to item.taobao.com. Runs with verifiedPrice differ in a few fields; see Verified price.

{
"itemId": "1003783113480",
"url": "https://item.taobao.com/item.htm?id=1003783113480",
"title": "苹果iphone15国行双卡苹果13苹果14苹果15正品iphone14现货5G手机",
"titleOriginal": "苹果iphone15国行双卡苹果13苹果14苹果15正品iphone14现货5G手机",
"titleEn": null,
"isTmall": false,
"priceCurrency": "CNY",
"price": "3019.00",
"originalPrice": "3019.00",
"couponPrice": null,
"suggestivePrice": "0.00",
"totalPrice": "0.00",
"priceFromSearch": "2339.00",
"discountedPriceFromSearch": "2339.00",
"discountRate": 100.0,
"discountType": "优惠价",
"isPromotion": false,
"hasDiscount": false,
"promoType": null,
"brandName": "Apple/苹果",
"brandId": null,
"categoryId": "1512",
"rootCategoryId": null,
"categoryCrumbs": [],
"stock": 5000,
"minOrderQuantity": 0,
"sales": 2000,
"totalSold": 2000,
"favCount": null,
"fansCount": null,
"salesSignal": "1000+",
"frontStock": 32846,
"skuCount": 25,
"skus": [
{
"skuId": "5993905756218",
"price": "3119.00",
"originalPrice": "3451.00",
"couponPrice": null,
"quantity": 200,
"propsIds": "1627207:28323;5919063:3266779;12304035:3222910;122216431:27772",
"propsNames": "1627207:28323:机身颜色:粉色;5919063:3266779:套餐类型:套餐一 国行苹果15;12304035:3222910:储存容量:128GB;122216431:27772:版本类型:中国大陆"
},
{
"skuId": "5993905756219",
"price": "3548.00",
"originalPrice": "3880.00",
"couponPrice": null,
"quantity": 200,
"propsIds": "1627207:28323;5919063:3266781;12304035:3222910;122216431:27772",
"propsNames": "1627207:28323:机身颜色:粉色;5919063:3266781:套餐类型:套餐二 国行15Plus;12304035:3222910:储存容量:128GB;122216431:27772:版本类型:中国大陆"
},
{
"skuId": "5993905756220",
"price": "3778.00",
"originalPrice": "4110.00",
"couponPrice": null,
"quantity": 200,
"propsIds": "1627207:28323;5919063:3266779;12304035:11835346;122216431:27772",
"propsNames": "1627207:28323:机身颜色:粉色;5919063:3266779:套餐类型:套餐一 国行苹果15;12304035:11835346:储存容量:256GB;122216431:27772:版本类型:中国大陆"
}
],
"attributes": [
{
"name": "上市时间",
"value": "2023-09"
},
{
"name": "售后服务",
"value": "店铺保修"
},
{
"name": "是否支持无线充电",
"value": "是"
},
{
"name": "耳机插头类型",
"value": "TYPE-C"
},
{
"name": "操作系统",
"value": "iOS"
},
{
"name": "套餐类型",
"value": "套餐二,套餐一"
},
{
"name": "前置摄像头像素",
"value": "1200万像素"
},
{
"name": "电池容量",
"value": "4383mAh"
}
],
"propsList": {
"1627207:28323": "机身颜色:粉色",
"1627207:28335": "机身颜色:绿色",
"1627207:28338": "机身颜色:蓝色",
"1627207:28324": "机身颜色:黄色",
"1627207:28341": "机身颜色:黑色"
},
"propsImages": {
"1627207:28323": "https://img.alicdn.com/imgextra/i3/87764758/O1CN01NgwUJr1l1DZlFCoYW_!!87764758.jpg",
"1627207:28335": "https://img.alicdn.com/imgextra/i2/87764758/O1CN01BFNp6N1l1DZj8rAOV_!!87764758.jpg",
"1627207:28338": "https://img.alicdn.com/imgextra/i3/87764758/O1CN01HRGkFZ1l1DZjaeqkJ_!!87764758.jpg",
"1627207:28324": "https://img.alicdn.com/imgextra/i4/87764758/O1CN01RG9EcP1l1DZk9X7se_!!87764758.jpg",
"1627207:28341": "https://img.alicdn.com/imgextra/i2/87764758/O1CN01AI83Jr1l1DZkSHq8i_!!87764758.jpg"
},
"propertyAlias": null,
"mainPictureUrl": "https://img.alicdn.com/imgextra/i3/87764758/O1CN01z2rrXR1l1DanAnCmV_!!87764758.jpg",
"pictures": [
"https://img.alicdn.com/imgextra/i3/87764758/O1CN01z2rrXR1l1DanAnCmV_!!87764758.jpg",
"https://img.alicdn.com/imgextra/i3/87764758/O1CN01HRGkFZ1l1DZjaeqkJ_!!87764758.jpg",
"https://img.alicdn.com/imgextra/i2/87764758/O1CN01AI83Jr1l1DZkSHq8i_!!87764758.jpg"
],
"descriptionImages": [
"https://img.alicdn.com/imgextra/i3/87764758/O1CN012zfaT01l1DZWFrD47_!!87764758.jpg",
"https://img.alicdn.com/imgextra/i2/87764758/O1CN01PuyimG1l1DSk5epig_!!87764758.jpg",
"https://img.alicdn.com/imgextra/i3/87764758/O1CN01O05tqU1l1DGgPuXqA_!!87764758.jpg"
],
"video": null,
"descriptionHtml": "<img align =\"absmiddle\" src=\"//img.alicdn.com/imgextra/i3/87764758/O1CN012zfaT01l1DZWFrD47_!!87764758.jpg\" ><img align =…",
"descriptionShort": null,
"shop": {
"shopIdFromSearch": "2235234680",
"shopNameFromSearch": "乐淘数码通讯",
"shopId": "35384276",
"sellerId": "87764758",
"shopName": "优信数码科技",
"sellerNick": "优信数码科技",
"shopUrl": "https://shop35384276.taobao.com/"
},
"location": "安徽合肥",
"postFee": null,
"expressFee": null,
"emsFee": null,
"freight": null,
"shippingTo": null,
"itemWeight": null,
"itemSize": null,
"isVirtual": false,
"sampleId": null,
"createdTime": null,
"modifiedTime": null,
"delistTime": null,
"relatedItems": [],
"shopItems": [],
"sellerLevel": 12,
"sellerGoodrat": 99.86,
"fahuoDsr": 4.94,
"fuwuDsr": 4.94,
"miaoshuDsr": 4.94,
"sellerLoc": null,
"provEn": null,
"cityEn": null,
"commentCount": null,
"itemGradeAvg": null,
"search": {
"cityEn": "",
"commentCount": "",
"discntPriceYuan": 2339.0,
"discntRate": 10000,
"discntType": "优惠价",
"extraMap": {},
"fahuoDsr": "494",
"frontStock": 32846,
"fuwuDsr": "494",
"hasTongkuan": false,
"hasXiangsi": false,
"itemGradeAvg": 0.0,
"itemId": 996313754846,
"itemLoc": "广东 深圳",
"itemName": "苹果iphone15国行双卡苹果13苹果14苹果15正品iphone14现货5G手机",
"itemNameEn": "",
"itemSubName": "",
"itemSubNameEn": "",
"itemType": "b",
"miaoshuDsr": "494",
"options": 17716740096,
"orderPayUV": "1000+",
"picUrl": "i1/2235234680/O1CN01kR3e9L1kRUhT5iDws_!!2235234680.jpg",
"picUrlFull": "https://g.search.alicdn.com/img/bao/uploaded/i4/i1/2235234680/O1CN01kR3e9L1kRUhT5iDws_!!2235234680.jpg",
"picUrlList": [
"i3/2235234680/O1CN01AenYSI1kRUhTbEfKX_!!2235234680.jpg",
"i1/2235234680/O1CN01vO2EUH1kRUhTIPrRS_!!2235234680.jpg",
"i1/2235234680/O1CN01942RzJ1kRUh7PbctF_!!2235234680.jpg",
"i3/2235234680/O1CN01acZo3q1kRUh6lu4Dj_!!2235234680.jpg"
],
"priceFen": 233900,
"priceYuanDouble": 2339.0,
"priceZKFen": 233900,
"priceZKYuanDouble": 2339.0,
"prodId": 604031738,
"provEn": "",
"sellerGoodrat": 9986,
"sellerLevel": 12,
"sellerLoc": "",
"serviceList": [],
"shopId": 2235234680,
"shopName": "乐淘数码通讯",
"spuId": 0,
"tagList": [],
"tmcTagList": [
"47108",
"47669",
"47888",
"47349",
"47333",
"48302",
"48104",
"48301",
"100047888",
"100047333",
"100047669",
"100047108",
"100047349",
"100048301",
"100048302",
"100048104",
"100048296",
"48296"
],
"userTag": 1170936092094906372,
"userType": 0,
"vidname": ""
},
"searchKeyword": "iphone 15",
"searchSort": "relevance",
"searchRank": 1,
"scrapedAt": "2026-07-18T00:00:00Z",
"reviews": null,
"_reviewsFetched": false,
"_reviewsCount": 0,
"priceVerified": false,
"_detailEnriched": true
}

Verified price 核实价格

Add "verifiedPrice": true together with "enrichWithDetails": true:

{
"keyword": "保温杯",
"maxItems": 20,
"enrichWithDetails": true,
"verifiedPrice": true
}
Without verifiedPriceWith verifiedPrice
price on enriched rowscurrent price, not checked (priceVerified: false)checked current price (priceVerified: true)
couponPrice / skus[].couponPricenot returnedreturned when Taobao shows one
miIdnot presentTaobao's product token, valid for about 90 days
urlitem.htm?id=<itemId>item.htm?id=<itemId>&mi_id=<miId>, or id=0&mi_id=<miId> when the item ID is unknown
itemIdalways setset when the product is matched to its item ID, otherwise null
Store scores (fahuoDsr, fuwuDsr, miaoshuDsr), sellerLevel, sellerGoodrat, salesSignal, searchfilled from search resultsempty
isTmallset on every rowset on rows with details, otherwise null
Chargessearch-result + detail-enrichment per enriched rowthe same; a row without details is charged search-result only

Most rows get full details. A product that cannot be matched to its item ID keeps its checked price and miId, has no details (_detailEnriched: false) and is not charged for detail enrichment. A row whose price could not be checked says so with priceVerified: false, and free trial runs check the first product only. Pass its url to Taobao Product Detail to get its variants and images.

The product list and its order can differ from a run without the option. verifiedPrice is not available together with tmallOnly: such a run returns standard results and says so in its log. It has no effect without enrichWithDetails. Reviews work as usual on rows that have an itemId.

Pricing

This Actor uses pay-per-event pricing. You pay for the data level you request. Apify Store discounts may lower these unit prices.

OutputEventBase price
Product rowsearch-result$5.99 / 1,000 products
Detail enrichment add-ondetail-enrichment$9.99 / 1,000 products (from 19 August 2026, $5.99 until then)
Customer review add-onreview$4.99 / 1,000 reviews

The default run is enriched products without reviews: product row + detail enrichment. Turn off enrichWithDetails for cheaper search-only discovery. Turn on fetchReviews only when review content matters.

Notes on Filters

Taobao search currently supports relevance, sales, and high-price sorting, plus Tmall-only filtering and CNY price range filtering. Low-price sorting is not exposed because live tests returned empty pages across multiple keywords. Shop ID and language inputs are not supported by this actor.

FAQ

Can I search in Chinese?

Yes. Use Chinese keywords such as 女装, 机械键盘, or 手机壳.

Can I search in English?

Yes. English brand and product keywords such as iphone 15, huawei, and keyboard work.

What is the difference between search-only and enriched output?

Search-only rows include product identity, title, URL, basic price, image, seller name, and search metadata.

Enriched rows add the SKU matrix, attributes, shop identity, category, media arrays, stock, sales, product metadata, and couponPrice.

What is couponPrice (券后价)?

The price after public promotions that any buyer receives: 满减, 满折, 官方立减, 官方立折, shop coupons, and product coupons. Most products show it per SKU, in skus[].couponPrice; couponPrice on the row itself is filled when Taobao shows one price for the whole product.

Turn on verifiedPrice to get it. Without that option, enriched rows currently carry no coupon price and priceVerified: false.

It is a best-effort field. An empty couponPrice means no public promotion was detected for that product, which is not the same as the product having none. Detection is strongest on shop coupons and 立减 promotions and weakest on threshold promotions (满减) in high-value categories such as electronics. Treat a present value as reliable and an absent one as unknown.

Prices that depend on your own account are never included, because they differ per buyer: 88VIP, 百亿补贴, 淘金币 balances, and platform subsidy (平台加补) pricing.

Are reviews included by default?

No. Reviews are optional because they add separate per-review billing.

What happens if a product detail is unavailable?

The Actor returns a partial search row with _detailEnriched: false. You are not charged for detail enrichment on that row. With verifiedPrice, such a row still carries its checked price when one was found.

Does maxItems always return exactly that number?

The Actor returns up to maxItems. Actual count depends on how many matching products Taobao returns for the keyword and filters.

maxItems accepts 10 to 1000; a value below 10 is rejected before the run starts. Apify TEST-origin runs are capped at 5 products.

What currency are prices in?

Prices are returned in Chinese yuan (CNY) as decimal strings, for example "3019.00".

How does the free tier work?

Free-tier users get 5 lifetime runs. Each run returns one page of results and enriches the first product with full detail. Customer reviews are included on paid plans.

Why do some optional fields return null or empty arrays?

Taobao does not expose every field for every product. Empty top-level fields remain stable in the dataset schema, but the README example uses a populated real fixture and trims arrays only for readability.

Where can I check China resale prices for sneakers and streetwear?

On Dewu (得物), the marketplace sold abroad as POIZON. Dewu POIZON Scraper returns Dewu's live lowest and highest ask in CNY, every size it lists and buyer reviews. Search it by keyword or style code (货号).

More Zen Studio scrapers for Chinese platforms

🛒 E-commerce

🎬 Short-video & social

🏠 Real estate & autos

✈️ Travel & stays

🧭 Travel & maps

🔍 Search engines

Support

Open an issue on the Actor page if a keyword consistently returns empty results, if a field changes type, or if a filter behaves differently than expected.

For reproducible support, include the input JSON and the run ID.