Taobao 淘宝 Seller Catalog Scraper - Store Products, Prices, Sales (2026)

Extract Taobao (淘宝) and Tmall seller catalogs by seller handle, seller ID, product URL, item ID, or seller/shop ID object - one row per product with prices, sales signals, images, category IDs, and shop metadata.

Copy to your AI assistant

zen-studio/taobao-seller-products-scraper on Apify. Extracts Taobao and Tmall seller catalogs and returns one product row per listing with input, inputType, sellerId, shopId, shopName, shopUrl, platform, isTmall, shop metadata, itemId, encodedItemId, url, title, titleOriginal, mainPictureUrl, CNY price fields, priceDetails, shipping flags, area limits, category IDs, comment tags, 30-day sales/order/comment signals, catalog page/rank metadata, and scrapedAt. Call ApifyClient("TOKEN").actor("zen-studio/taobao-seller-products-scraper").call(run_input={"sellers":["laolong998"],"maxItemsPerSeller":100}), then client.dataset(run["defaultDatasetId"]).list_items().items. Required: sellers. Optional: maxItemsPerSeller, sort (recommended, best_selling, newly_listed, lowest_price, highest_price). Sellers can be handles, seller IDs, Taobao/Tmall product URLs, itemId:123, item:123, itemId objects, or sellerId/shopId objects. Bare numeric sellers are seller IDs. Shop URLs alone are not supported. Pricing: $0.05 start fee plus $4.99/1,000 product rows before Store discounts. Free tier: 10 lifetime runs, 20 products/run. Token: https://console.apify.com/account/integrations

Zen Studio China Scrapers   •  Taobao, Tmall, and JD.com commerce data
Seller Catalog ➤ You are here	Taobao Search ↗ Keyword product search	Taobao Detail ↗ Product detail by URL/ID	JD.com ↗ 京东 prices + reviews

How to Extract Seller Catalogs

Put one or more seller locators in sellers.

Accepted formats:

• Seller handle: laolong998
• Seller ID: 20133891
• Taobao product URL: https://item.taobao.com/item.htm?id=14939664094
• Tmall product URL: https://detail.tmall.com/item.htm?id=14939664094
• Item ID prefix: itemId:14939664094 or item:14939664094
• Item ID object: {"itemId": "14939664094"}
• Seller/shop ID object: {"sellerId": "20133891", "shopId": "34033352"}

Bare numeric values are seller IDs. Shop URLs alone are not enough because Taobao and Tmall shop URLs expose the shop ID but not the seller ID required to list products.

Seller handle

{
  "sellers": ["laolong998"],
  "maxItemsPerSeller": 100
}

Seller and shop IDs

{
  "sellers": [{"sellerId": "20133891", "shopId": "34033352"}],
  "sort": "best_selling"
}

Product URL to find the seller

{
  "sellers": [
    "https://item.taobao.com/item.htm?id=14939664094",
    "https://detail.tmall.com/item.htm?id=14939664094"
  ],
  "maxItemsPerSeller": 50
}

Item ID

{
  "sellers": [
    "itemId:14939664094",
    "item:14939664094",
    {"itemId": "14939664094"}
  ],
  "maxItemsPerSeller": 50
}

Input Parameters

Parameter	Type	Default	Description
sellers	array	required	Seller locators to scrape. Supports seller handles, seller IDs, Taobao/Tmall product URLs, item ID prefixes, item ID objects, and objects with both sellerId and shopId. Bare numeric values are treated as seller IDs.
maxItemsPerSeller	integer	100	Maximum product rows to return per seller. Test runs are capped at 5 products per seller; free-tier runs are capped at 20 products.
sort	string	recommended	recommended, best_selling, newly_listed, lowest_price, or highest_price.

What Data Can You Extract from Taobao Seller Catalogs?

One dataset row represents one product in a seller catalog.

• Seller and shop metadata: sellerId, shopId, shopName, shopUrl, platform, isTmall, and the nested shop object.
• Product identity and media: itemId, encodedItemId, product URL, title, original title, main image URL, category IDs, and scrape timestamp.
• Pricing and shipping: priceCurrency, price, discountPrice, full priceDetails, freeShipping, and areaLimit.
• Demand and catalog signals: soldCount30Day, orderCount30Day, orderPayUV, commentCount, commentTags, and catalog page/rank metadata.

Output Example

This is a complete product-row example. Large arrays can be shortened in exports, but this sample keeps the full object shape.

