Taobao Seller Catalog Scraper — Shop Products, Prices & Images

Turn a Taobao or Tmall shop ID or world.taobao.com/dianpu URL into one dataset row per public catalog listing, with item ID, title, CNY price, shop meta, Tmall flag, image, and item URL. This Actor reads the crawlable overseas storefront catalog over HTTP on Apify, with proxy rotation, scheduling, API access, and MCP-ready output.

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

Best fit for this Actor

This Actor is designed as a focused standalone workflow for public seller catalogs:

• Sourcing and merchandising teams that already have a shop ID from search and need the storefront's visible product cards.
• Competitive catalog checks on a known seller without opening every product detail page.
• AI agents that call a bounded shop-catalog tool through Apify MCP and read the dataset plus OUTPUT.

When you need keyword search first, start with Taobao Tmall Search Scraper (it already emits shopUrl → dianpu/{shopId}), then pass the shop into this Actor. For full product detail (description, variants, ratings), continue with Taobao Product Detail Scraper.

Practical scenario

A buyer found shop 63978904 during keyword research. They run this Actor with that shop URL, sortBy: "sales", and maxItemsPerSeller: 3. The dataset returns the top visible catalog cards with title, priceCny, shopName, imageUrl, and url. They export CSV and open selected item URLs in the detail sibling.

Input

Input fields

Field	Type	What it controls
shopUrls	array	https://world.taobao.com/dianpu/{shopId}.htm storefront URLs. Prefill: live demo shop.
shopIds	array	Numeric shop IDs (same as dianpu pages).
maxItemsPerSeller	integer	Cap per shop. Prefill 3, default 40. First-screen only.
maxResults	integer	Run-wide billed-row cap. Prefill 3, default 120.
sortBy	enum	sales, relevance, newest, credit, priceAsc, priceDesc.
tmallOnly	boolean	Keep Tmall-flagged cards only.
minPrice / maxPrice	number	CNY bounds after extraction.
expandSorts	boolean	Re-query the shop across sorts and merge unique item IDs.
proxyConfiguration	object	Apify Proxy default for cloud runs.

Quick start input

{
  "shopUrls": ["https://world.taobao.com/dianpu/63978904.htm"],
  "maxItemsPerSeller": 3,
  "maxResults": 3,
  "sortBy": "sales"
}

What data you receive

One default-dataset record is one public catalog card. You can download the dataset in JSON, HTML, CSV, or Excel.

Field	Description
itemId	Numeric item identifier
title	Listing title
priceCny	Displayed yuan price
currency	ISO currency, usually CNY
isTmall / platform	Tmall badge from public title or shop
shopId / shopName / shopUrl	Storefront identity
sellerId	Public seller id when exposed
imageUrl	Primary image
url	world.taobao.com item URL
scrapedAt	ISO 8601 collection time

Illustrative output record

{
  "itemId": "8803330176",
  "itemIdStr": "abcItemSlug",
  "title": "Example bottled water 4L x4",
  "url": "https://world.taobao.com/item/abcItemSlug.htm",
  "taobaoUrl": "https://item.taobao.com/item.htm?id=8803330176",
  "platform": "taobao",
  "isTmall": false,
  "priceCny": 45,
  "currency": "CNY",
  "shopId": "63978904",
  "shopName": "Example Shop",
  "shopUrl": "https://world.taobao.com/dianpu/63978904.htm",
  "imageUrl": "https://img.alicdn.com/imgextra/example.jpg",
  "sortBy": "sales",
  "position": 1,
  "scrapedAt": "2026-09-29T13:00:00.000Z"
}

Pricing

Billing is Pay per event with Apify platform usage included. Confirm the live unit prices on the Actor Pricing tab before a large run.

Event	Price	When it fires
Actor start	$0.00005	Once per run
Catalog product	$0.004	Each validated listing saved to the dataset

Filter-dropped rows are unbilled. maxItemsPerSeller / maxResults are the event-cost ceiling: 3 products are about $0.012 plus the start event, with Apify platform usage included.

Honest limits

• Public first-screen world.taobao.com/dianpu cards only. dianpu/{id}_N.htm pagination returns a homepage shell and is not scraped as extra pages.
• Mainland shop*.taobao.com hosts and login-walled storefronts are out of contract.
• Empty or unknown shops finish VALID_EMPTY with zero catalog charges. Anti-bot walls fail as UPSTREAM_FAILED.

Use through the API

curl "https://api.apify.com/v2/acts/khadinakbar~taobao-seller-catalog-scraper/runs" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "shopUrls": ["https://world.taobao.com/dianpu/63978904.htm"],
    "maxItemsPerSeller": 3,
    "maxResults": 3,
    "sortBy": "sales"
  }'

Agent prompt card

Use khadinakbar/taobao-seller-catalog-scraper with shopUrls or shopIds for a public world.taobao.com storefront.
Keep maxItemsPerSeller small for tests. Read dataset rows plus OUTPUT.outcome.
Do not expect full shop inventory — first-screen catalog only.

FAQ and responsible use

Use this Actor only on public catalog pages you are allowed to access. Respect Taobao/Tmall terms, robots rules, and applicable law. This tool returns public listing cards, not private seller contacts or login-only inventory. Open the Issues tab for feedback or custom work requests.

Builder's note

Day-0 probing confirmed the same embedded itemListModuleResponse JSON used by the search sibling works on live dianpu pages, while _N.htm “pagination” URLs do not. Shipping an honest first-screen contract beats claiming full-shop coverage that the public overseas surface does not provide.