Taobao Scraper 淘宝 & Tmall API – Products, Prices, Sellers

TubeText · E-commerce & travel · Pay per result. No login. Ready for AI agents. All tools

Quick start (no coding)

1. Click Try for free at the top of this page. A free Apify account is enough – it includes monthly credit.
2. In Search keywords, paste Chinese or English keywords, one per line (like 连衣裙 or bluetooth earbuds) – English is translated to Chinese for you.
3. Click Start. Source availability and optional details affect runtime.
4. Open Coverage summary to check complete, partial and stopReason, then export the products to Excel or CSV. A Succeeded run can contain a partial sample or an unavailable input.

Cost: $0.0025 per product – a keyword gives about 40 products (20 main results + 20 top-rated) ≈ $0.10. Product details (seller scores) add $0.003 each.

Common mistakes

• Odd results for an English keyword → check the searchedAs column and try a simpler English word or a Chinese keyword.
• Need seller scores or the review summary → turn on Add product details.
• Want a shop sample → paste its numeric shop link (like shop123456.taobao.com). The public source currently exposes up to 60 products; this does not cover the whole shop.
• Got a no_matches row → your price or shipping filters removed every product; loosen them (this row is free).

Questions or problems? Open an issue (we read every one). Need a custom version? Ask in an issue or email us – we build it as a private Actor on Apify.

Use from Claude, Cursor or any MCP client

Add https://mcp.apify.com?tools=tubetext/taobao-tmall-scraper as a remote MCP server and sign in to Apify (Claude: Settings → Connectors → Add custom connector). Claude Code:

$claude mcp add --transport http tubetext "https://mcp.apify.com?tools=tubetext/taobao-tmall-scraper"

Then ask, for example: "Search Taobao for 'bluetooth earbuds' and list products with CNY price, shop and English title." or "Get the products of this Taobao shop and their seller scores: [link]"

🆓 Free to try: Apify's free plan includes $5 of usage every month, no credit card needed – enough for about 2,000 Taobao products with this tool.

What you get – real output from a test run, shortened. One row per product (Chinese title plus English translation):

Title (English)	Price (CNY)	Chinese title	Shop
Huaqiangbei Pro3 generation Bluetooth headse…	388	华强北Pro3代蓝牙耳机降噪无线2…	深圳華強北正品直銷總店
Patriot Bluetooth headset semi-in-ear 2026 n…	118	爱国者蓝牙耳机半入耳式2026新款…	腔調會員精選旗艦店
[Zhang Linghe limited time gift box] Anker A…	1299	【张凌赫限时礼盒】Anker安克空…	Anker安克官方旗艦店

Taobao API for product and price data

Call it from your back end with the Apify API. One request runs the Actor and returns the rows as JSON:

curl -X POST "https://api.apify.com/v2/acts/tubetext~taobao-tmall-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H 'Content-Type: application/json' -d '{"keywords":["蓝牙耳机"],"maxItemsPerQuery":40,"translateTitles":true}'

• Monitoring: Price tracking: schedule the run with your keywords or shop links and compare CNY prices between runs. Add an Apify webhook to get notified when each run finishes.
• Cost at volume: 100 keywords a day × ~40 products ≈ $10/day at the free-plan price ($0.0025 per product); product details add $0.003 each.
• Compatible output: existing product and price fields are retained. Error/status rows have no product or detail event. Legacy charged means billing eligibility; it is written before charging and is not a payment receipt. See SUMMARY.confirmedEvents and delivery receipts for acknowledgements or uncertainty.
• Why not the official API: Taobao's open platform requires an approved developer app. This needs only an Apify account and returns English titles alongside the Chinese.

What does Taobao & Tmall Scraper do?

Get Taobao and Tmall product data by keyword, category or product URL: full title, price in CNY (plus HKD and TWD), promotion price, shop name and ID, seller scores, ships-from city, category path and images. For cross-border sellers, sourcing agents, dropshippers and market researchers – no login, no cookies, pay per product.

Why use it?

• 🇨🇳 Chinese or English keywords – 连衣裙, 蓝牙耳机, or bluetooth earbuds: English keywords are translated to Chinese automatically (searchedAs shows the Chinese query), because Taobao only matches English words that literally appear in titles
• 🏪 Seller quality with Add product details: description / service / logistics scores, credit level, shop size
• 📍 Ships-from city (e.g. 浙江杭州, 广东广州) and the product-page price
• 🔤 English titles – titleEn is a machine-translated English title, free (turn off with English titles); the Chinese original is always included
• 🔗 Mobile share links and text – accepts supported item links, numeric IDs and m.tb.cn/e.tb.cn share URLs. An expired or app-only share produces an actionable status. Resolving a link does not guarantee that its product detail page is publicly available.
• 🏬 Shop samples – numeric shop links return the public page with shop scores. Check sourceReportedTotal, delivered and stopReason; pagination and whole-shop coverage are not available in this candidate.
• 👍 Public review samples with Add product details: text, rating, date text and SKU description where exposed, plus existing aggregate counts. Buyer names and avatars are omitted. reviewsComplete remains false.
• 💸 $2.50 per 1,000 products, details +$3 per 1,000 at the Free-plan event price. No new event types.

