Taobao Tmall Search Scraper avatar

Taobao Tmall Search Scraper

Pricing

from $1.60 / 1,000 taobao/tmall product scrapeds

Go to Apify Store
Taobao Tmall Search Scraper

Taobao Tmall Search Scraper

Search public Taobao and Tmall listings by keyword or world.taobao.com product or category URL. Each product row has item ID, title, CNY price, shop, Tmall flag, image and URL from the crawlable overseas catalogue.

Pricing

from $1.60 / 1,000 taobao/tmall product scrapeds

Rating

0.0

(0)

Developer

Khadin Akbar

Khadin Akbar

Maintained by Community

Actor stats

0

Bookmarked

29

Total users

8

Monthly active users

7 days ago

Last modified

Features

Limited permissions

Share

What is Taobao Tmall Search Scraper — Product Listings, Prices & Shops?

Type a keyword, get one dataset row per Taobao or Tmall product: item ID, title, price in yuan (plus USD, EUR and GBP), shop, Tmall flag, image and item link. It reads the public overseas catalogue over plain HTTP, so there is no login, no browser and no cookies to manage. Turn on Go deeper and one keyword can return 100 or more unique products instead of one page of 20 (in our tests: 100 to 150 on most keywords, fewer when a keyword has a small catalogue).

You pay per unique product saved. The price per product gets lower on higher Apify plans, so check the Pricing tab. Pages that are blocked or empty cost you nothing.

Taobao and Tmall are trademarks of their respective owners. This independent Actor is not affiliated, associated, or endorsed by Alibaba Group, Taobao, or Tmall.

What's new

  • More results per keyword. expandSorts now goes through every sort order and then the top categories for the keyword, so one keyword can return 100 to 150 unique products, not about 40.
  • Prices in your currency. Rows carry priceUsd, priceEur, priceGbp (and JPY, KRW, SGD, MYR, AED on request) from a daily rate table, plus the date of that table.
  • Fewer failed runs. The Actor starts on datacenter IPs and retries on residential IPs only when Taobao blocks a page, with a hard limit of 3 paid retries per page.
  • Faster big jobs. Keywords run four at a time, and a run that hits the time limit ends as PARTIAL with the rows it already saved, not as a timeout.
  • New fields. discountPct, sellingPoint, buyerTags, categoryRootId, and an agentSummary in the run output for AI agents.

Best fit for this Actor

  • Product researchers who start with a keyword such as iphone or 机械键盘 and want listing cards with price and shop.
  • Sourcing and price-comparison teams who keep Tmall storefronts with tmallOnly, or filter a price range.
  • AI agents that call a bounded search tool through Apify MCP and read the dataset plus OUTPUT.

What it does not return: sales counts, shop ratings, SKU variants, stock or reviews. Those live on item pages that Taobao does not serve openly. For one product or one shop, use our Taobao Product Detail Scraper or Taobao Seller Catalog Scraper. For B2B supply, try Alibaba Listings Scraper; for retail price baselines, AliExpress Product Search Scraper.

Practical scenario

A merchandiser checks iPhone prices before a sourcing call. They run searchQueries: ["iphone"] with expandSorts: true and maxResults: 100, filter tmallOnly, and export CSV with priceCny, priceUsd, shopName and url. Duplicates are dropped by item ID, so every row is a different product.

Input

FieldTypeWhat it controls
searchQueriesarrayKeywords, one per query. Chinese keywords usually match more of the catalogue. Prefill: iphone.
startUrlsarrayOptional world.taobao.com /product/{keyword}.htm or /category/{id}.htm pages.
maxResultsintegerHard cap on billed rows across the whole run. Prefill 3, default 40, maximum 2000.
sortByenumsales, relevance, credit, priceAsc, or priceDesc.
tmallOnlybooleanKeep only listings marked as Tmall.
minPrice / maxPricenumberYuan bounds applied after extraction.
expandSortsbooleanGo deeper: every sort order, then the top categories. 100 to 150 unique products per keyword in our tests.
currenciesarrayExtra price currencies: USD, EUR, GBP, JPY, KRW, SGD, MYR, AED. Default USD, EUR, GBP.
proxyConfigurationobjectLeave the default.

Quick start input

{
"searchQueries": ["iphone"],
"maxResults": 3,
"sortBy": "sales"
}

Go-deeper input

{
"searchQueries": ["iphone", "机械键盘"],
"maxResults": 200,
"expandSorts": true,
"tmallOnly": false,
"currencies": ["USD", "EUR"]
}

What data you receive

One record is one public catalogue card. Download as JSON, CSV, Excel or HTML.