{
  "input": "laolong998",
  "inputType": "seller_handle",
  "sellerId": "20133891",
  "shopId": "34033352",
  "shopName": "喜尚3D眼镜",
  "shopUrl": "https://shop34033352.taobao.com",
  "platform": "Taobao",
  "isTmall": true,
  "shop": {
    "sellerId": "20133891",
    "shopId": "34033352",
    "shopName": "喜尚3D眼镜",
    "shopUrl": "https://shop34033352.taobao.com",
    "pictureUrl": "https://img.alicdn.com/imgextra/i2/TB1Wlhjcjgy_uJjSZK9SutvlFXa.jpg",
    "vendorId": "laolong998",
    "vendorName": "laolong998",
    "vendorDisplayName": "laolong998",
    "location": {},
    "features": ["Tmall", "Expired"],
    "updatedTime": "2025-09-07T10:26:24.003Z",
    "descriptionMatchScore": "4.5",
    "serviceScore": "4.6",
    "deliveryScore": "4.7",
    "credit": {
      "level": 0,
      "score": 0,
      "totalFeedbacks": 0,
      "positiveFeedbacks": 0
    },
    "stats": {
      "allItemCount": "37",
      "fans": "1513",
      "shopFansNum": "1511",
      "years": "14"
    },
    "featuredValues": {
      "userId": "20133891",
      "shopId": "34033352",
      "userScoreItem": "4.63636",
      "userScoreService": "4.63636",
      "userScoreDelivery": "4.63636",
      "TaobaoVendorId": "20133891",
      "itemScoreDif": "15.01",
      "serviceScorePercent": "4.8",
      "taobaoVendorId": "20133891",
      "serviceScoreDif": "-0.1",
      "years": "14",
      "consignmentDif": "-0.45",
      "allItemCount": "37",
      "DeliveryScorePercent": "4.8",
      "starts": "1162999605",
      "ServiceScorePercent": "4.8",
      "ShopId": "34033352",
      "goodRatePercentage": "98.93",
      "ItemScorePercent": "4.8",
      "stars": "13",
      "shopUrl": "https://shop34033352.taobao.com",
      "pageId": "206610216",
      "fans": "1513",
      "shopFansNum": "1511",
      "itemScorePercent": "4.8",
      "deliveryScorePercent": "4.8"
    }
  },
  "itemId": "14939664094",
  "encodedItemId": "RmtJVy9zaExXTE44SGRlY29OYnhudz09",
  "url": "https://item.taobao.com/item.htm?id=14939664094",
  "title": "3D眼镜电影院专用Reald偏光不闪式通用3D眼睛电视近视三d眼镜",
  "titleOriginal": "3D眼镜电影院专用Reald偏光不闪式通用3D眼睛电视近视三d眼镜",
  "mainPictureUrl": "https://img.alicdn.com/i1/20133891/O1CN01F6tpho1ec7dJEbDLE_!!20133891.jpg",
  "priceCurrency": "CNY",
  "price": "5.00",
  "discountPrice": "5.00",
  "priceDetails": {
    "priceFen": 500,
    "discountPriceFen": 500,
    "discountPriceHKD": "5.82",
    "discountPriceTWD": "23.47",
    "discountPriceWorld": "5.00",
    "discountType": null
  },
  "freeShipping": false,
  "areaLimit": false,
  "categoryId": "50018834",
  "rootCategoryId": "28",
  "commentCount": 13,
  "commentTags": [],
  "soldCount30Day": 1,
  "orderCount30Day": 1,
  "orderPayUV": 1,
  "catalog": {
    "sort": "recommended",
    "page": 1,
    "rank": 2,
    "pageSize": 60,
    "totalCount": 34,
    "totalPages": 1
  },
  "scrapedAt": "2026-05-21T07:31:00Z"
}

Pricing

This Actor uses pay-per-event pricing. Apify Store discounts may lower these unit prices.

Output	Base price
Actor start	$0.05 / run
Seller product row	$4.99 / 1,000 products

You pay the start fee once per run, then the product row fee for each seller catalog product saved to the dataset.

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

When a free-tier account has used all lifetime runs, the dataset contains one uncharged row with error, message, and upgradeUrl so API clients can detect the block.

FAQ

Can I use a shop URL?

No. Shop URLs alone are not enough because Taobao shop URLs expose the shop ID but not the seller ID required to list products.

Use a seller handle, seller ID, Taobao/Tmall product URL, item ID, or an object with both sellerId and shopId.

Are bare numeric sellers item IDs?

No. Bare numeric values in sellers are seller IDs.

For item IDs, use itemId:123, item:123, an object such as {"itemId":"123"}, or a product URL.

What sort options are available?

Use recommended, best_selling, newly_listed, lowest_price, or highest_price.

Does maxItemsPerSeller always return exactly that number?

The Actor returns up to maxItemsPerSeller per seller. Actual count depends on how many products Taobao returns for that catalog and sort mode.

How does the free tier work?

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

If those runs are exhausted, the Actor writes one uncharged dataset row with error, message, and upgradeUrl.

Why do some optional fields return null or empty arrays?

Taobao does not expose every field for every product. The dataset schema keeps stable top-level keys so exports remain predictable.

Support

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

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