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

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.

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.

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, fetchReviews, maxReviewsPerItem, minPrice, maxPrice. 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: 10 lifetime runs, 1 page of results, detail enrichment on the first product only. Token: https://console.apify.com/account/integrations

Zen Studio China Scrapers   •  Taobao, JD.com, wholesale, and resale data
Taobao ➤ You are here	1688 Products ↗ Wholesale data	JD.com ↗ 京东 prices + reviews	Goofish Search ↗ Resale listings	Goofish Detail ↗ URL/ID enrich

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

Parameter	Type	Default	Description
keyword	string	required	Taobao search keyword. Chinese and English terms work.
maxItems	integer	100	Maximum products to return. Values below 10 are raised to 10. Test runs are capped at 5 products; free-tier runs return one page of results.
sort	string	relevance	relevance, sales, or highest_price. Low-price sorting is not available.
tmallOnly	boolean	false	Return only Tmall listings.
enrichWithDetails	boolean	true	Adds SKU matrix, attributes, shop metadata, media (images, description gallery, video), stock, sales, and category data.
fetchReviews	boolean	false	Adds nested customer reviews. Reviews are billed separately.
maxReviewsPerItem	integer	100	Maximum reviews per product when fetchReviews is enabled.
minPrice / maxPrice	integer	blank	Optional price range in Chinese yuan.

What Data Can You Extract from Taobao Search?

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 (best-effort price after public shop and official promotions, at product and SKU level), search-side price fields, SKU-level price fields, stock, sales signals.
• 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.

{
  "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
}

Pricing

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

Output	Event	Base price
Product row	search-result	$5.99 / 1,000 products
Detail enrichment add-on	detail-enrichment	$9.99 / 1,000 products (from 19 August 2026, $5.99 until then)
Customer review add-on	review	$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. It is returned at product level and per SKU on enriched rows.

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.

⚠️ As of 2026-08-22 this field is not being returned at all, so every row is currently the "absent" case. The behaviour described above applies when it resumes.

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.

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.

Values below 10 are raised to 10 at runtime, except Apify TEST-origin runs, which remain 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 10 lifetime runs. Each run returns one page of results and enriches the first product with full detail.

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.

More Zen Studio scrapers for Chinese platforms

🛒 E-commerce

• Lazada
  • Lazada Product Scraper
  • Lazada Reviews Scraper
  • Lazada Store Scraper
• Naver Search 네이버 검색
  • Naver Search Scraper
• AliExpress 全球速卖通
  • AliExpress Product Scraper
• Shopee
  • Shopee Product Detail Scraper
  • Shopee Product Reviews Scraper
  • Shopee Product Scraper
• Taobao 淘宝
  • Taobao Product Detail Scraper
  • Taobao Seller Products Scraper
  • Taobao Judicial Auction Scraper
• JD.com 京东
  • JD.com Search Scraper
• 1688 阿里巴巴
  • 1688 Wholesale Scraper
  • Alibaba Scraper
  • 1688 Reviews Scraper
• Weidian 微店
  • Weidian Scraper
• Goofish 闲鱼
  • Goofish (Xianyu) Search Scraper
  • Goofish (Xianyu) Seller Scraper
  • Goofish (Xianyu) Item Detail Scraper
  • Goofish (Xianyu) Item Comments & Q&A Scraper
  • Goofish (Xianyu) Reverse Image Search Scraper
• Coupang 쿠팡
  • Coupang Review Scraper
  • Coupang Search Scraper
  • Coupang Product Detail Scraper
• Naver Shopping 네이버쇼핑
  • Naver Shopping Scraper
  • Naver Shopping Product Detail Scraper
  • Naver Shopping Review Scraper

🎬 Short-video & social

• Douban 豆瓣
  • Douban Reviews Scraper
• Zhihu 知乎
  • Zhihu Scraper
• Weibo 微博
  • Weibo Search Scraper
  • Weibo Comments Scraper
• Kwai (Brazil)
  • Kwai Search Scraper
  • Kwai Comments Scraper
• Kuaishou 快手
  • Kuaishou Scraper
• Douyin 抖音
  • Douyin Search Scraper
  • Douyin Profile Scraper
  • Douyin Video Scraper
  • Douyin Comments Scraper
  • Douyin Transcripts Scraper
  • Douyin Creator Rankings Scraper
  • Douyin Live Recorder
  • Douyin Hot Search Scraper
  • Douyin Product Search Scraper
  • Douyin User Search Scraper
• RedNote 小红书
  • RedNote User Profile Scraper
  • RedNote Search Scraper
  • RedNote Comments Scraper
  • RedNote Product Search Scraper
  • RedNote Note Detail Scraper
  • RedNote Product Reviews Scraper
  • RedNote Live Recorder
• Xigua 西瓜视频
  • Xigua Video Search Scraper
  • Xigua Video Detail Scraper
• Bilibili 哔哩哔哩
  • Bilibili Video Scraper
  • Bilibili Danmaku Scraper
• Naver Blog & Cafe 네이버 블로그·카페
  • Naver Blog & Cafe Scraper

🏠 Real estate & autos

• Naver 부동산
  • Naver Real Estate Scraper
• Anjuke 安居客
  • Anjuke For-Sale Listings Scraper
  • Anjuke New-Home Scraper
  • Anjuke Rental Listings Scraper
  • Anjuke Listing Detail Scraper
• 58.com 58同城
  • 58.com Real Estate Scraper
• Autohome 汽车之家
  • Autohome (Che168) Used-Car Scraper

✈️ Travel & stays

• Ctrip 携程
  • Ctrip Hotel Prices Scraper
  • Ctrip Hotel Reviews Scraper

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.