Input

{
  "keywords": ["连衣裙", "蓝牙耳机"],
  "urls": ["https://world.taobao.com/category/50103032.htm", "https://item.taobao.com/item.htm?id=1079130401408"],
  "scrapeDetails": true,
  "maxItemsPerQuery": 40,
  "maxItems": 80,
  "sortBy": "price_asc",
  "minPrice": 50,
  "maxPrice": 500
}

Output

Real output, keyword 连衣裙 with details (2026-10-08):

{
  "status": "ok",
  "input": "连衣裙",
  "rank": 1,
  "itemId": "1079130401408",
  "url": "https://item.taobao.com/item.htm?id=1079130401408",
  "title": "DoggyQin 螞蟻腰/粗棒高克重綿羊毛洋裝女法式毛衣外套毛茸裙褲",
  "titleSimplified": "DoggyQin 蚂蚁腰/粗棒高克重绵羊毛洋装女法式毛衣外套毛茸裙裤",
  "priceCNY": 469,
  "priceHKD": 554.87,
  "priceTWD": 2252.23,
  "detailPriceCNY": 209,
  "freeShipping": false,
  "shopName": "DoggyQin",
  "descriptionMatchScore": 4.78,
  "shopScores": {
    "物流服務": 4.8,
    "服務": 4.8,
    "商品描述": 4.7
  },
  "shopCreditLevel": 18,
  "shopItemCount": 395,
  "shipsFrom": "四川成都",
  "categoryPath": "品牌女裝 > 洋裝 > 氣質洋裝",
  "image": "https://img.alicdn.com/imgextra/i2/2275483160/O1CN01huUiao0q2IJ2vH2e_!!2275483160.jpg",
  "queryTotalResults": 76188
}

priceCNY is the price in the search listing; detailPriceCNY is the price on the product page. They usually match, but can differ (as in this example, ¥469 vs ¥209), so both are kept – check the product page before relying on one.

How much does it cost?

Pay per event:

• $2.50 per 1,000 products (cheaper on higher Apify plans: down to $1.90).
• +$3.00 per 1,000 returned product details at the Free-plan price. Product URLs use the detail event; listings with details use both existing events. Higher-plan prices follow the Actor's pricing panel.
• Removed products, errors and products excluded by filters have no product/detail event. The existing platform Actor-start event still applies. This candidate changes no prices or event definitions.

Limits – read before you run

• About 20–40 products per keyword. The catalogue Taobao publishes on world.taobao.com serves one page per search (20 results), plus a top-rated list for some keywords; deeper pages are not available. Use several related keywords, or category links, for wider coverage.
• No verified SKU stock, SKU prices, sales counts or sales sorting. Unknown quantities stay null. variantsStatus explains whether the public source omitted variants or returned an unverified shape.
• Price sorting is within retrieved candidates for each input, not the whole marketplace. priceCNY and detailPriceCNY remain separate display prices; promotional prices remain separate too. priceVerified=false means checkout and SKU prices have not been verified.
• Tmall-only mode requires tmallOnly=true and scrapeDetails=true. It accepts only details explicitly labelled Tmall by the source, excludes unknown platforms, and replenishes from the remaining retrieved candidates. Only returned rows generate events.
• Free-shipping-only mode applies to search results, product IDs and resolved product links. Only an explicit freeShipping=true passes; false or unknown shipping is excluded without a product/detail event.
• Exclude source titles or shops with excludeTitleWords and excludeShopIds. Title matching uses case-insensitive substrings and normalizes Traditional/Simplified Chinese; it does not inspect translated English titles. Shop IDs must exactly match the returned shopId, not a seller user ID or shop name. Missing source fields cannot establish an exclusion. Excluded products have no product/detail event, and limits are filled from the remaining retrieved candidates.
• Reviews are samples, not complete review history. reviewsHasNextPage can be true even when only one review is exposed.
• No image matching in this candidate. No reliable anonymous image-search source was established. A product image is an output field, not evidence of image similarity.
• title is in Traditional Chinese, as on Taobao's overseas catalogue (also shop scores and category names); titleSimplified gives the same title in Simplified Chinese.
• Automatic translation is best effort and can fail. Check searchedAs and translationStatus in the summary; use a Chinese keyword if the original English query was used.
• English titles are requested in batches and repeated source titles reuse the same translation. titleTranslationStatus reports success, disabled translation or the reason English is unavailable. After a translation service error, this run stops further translation calls, including on resume, and retains source titles. SUMMARY.translation reports logical operations and the failure reason; an operation may make a second HTTP request if language detection is uncertain. This public service can rate-limit requests, so a missing translation is not a failed product scrape.
• Translation reservations are saved before service calls; confirmed results, failure state and title/query caches are saved before product delivery. If a process stops before a result is durably confirmed, this run stops new translation operations and reports translation_outcome_unknown / unavailable_outcome_unknown. It retains already confirmed cached translations and prepared product rows. operations counts durable reservations, including ones that may not have reached the service; pendingOutcome=true means the outcome remains unknown. This conservative policy does not guarantee exactly-once HTTP calls or that an interrupted request completed. Start a fresh run to try the translation service again.

