Pricing

from $10.00 / 1,000 search results

Taobao Tmall Product Scraper

🛍️ Scrape Taobao & Tmall into clean structured datasets — product details, keyword search, shop catalogs, and customer reviews. Four operations in one actor, one clean dataset per run. No account, no API key, no setup.

Pricing

from $10.00 / 1,000 search results

Rating

4.0

(2)

Developer

SIÁN OÜ

Actor stats

Bookmarked

381

Total users

109

Monthly active users

4.6 hours

Issues response

16 minutes ago

Last modified

Categories

E-commerce

Automation

You can access the Taobao Tmall Product Scraper programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "1.2",
    "x-build-id": "6WTdZ3QDTKPaPpCpV"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/sian.agency~taobao-tmall-product-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-sian.agency-taobao-tmall-product-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/sian.agency~taobao-tmall-product-scraper/runs": {
      "post": {
        "operationId": "runs-sync-sian.agency-taobao-tmall-product-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/sian.agency~taobao-tmall-product-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-sian.agency-taobao-tmall-product-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "operation"
        ],
        "properties": {
          "operation": {
            "title": "🎯 Operation — what do you want to scrape?",
            "enum": [
              "productDetail",
              "keywordSearch",
              "shopCatalog",
              "productReviews",
              "productQuestions"
            ],
            "type": "string",
            "description": "🎯 **PICK ONE OPERATION PER RUN.** Each run produces one clean dataset matching the chosen mode.\n\n- **🛍️ Product Detail** — deep scrape of a single product by item ID (title, images, SKUs, pricing, seller, description, coupons). Premium versions add final / coupon-adjusted SKU pricing.\n- **🔍 Keyword Search** — search Taobao / Tmall by keyword, paginate through results\n- **🏪 Shop Catalog** — pull the full product catalog for a seller (by numeric user / seller ID)\n- **💬 Product Reviews** — paginate customer reviews for a product, including photos and variant info\n- **❓ Product Q&A** — paginate buyer questions and their answers for a product\n\n💡 **TIP:** To combine operations, run the actor multiple times with different configurations.",
            "default": "keywordSearch"
          },
          "itemId": {
            "title": "🛍️ Item ID (Product Detail / Reviews / Q&A)",
            "type": "string",
            "description": "🛍️ **Required for `Product Detail`, `Product Reviews`, and `Product Q&A` operations.**\n\nThe numeric Taobao/Tmall item ID. You can find it:\n- In any Taobao product URL after `id=` (e.g. `https://item.taobao.com/item.htm?id=744983869996` → `744983869996`)\n- In the `itemId` field of any search or shop-catalog result row\n\n💡 **TIP:** For bulk product lookups, run the actor once per item ID, or use `Keyword Search` / `Shop Catalog` to build the list first.\n\n⚠️ **Ignored** for Keyword Search and Shop Catalog operations."
          },
          "detailVersion": {
            "title": "🛍️ Detail Version (freshness matters — read this)",
            "enum": [
              "v9",
              "v1",
              "v4",
              "v5"
            ],
            "type": "string",
            "description": "🛍️ **Applies to `Product Detail` only.** Controls which upstream detail version is used. **They differ in data freshness and pricing depth** — pick deliberately:\n\n- **🆕 Fresh — Full (default, recommended)** — live, non-cached scrape. Flat response with coupon-adjusted pricing, attributes, specs, SKU images, seller type, promotion info. **Every row carries a `recordTime` field = the exact capture time.** Use this when you need current data.\n- **🔋 Fresh — Standard** — live, non-cached scrape with the full classic payload (SKUs, pricing tiers, item description HTML, coupons, shipping, return policy). Also stamped with `recordTime`. Coverage differs slightly from Full — some products only resolve on one version, so for maximum coverage you can run both and merge.\n- **💎 Premium — final / coupon pricing** — live scrape focused on the **final, coupon-adjusted price** of the item and every SKU variant (`finalPriceYuan`, `finalSkuPrice`, original-vs-final per SKU, stock). Best when accurate checkout pricing is the priority.\n- **⚡ Cached — Lite (NOT recommended for fresh data)** — compact response served from a **cache that can be anywhere from a few days to several months old**. Fields may refresh independently and **there is no reliable capture timestamp** (the `recordTime` on a cached row reflects request time, not when the product state was captured). It is the most compact (lightest) payload — only choose it when stale data is acceptable. Note it is **billed at the same per-row rate** as the standard fresh versions (Full / Standard), so it is not cheaper, just smaller.\n\n💡 **Freshness rule:** for current-state data use **Fresh — Full** (default) or **Fresh — Standard**; for accurate final pricing use the **💎 Premium** version; **avoid Lite when freshness matters.** Check the `recordTime` field on each row to verify capture time.",
            "default": "v9"
          },
          "orderType": {
            "title": "💬 Review sort order (for Product Reviews)",
            "enum": [
              "feedbackdate",
              "general"
            ],
            "type": "string",
            "description": "💬 **Applies to `Product Reviews` operation only.**\n\n- `feedbackdate` (default) — sort by review date\n- `general` — sort by general relevance",
            "default": "feedbackdate"
          },
          "keyword": {
            "title": "🔍 Search Keyword",
            "type": "string",
            "description": "🔍 **Required for `Keyword Search` operation.**\n\nAny Taobao / Tmall search query. Supports Chinese, English, and mixed queries:\n- `iphone 15`\n- `无线耳机` (wireless earphones)\n- `sony camera a7`\n- `running shoes men`\n\n💡 **TIP:** More specific queries return higher-quality results. Use `Tmall only` + price range to filter to brand merchants."
          },
          "startPrice": {
            "title": "💰 Min Price (CNY) — optional",
            "minimum": 0,
            "type": "integer",
            "description": "💰 Minimum price in Chinese Yuan (integer). Leave blank for no minimum. Applies to `Keyword Search` only."
          },
          "endPrice": {
            "title": "💰 Max Price (CNY) — optional",
            "minimum": 0,
            "type": "integer",
            "description": "💰 Maximum price in Chinese Yuan (integer). Leave blank for no maximum. Applies to `Keyword Search` only."
          },
          "tmallOnly": {
            "title": "🏬 Tmall only (filter out Taobao C2C sellers)",
            "type": "boolean",
            "description": "🏬 When enabled, search results are restricted to Tmall (brand / official stores). Default: false (searches both Taobao and Tmall).",
            "default": false
          },
          "userId": {
            "title": "🏪 Seller User ID",
            "type": "string",
            "description": "🏪 **Required for `Shop Catalog` operation.**\n\nThe numeric `userId` (aka seller ID) of the Taobao / Tmall shop. You can find it:\n- In the `userId` field of any search or detail result row\n- In a seller's shop URL query string\n\n💡 **TIP:** For a brand's full catalog, first run a Keyword Search for the brand name, note the top `userId`, then run Shop Catalog with that ID."
          },
          "shopId": {
            "title": "🏪 Shop ID (required for extended/latest catalog)",
            "type": "string",
            "description": "🏪 **Required when `Catalog mode` is extended or latest.** Ignored for standard.\n\nThe numeric shop ID (distinct from the seller user ID). You can find it in the `shopId` field of any detail or search result row.\n\n💡 **TIP:** Run a Product Detail or Keyword Search first to discover the shopId for a given seller."
          },
          "catalogVersion": {
            "title": "📦 Catalog Mode",
            "enum": [
              "v1",
              "v2",
              "v3"
            ],
            "type": "string",
            "description": "📦 **Applies to `Shop Catalog` only.**\n\n- **Standard** — classic mode, requires only `userId`, 2 sort options, ~30 items/page\n- **Extended** — requires `shopId` + `userId`, 5 sort options (price, hot, new arrivals), **60 items/page**\n- **Latest** — requires `shopId` + `userId`; pulls from the newest catalog endpoint. **~10 items/page** (smaller pages than Extended), returns `totalResults` for full pagination.\n\n💡 **TIP:** Use **Extended** for the most items per call (60/page = fewer API calls). Use **Latest** when you specifically want the newest-endpoint listing; note it returns fewer items per page.",
            "default": "v1"
          },
          "sort": {
            "title": "📊 Sort order",
            "enum": [
              "_sale",
              "_bid",
              "bid",
              "_coefp",
              "_default",
              "coefp",
              "hotsell",
              "oldstarts"
            ],
            "type": "string",
            "description": "📊 Sort order for search or shop catalog results.\n\n**Keyword Search** options:\n- `_sale` (Sales, default)\n- `_bid` (Price high→low)\n- `bid` (Price low→high)\n- `_coefp` (General)\n\n**Shop Catalog (standard)** options: `_sale` (default), `_default`\n\n**Shop Catalog (extended/latest)** options: `coefp` (Comprehensive, default), `hotsell`, `oldstarts` (New arrivals), `bid` (Price low→high), `_bid` (Price high→low)",
            "default": "_sale"
          },
          "maxPages": {
            "title": "📄 Max pages to fetch",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "📄 **Applies to paginated operations** (Keyword Search, Shop Catalog, Product Reviews). Ignored for Product Detail.\n\n- **Keyword Search:** 10 items per page\n- **Shop Catalog (standard):** ~30 items per page · **extended:** 60 items per page\n- **Product Reviews:** 20 reviews per page\n\n💡 **TIP:** Start small (1–3 pages) to preview results before scaling up.\n\n⚠️ Hard cap: 50 pages to prevent runaway runs.",
            "default": 5
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

淘宝天猫采集器 — 商品、价格、评论、店铺数据 OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Taobao Tmall Product Scraper from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Taobao Tmall Product Scraper API in Python

Taobao Tmall Product Scraper API in JavaScript

Taobao Tmall Product Scraper API through CLI

Taobao Tmall Product Scraper API

Taobao Tmall 淘宝 Product Scraper - Prices, SKUs, Reviews

zen-studio/taobao-search-scraper

Extract Taobao (淘宝) and Tmall (天猫) prices, SKUs, reviews, shop data, images, and attributes by keyword. Supports Chinese searches like 女装, 口红, 手机壳; exports JSON, CSV, and Excel.

Zen Studio

183

2.7

Taobao 淘宝 Product Detail Scraper - SKUs, Prices, Reviews

zen-studio/taobao-detail-scraper

Extract SKUs, prices, attributes, optional reviews, images, videos, shop data, and category metadata from Taobao (淘宝) and Tmall (天猫) product URLs or item IDs. Export clean JSON, CSV, and Excel rows.

Zen Studio

401

Taobao 淘宝 Seller Catalog Scraper - Products & Prices

zen-studio/taobao-seller-products-scraper

Extract product catalogs from Taobao (淘宝) and Tmall (天猫) sellers. Resolve seller handles, IDs, or product URLs, then export store product rows with prices, images, sales signals, categories, and shop metadata.

Zen Studio

Taobao Product Scraper

pizani/taobao-product-scraper

Extract detailed product data from Taobao, including title, price, reviews, specifications, images, options, and categories. Perfect for market research, e-commerce insights, and data-driven decision-making

Pizani

212

JD.com Product Scraper — Search, Detail, Reviews

sian.agency/jd-com-product-scraper

Scrape JD.com (Jingdong) into clean structured datasets — keyword search with real prices, product details, customer reviews, shop catalogs, and bulk price lookups. Five operations in one actor. No account, no API key, no setup.

SIÁN OÜ

106

1688.com Products Scraper

devcake/1688-com-products-scraper

Fast 1688.com scraper for bulk pricing tiers, supplier badges, product specs, and demand metrics. Filter by best-selling to find proven products with factory-direct pricing.

devcake

504

5.0

1688.com Wholesale Scraper — Pay Per Product, No Subscription

prodiger/1688-scraper

Scrape 1688.com — Alibaba's Chinese B2B wholesale marketplace — for product titles, prices, sales volume, return rates, supplier years, and city. The only PPE 1688 scraper on Apify Store: pay per product, not per month. Pure HTTP, no API key, no captcha.

Arnas

1688 Product Details Scraper

ecomscrape/1688-product-details-page-scraper

Extract comprehensive product details from 1688.com, China's largest wholesale marketplace. Get prices, specifications, supplier data, and inventory information for market research and dropshipping business automation.

ecomscrape

338

5.0

1688 Products Wholesale Scraper - 50+ Fields, 250+ Products/Min

zen-studio/1688-wholesale-scraper

Extract 50+ fields per product from 1688.com at 250+ products/minute. Tiered wholesale pricing, supplier verification, factory stats, dropship channels, certifications, trade service scores. Search by keyword (Chinese/English) or offer IDs. JSON output, no login required.

Zen Studio

746

5.0

1688.com Supplier Scraper

devcake/1688-com-supplier-scraper

Fast 1688.com supplier scraper. Get verified factory profiles, quality scores, and product offers. Source directly from gold-certified manufacturers for E-commerce.

devcake

120