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

Search Taobao (淘宝) and Tmall by keyword and extract product rows with SKUs, shop data, CNY pricing, images, stock, and optional customer reviews - one row per product in clean structured JSON.

2026-07-18 — Major update Revamped for speed and reliability, now returning richer product data with many new fields. 全面升级：更快、更稳定，返回更丰富的商品数据，新增大量字段。

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 $5.99/1k, 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.
• 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. titleOriginal keeps the Chinese Taobao title; title is the translated detail title when available.

{
  "itemId": "1003783113480",
  "url": "https://item.taobao.com/item.htm?id=1003783113480",
  "title": "Apple/苹果 iPhone 15 Plus 苹果15 苹果15ProMax国行 苹果15手机",
  "titleOriginal": "Apple/苹果 iPhone 15 Plus 苹果15 苹果15ProMax国行 苹果15手机",
  "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": 10000,
  "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": 9986,
  "fahuoDsr": "494",
  "fuwuDsr": "494",
  "miaoshuDsr": "494",
  "sellerLoc": null,
  "provEn": null,
  "cityEn": null,
  "commentCount": "",
  "itemGradeAvg": 0.0,
  "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,
  "_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.

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

• 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
• 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

🎬 Short-video & social

• 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
• 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

🏠 Real estate & autos

• 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

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.