Batch sourcing, coverage and exports

This candidate requires a fresh run when upgrading from an older candidate. Older saved progress is rejected before collection or additional event charges, so previously prepared results cannot bypass the corrected shipping filter. Same-candidate resume remains supported.

For example, {"keywords":["蓝牙耳机"],"excludeTitleWords":["二手","配件"],"excludeShopIds":["245320730"],"maxItemsPerQuery":10} filters retrieved source data before delivery. SUMMARY.inputs[].filteredByListing counts candidates removed by listing-stage filters; excluded counts exclusions after details. These counts describe the retrieved sample, not the complete marketplace.

Supply multiple keywords and links in one run. Global item-ID deduplication happens before per-input limits, so overlapping results can be replenished from the remaining retrieved candidates. maxItems caps successful product rows across all inputs (default and maximum 10,000); it does not increase source depth. maxItemsPerQuery remains 1–100 with a default of 40.

SUMMARY.inputs[] reports the source total, retrieved candidates, returned products, filters, duplicate count and stop reason. complete means the requested quantity was met without a detail failure, or the source explicitly reported zero results; catalogueComplete is separate and is not inferred from a nonempty sample. A duplicate translated query is reported as merged. partial and source_pagination_unavailable explain a shortfall.

Use the CSV or Excel output link for flat product fields. Use JSON with review samples to preserve nested reviews. These links use the existing Apify Dataset exports; there is no extra export event.

On migration or restart, progress and per-item delivery receipts prevent blind repeats. A lost write acknowledgement is reconciled against the dataset. An uncertain charge remains unknown and stops further work; it is never silently counted as success or retried. Resume the same run with the same input to reconcile it. Starting a new run is a new collection and can incur normal charges.

Tips

• Sourcing: combine with AliExpress Search Scraper to compare China-domestic and export prices.
• Seller vetting: turn on details and filter by shopScores and shopCreditLevel.

中文说明

淘宝/天猫商品爬虫：输入中文或英文关键词、类目链接或商品链接，批量导出淘宝和天猫商品的标题（附英文翻译）、人民币价格（以及港币、新台币）、促销价、店铺名称和图片（开启商品详情后还有店铺评分），可导出 Excel/CSV。适合跨境卖家选品、货源比价和市场调研。无需登录淘宝账号，按商品数量计费（每 1,000 个商品 $2.50），失败的不收费。

Ready-made examples

• Taobao Search with English Keywords
• Taobao Seller Scores
• Taobao Item Details by URL
• Tmall Product Scraper

TubeText Labs tools

TubeText Labs builds 35 pay-per-result Apify Actors for video, social and e-commerce data – no login, JSON/CSV/Excel output, and ready for ChatGPT and Claude (Apify MCP), n8n, Make and Zapier. All tools: apify.com/tubetext

Transcripts

• YouTube Transcript Scraper – videos, Shorts, playlists and whole channels to text; Whisper AI when there are no captions
• TikTok Transcript Scraper – TikTok captions plus Whisper AI, SRT and timestamps
• Instagram Reels Transcript – reel links or @usernames to text with Whisper AI
• Podcast & Video Transcript – podcast RSS / Apple Podcasts, X, Facebook, Loom, Twitch and audio files to text
• Facebook Video Transcript – public Facebook videos and Reels to text with Whisper AI
• X (Twitter) Video Transcript – X/Twitter video posts to text with Whisper AI
• Reddit Video Transcript – videos in public Reddit posts (v.redd.it) to text with Whisper AI, with SRT and timestamps
• Bilibili Video Transcript – Bilibili (B站) videos to text with Whisper AI, plus optional English summaries
• Podcast Transcript – podcast RSS feeds and Apple Podcasts episodes to text with Whisper AI