FieldDescription
itemIdNumeric item identifier
titleListing title
priceCny / priceOriginalCny / discountPctDisplayed yuan price, original price, percent off when shown
priceUsd, priceEur, priceGbp, … / fxRatesDateConverted prices and the date of the rate table
priceHkd / priceTwdHong Kong and Taiwan dollar prices from the card
isTmall / platformTmall badge from the public title or shop
shopName / shopUrl / shopIdStorefront on the card
sellingPoint / buyerTagsSelling-point text and buyer comment tags when the card shows them
categoryId / categoryRootIdTaobao category of the card
imageUrl / imagesPrimary image and gallery
url / taobaoUrlworld.taobao.com item link and item.taobao.com link
searchQuery / sortBy / positionWhere the row came from
scrapedAtISO 8601 collection time

Illustrative output record

{
"itemId": "974671890820",
"title": "Apple iPhone 17",
"url": "https://world.taobao.com/item/abcItemSlug.htm",
"taobaoUrl": "https://item.taobao.com/item.htm?id=974671890820",
"platform": "tmall",
"isTmall": true,
"priceCny": 5999,
"priceOriginalCny": 5999,
"priceUsd": 899.85,
"priceEur": 780.0,
"priceGbp": 676.6,
"fxRatesDate": "2026-11-14",
"discountPct": null,
"shopName": "Example Tmall Store",
"categoryId": "1512",
"imageUrl": "https://img.alicdn.com/imgextra/example.jpg",
"searchQuery": "iphone",
"sortBy": "sales",
"position": 1,
"scrapedAt": "2026-11-14T10:00:00.000Z"
}

Pricing

Billing is Pay per event. Platform usage is covered by the Actor owner. The Pricing tab shows the live price per product for your plan; higher plans pay less per product.

EventWhen it fires
Actor startOnce per run, tiny fixed fee
Product scrapedEach unique, validated listing saved to the dataset

Duplicates, rows dropped by tmallOnly, minPrice or maxPrice, and blocked or empty pages are not billed. maxResults is your cost ceiling: the run stops as soon as it has saved that many products, and maxTotalChargeUsd also stops it.

Use through the API

curl "https://api.apify.com/v2/acts/khadinakbar~taobao-tmall-search-scraper/runs" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"searchQueries":["iphone"],"maxResults":100,"expandSorts":true}'

Read the default dataset items after the run reaches a terminal status.

Use with AI agents through Apify MCP

Search public Taobao and Tmall listings for the keyword iphone, go deep, keep at most 100 unique products, return title, CNY and USD price, shop, Tmall flag, and item URL, then report the outcome.

Read OUTPUT first: it holds the outcome and an agentSummary with results per keyword, sort orders and categories used, blocked pages, and stop reason. Keep source URLs as provenance and use maxResults as the cost control. Connect through Apify MCP for the current client setup.

Best results and workflow guidance

  • Start with a specific keyword and a small maxResults, then raise it once the rows look right.
  • Use Chinese keywords for mainland-style coverage.
  • Use expandSorts when you need depth; each extra page returns about 20 products, and overlap is removed for you.
  • Turn on tmallOnly for official-storefront comparison.
  • Pass item URLs to a product-detail Actor when you need specs beyond the listing card.

Empty matches finish as a completed empty dataset. If Taobao keeps blocking every page, the run ends as failed and charges only the start fee.

FAQ

What input does it need?

One or more keywords in searchQueries, for example iphone or 机械键盘. You can add world.taobao.com /product/ or /category/ pages in startUrls. Product-detail URLs are ignored, because this Actor only runs searches.

How many products can one keyword return?

About 20 per catalogue page. With expandSorts on, the Actor reads every sort order and the top categories for the keyword and removes duplicates, which gave 100 to 150 unique products per keyword in our tests. The real number depends on the keyword and on the route Taobao serves that day, so treat it as a typical result, not a guarantee.

Why is there no sales count, rating or reviews column?

The public catalogue card does not carry them, and the item pages that do are not served openly. We would rather leave the column out than guess.

What do the extra currencies mean?

They are your yuan price converted at a daily rate table, with the table date in fxRatesDate. If the rate table is unavailable that day, those fields are empty and the run says so in its warnings.

What does it cost?

A tiny start fee per run, plus one charge per unique product saved. The per-product price depends on your plan and is on the Pricing tab. maxResults caps the number of billed rows.

What happens with no matches or blocked pages?

No matches: the run finishes as a completed empty dataset with no product charges. Blocked pages: the Actor retries (datacenter first, then at most 3 residential retries per page), and if it still cannot read a page it says so in the run summary and moves on. A run that saved some rows ends as PARTIAL.

It reads public catalogue pages only, with no login. Rules differ by country and by use, so check applicable laws and the site terms before you rely on the data.

Responsible use

Use this Actor only on public catalogue pages you are authorized to access, and in line with applicable laws and the site terms of service. Keep personal data out of the workflow unless you have a lawful basis. It is provided for legitimate product research, price monitoring, and sourcing.