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.

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 and USD price fields, enriched SKU matrix, attributes, promotions, shop object, category IDs, gallery media, videos, related recommendation groups, 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, 20 products/run. 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. API values below 10 are raised to 10. Test runs are capped at 5 products; free-tier runs are capped at 20 products.
sort	string	relevance	relevance, sales, or highest_price. Low-price sorting is not exposed because the backend currently returns empty pages for that mode.
tmallOnly	boolean	false	Return only Tmall listings.
enrichWithDetails	boolean	true	Adds SKU matrix, attributes, promotions, shop metadata, media, converted prices, and product detail fields.
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, priceUSD, full priceDetails, search-side price fields, SKU-level price objects, stock, sales signals.
• SKU matrix: SKU ID, quantity, sales count, configurator IDs, and per-SKU CNY/USD price details.
• Attributes, shop, promotions, and media: translated and original attributes, promotion prices, shop object, primary image, gallery image sizes and dimensions, description HTML, product metadata, category root path.
• Optional reviews: nested customer review objects with content, dates, photos, user profile, rating, append list, and seller reply fields when returned.

Output Example

Arrays are trimmed for readability. Optional null or empty fields are omitted here. 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/苹果 Apple, iphone 15, iPhone 15, iPhone 15, iPhone 15, mobile phone, 15 plus, 15promax",
  "titleOriginal": "Apple/苹果 iPhone 15 Plus 苹果15 苹果15ProMax国行 苹果15手机",
  "titleEnFromSearch": null,
  "priceCurrency": "CNY",
  "price": "3099.00",
  "priceUSD": "456.00",
  "priceDetails": {
    "originalPrice": "3099.00",
    "convertedPriceWithoutSign": "456.00",
    "convertedPriceList": {
      "internal": {"price": "3099.00", "code": "CNY"},
      "displayedMoneys": [{"price": "456.00", "code": "USD"}]
    },
    "priceWithoutDelivery": {"originalPrice": "3099.00"},
    "oneItemPriceWithoutDelivery": {"originalPrice": "3099.00"}
  },
  "priceFromSearch": "2339.00",
  "discountedPriceFromSearch": "2339.00",
  "deliveryPrice": "0.00",
  "brandName": "Apple/苹果",
  "skuCount": 30,
  "skus": [
    {
      "skuId": "ot-s-1003783113480-1",
      "quantity": 0,
      "salesCount": 0,
      "configurators": [
        {"pid": "1627207", "vid": "28323"},
        {"pid": "12304035", "vid": "25484125"}
      ],
      "price": {
        "originalPrice": "3099.00",
        "convertedPriceWithoutSign": "456.00",
        "currencyName": "USD",
        "deliveryPrice": "0.00"
      }
    }
  ],
  "attributes": [
    {
      "pid": "上市时间",
      "vid": "2023-09",
      "name": "Time to market",
      "value": "2023-09",
      "originalName": "上市时间",
      "originalValue": "2023-09",
      "isConfigurator": false
    },
    {
      "pid": "售后服务",
      "vid": "店铺保修",
      "name": "After -sales service",
      "value": "Shop warranty",
      "originalName": "售后服务",
      "originalValue": "店铺保修",
      "isConfigurator": false
    }
  ],
  "promotions": [
    {
      "id": "ot-d-promotion-1003783113480",
      "name": "Promotion",
      "price": {
        "originalPrice": "3099.00",
        "convertedPriceWithoutSign": "456.00"
      },
      "configuredItems": [
        {
          "skuId": "5993905756232",
          "price": {
            "originalPrice": "5179.00",
            "convertedPriceWithoutSign": "762.00"
          }
        }
      ]
    }
  ],
  "shop": {
    "shopIdFromSearch": "2235234680",
    "shopNameFromSearch": "乐淘数码通讯",
    "vendorName": "优信数码科技",
    "vendorDisplayName": "优信数码科技",
    "shopId": "35384276",
    "taobaoVendorId": "87764758",
    "shopUrl": "https://shop35384276.taobao.com/",
    "featuredValues": {
      "userScoreDelivery": "4.93837",
      "userScoreItem": "4.93539",
      "userScoreService": "4.95527"
    }
  },
  "mainPictureUrl": "https://img.alicdn.com/imgextra/i3/87764758/...",
  "pictures": [
    {
      "url": "https://img.alicdn.com/imgextra/i3/87764758/...",
      "small": "https://img.alicdn.com/imgextra/i3/87764758/..._100x100q90.jpg",
      "smallWidth": 100,
      "smallHeight": 100,
      "medium": "https://img.alicdn.com/imgextra/i3/87764758/..._310x310q90.jpg",
      "mediumWidth": 310,
      "mediumHeight": 310,
      "large": "https://img.alicdn.com/imgextra/i3/87764758/..._600x600q90.jpg",
      "largeWidth": 600,
      "largeHeight": 600,
      "isMain": true
    }
  ],
  "videos": [
    {
      "url": "https://cloud.video.taobao.com/play/...",
      "previewUrl": "https://img.alicdn.com/..."
    }
  ],
  "ulandItemUrl": "https://uland.taobao.com/item/edetail?id=...",
  "relatedGroups": [
    {
      "type": "Recommendations",
      "displayName": "Recommended items",
      "items": [
        {
          "itemId": "882583316506",
          "url": "https://item.taobao.com/item.htm?id=882583316506",
          "title": "Turas three-in-one power bank...",
          "titleOriginal": "图拉斯三合一随心充...",
          "priceCNY": "448.00",
          "priceUSD": "66.00"
        }
      ]
    }
  ],
  "descriptionHtml": "<!DOCTYPE html>...",
  "weightInfo": {
    "type": "Default",
    "displayName": "Approx weight",
    "weight": 0
  },
  "categoryId": "otc-101413",
  "externalCategoryId": "1512",
  "rootPath": {
    "Content": [
      {"Id": "otc-101413", "ExternalId": "1512"}
    ]
  },
  "isSellAllowed": false,
  "features": ["FakeQuantity", "Expired"],
  "featuredValues": {"TotalSales": "200"},
  "salesSignal": "1000+",
  "frontStock": 32846,
  "search": {
    "itemLoc": "广东 深圳",
    "orderPayUV": "1000+",
    "prodId": 604031738
  },
  "searchKeyword": "iphone 15",
  "searchSort": "relevance",
  "searchRank": 1,
  "scrapedAt": "2026-05-14T09:30:00Z",
  "_detailEnriched": true,
  "_reviewsFetched": true,
  "_reviewsCount": 1,
  "reviews": [
    {
      "date": "2026年05月13日 23:24",
      "content": "评价方未及时做出评价,系统默认好评!",
      "rateId": 1304852821306,
      "user": {
        "nick": "g***2",
        "vipLevel": 6,
        "anony": 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	$5.99 / 1,000 products
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, promotions, shop IDs, category, media arrays, pricing details, and additional product metadata.

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 and _detailError set. 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 "3099.00". When converted pricing is available, priceUSD and SKU-level converted price fields are also included.

How does the free tier work?

Free-tier users get 10 lifetime runs, capped at 20 products per run.

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.

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.