Pricing

Rating

Developer

Actor stats

Categories

Share

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.

👁 Taobao Seller Catalog Scraper

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":["inman"],"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 shop URLs (shop<id>.taobao.com), Taobao/Tmall product URLs, itemId:123, item:123, itemId objects, or sellerId/shopId objects. Bare numeric sellers are seller IDs. Tmall shop URLs are not supported &mdash; use a product URL from the shop instead. 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

How to Extract Seller Catalogs

Put one or more seller locators in sellers.

Accepted formats:

• Seller handle: inman (or the shop URL https://inman.taobao.com)
• 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. Taobao shop URLs of the form shop<id>.taobao.com are accepted — the seller is extracted automatically. Tmall shop URLs (e.g. uniqlo.tmall.com) are not supported because the seller ID is behind a login wall; use a product URL from the shop instead.

Seller handle

{
"sellers":["inman"],
"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

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":"inman",
"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":"inman",
"vendorName":"inman",
"vendorDisplayName":"inman",
"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.

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?

Taobao shop URLs of the form https://shop<id>.taobao.com are accepted — the seller is extracted automatically from the shop homepage.

Tmall shop URLs (e.g. https://uniqlo.tmall.com) are not supported, because the seller ID is behind a Tmall login wall. For those, use any product URL from the shop, a seller handle, a seller ID, an 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.

More Zen Studio scrapers for Chinese platforms

🛒 E-commerce

• 👁 Image
  Taobao 淘宝
  • Taobao Search Scraper
  • Taobao Product Detail Scraper
• 👁 Image
  JD.com 京东
  • JD.com Search Scraper
• 👁 Image
  1688 阿里巴巴
  • 1688 Wholesale Scraper
• 👁 Image
  Goofish 闲鱼
  • Goofish (Xianyu) Search Scraper
  • Goofish (Xianyu) Seller Scraper

🎬 Short-video & social

• 👁 Image
  Douyin 抖音
  • Douyin Search Scraper
  • Douyin Profile Scraper
  • Douyin Video Scraper
  • Douyin Comments Scraper
  • Douyin Transcripts Scraper
  • Douyin Creator Rankings Scraper
  • Douyin Live Recorder
• 👁 Image
  RedNote 小红书
  • RedNote User Profile Scraper
  • RedNote Search Scraper
  • RedNote Comments Scraper
• 👁 Image
  Xigua 西瓜视频
  • Xigua Video Search Scraper
  • Xigua Video Detail Scraper

🏠 Real estate & autos

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

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.