Video & ad analysis

• Video Breakdown AI – hook analysis, shot list, cut pacing, products shown and script of any TikTok, Reel or YouTube video
• Shot-by-Shot Video Analysis Pro – director-level storyboard of any video: framing, camera move, emotion and why each shot works, plus replay peaks, danmaku and comments tied to shots
• YouTube & TikTok Comments API – comments with like-weighted sentiment and themes, plus the moments viewers react to on long YouTube and Bilibili videos
• Video Ad Analyzer – competitors' YouTube video ads by brand or domain (Google Ads Transparency), torn down by AI
• Google Ads Transparency API – any advertiser's YouTube video ads from Google Ads Transparency, with first/last shown dates, days running, views and transcripts
• Meta Ad Library Scraper – Facebook and Instagram ads by brand or keyword: video URLs, images, ad copy, CTA and landing page

Social, apps & trends

• YouTube Channel Analytics – subscribers, recent video performance, Social Blade grade, ranks and estimated earnings
• YouTube Shorts Scraper – every Short of a channel with exact views, likes, comments and publish time, plus transcripts and the opening line
• Bilibili Scraper – Bilibili (B站) keyword search, popular board, top-100 ranking, video stats, danmaku text and creator (UP主) followers – no login
• China Trending Topics – Douyin, Weibo, Baidu, Toutiao and Bilibili hot-search boards in one run, in English – plus an optional AI briefing on why topics trend
• WeChat Article Scraper – WeChat 公众号 articles by keyword or link: full text, English titles and optional English summaries
• Google Play Reviews + AI Insights – Android app reviews by star rating, country and language, plus an AI report of complaints and praise
• Steam Reviews Scraper + AI Insights – Steam game reviews with hours played and votes, review score and current players, plus an AI report of top complaints, praise and feature requests
• Social Blade Scraper – Social Blade stats for YouTube, TikTok, Instagram and Twitch creators – grade, ranks, 2-week growth, daily history, earnings estimates and top-100 lists
• Spotify Play Count Scraper – play counts for every track of an album, artist or playlist (incl. Top 50 charts), plus monthly listeners, followers, world rank and top cities

E-commerce & travel

• TikTok Shop Product Scraper – US TikTok Shop prices, items sold, stock per SKU and shop stats
• AliExpress Search Scraper – AliExpress search results by keyword: price, items sold, rating, shipping, badges
• Google Hotels Scraper – hotel prices for any destination and dates, per booking site and as a 90-day price calendar
• Taobao & Tmall Product Scraper (this tool) – Taobao/Tmall products by Chinese or English keyword, category or URL: CNY prices, shops and seller scores
• Alibaba & Yiwu Supplier Finder by Image – product photo in, similar Alibaba.com and Yiwu wholesale listings out: price, MOQ, supplier, country and rating
• Amazon Product Search Scraper – Amazon search results, Best Sellers lists and product pages: price, rating, reviews, monthly sales signal, badges and specs
• Google Flights Scraper – flight prices for any route or multi-city trip, a cheapest-day calendar, price insights and booking options per site
• Agoda & Booking.com Hotel Reviews + AI – Agoda hotel reviews plus verified Booking.com reviews shown on Agoda, hotel scores and sub-scores, and an AI report of complaints, praise and action items
• Gas Prices Scraper (US & Canada) – live gas station prices by ZIP, city or coordinates – regular, premium, diesel, E85 – with an area summary of the cheapest stations
• Idealo Price Scraper – every shop offer for a product on idealo – price, shipping, delivery, shop rating – in Germany, Austria, France, Italy, Spain and the UK, with a summary per market

Esports & sports data

• Esports Match Timeline – Valorant and CS2 round-by-round scores, winners and VOD timestamps read from broadcast VODs

Questions or problems? Open an issue (we read every one). Need a custom version? Ask in an issue or email us – we build it as a private Actor on Apify.

Found it useful? A short review on this page helps others find it.

Built by TubeText Labs · Pay per result. No login. Ready for AI agents.

FAQ

Do I need a Taobao account or cookies? No. Only public catalogue pages are read; nothing behind a login.

Is this legal? The Actor reads publicly accessible catalogue pages without logging in and collects no personal data. Note that Taobao's robots.txt only invites listed search engines to these pages; you are responsible for how you use the data and for complying with Taobao's terms.

Support

Found a bug or missing a field? Open an issue – we read every one. Need a custom version? Ask in an issue or email us – we build it as a private Actor on Apify.