# Taobao & Tmall Search & Product Catalog Scraper 🛍️ (`unitbytes/taobao-tmall-scraper`) Actor

⚡Ultra Fast & Cheapest Taobao (淘宝) and Tmall (天猫) search scraper ($0.0015). Extracts true prices, sales volume, shop ratings, and working HD photos in seconds. 100% No Cookies.

- **URL**: https://apify.com/unitbytes/taobao-tmall-scraper.md
- **Developed by:** [UnitBytes | Enterprise Web Data](https://apify.com/unitbytes) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.05 / 1,000 product listing scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

<p align="center">
  <a href="https://console.apify.com/actors/deplqV6g1hYjwrETX/input" target="_blank">
    <img src="https://raw.githubusercontent.com/unitbytes/.github/main/assets/unitbytes-taobao-tmall-search-product-catalog-scraper-banner.jpg" alt="Taobao and Tmall Search & Product Catalog Scraper API by UnitBytes" width="100%" />
  </a>
</p>

## 🛍️ Taobao & Tmall Search & Product Catalog Scraper (淘宝 & 天猫)

<div align="center">

<img src="https://raw.githubusercontent.com/unitbytes/.github/main/assets/unitbytes-taobao-tmall-search-scraper-product-catalog-api-logo.jpg" alt="Taobao and Tmall Search Scraper API Logo - UnitBytes E-Commerce Intelligence" width="120" style="border-radius:24px; box-shadow: 0 6px 24px rgba(255,80,0,0.35); margin-bottom: 12px;" />
<br>

[![Available on Apify](https://img.shields.io/badge/Available_on-Apify-28B52A?style=for-the-badge\&logo=apify\&logoColor=white)](https://console.apify.com/actors/deplqV6g1hYjwrETX/input)
[![Speed](https://img.shields.io/badge/Speed-Results_in_Seconds-brightgreen?style=for-the-badge)](#)
[![Pricing](https://img.shields.io/badge/Price-From_$0.00105%2Fitem-orange?style=for-the-badge)](#)
[![HD Images](https://img.shields.io/badge/HD_Images-100%25_Working-blue?style=for-the-badge)](#)
[![Zero Login](https://img.shields.io/badge/Account_Required-None-blue?style=for-the-badge)](#)
[![Cookieless](https://img.shields.io/badge/Mode-100%25_Cookieless-purple?style=for-the-badge)](#)

**The fastest, cheapest, and most reliable Taobao (淘宝) and Tmall (天猫) search and product catalog scraper on Apify. Search any keyword or category in English or Chinese, filter by price and sorting, and extract true prices, sales volume, verified seller ratings, and 100% working permanent HD product photos in seconds — with Zero Login, Zero Cookies & Zero Chinese Phone Number Required.**

[**🚀 Try it Live on Apify**](https://console.apify.com/actors/deplqV6g1hYjwrETX/input) • [**📖 Documentation**](https://console.apify.com/actors/deplqV6g1hYjwrETX) • [**💬 Support**](mailto:contact@unitbytes.com)

</div>

<p align="center">
  <a href="https://console.apify.com/actors/deplqV6g1hYjwrETX/input" target="_blank">
    <img src="https://raw.githubusercontent.com/unitbytes/.github/main/assets/try-it-for-free.svg" width="240" height="48" alt="Try it for Free">
  </a>
  <br>
  <sub>⚡ <b>1-Click Free Trial:</b> Test live queries using Apify's $5 free monthly credit • No credit card required</sub>
</p>

***

### 💡 Cost-Effective Pay-Per-Event (PPE) Pricing

> \[!TIP]
>
> ### Transparent Pricing with No Hidden Compute Surcharges
>
> - **Zero Hidden Browser Fees**: Avoid expensive scrapers that charge high rates per 1,000 items while requiring heavy 1GB–2GB RAM configurations that drain your platform compute credits.
> - **Lightweight & High-Speed**: Runs efficiently on the minimal **256MB RAM tier** with instant startup and high-speed data delivery at **~29 items/second**.
> - **Unmatched Value on Apify**: Extract catalog products from **$1.05 to $1.50 per 1,000 items**.
> - **100% Risk-Free Free Trial**: With Apify's default **$5.00 free monthly credit**, you can extract over **3,330+ search catalog products completely free every month** before spending a cent.

***

### 📖 Overview

**Taobao (淘宝网)** and **Tmall (天猫)** represent the largest consumer e-commerce ecosystem in the world, with over **1 billion active product listings** establishing global consumer market trends across apparel, consumer electronics, beauty, accessories, toys, and smart home appliances.

Historically, extracting catalog search data from Taobao and Tmall has been an operational nightmare:

- **Mandatory Login & SMS Barriers**: Visiting desktop Taobao item pages directly triggers forced QR code redirects and Chinese phone number verification walls.
- **Broken Media Links**: Ephemeral CDN signatures and image resizing modifiers (`_400x400.jpg`, `_Q75.jpg_.webp`) lead to HTTP 403 Forbidden errors when imported into Shopify, Excel, or Google Sheets.
- **Overseas Mirror Incompleteness**: Scrapers hitting `world.taobao.com` miss over 60% of domestic Chinese catalog listings and localized prices.
- **Heavy Browser Crashes**: Puppeteer and Playwright scrapers requiring 1GB–4GB RAM frequently crash with Out-Of-Memory (OOM Exit 137) errors on large pagination runs.

**Taobao & Tmall Search Scraper by UnitBytes** eliminates every barrier:

- **100% Cookieless Operation**: Search millions of products without configuring custom cookies, tokens, or Chinese accounts.
- **Ultra-Fast Streaming**: Delivers catalog products in batches of up to 60 products per page at **~29 items/second**.
- **Permanent Full-Res HD Image Links**: All photo URLs are automatically rewritten to permanent master-resolution assets on `img.alicdn.com` that never expire.
- **Strict Cost & Billing Protection**: Runs on the **256MB RAM tier**. Startup fee is nominal ($0.00005). If a search returns 0 products or is blocked by target rate limits, you are charged **$0.00**.

***

### ⚡ UnitBytes · Chinese E-Commerce & Sourcing Ecosystem

<table>
  <tr>
    <td colspan="5" style="padding:10px 14px;background:#FF5000;color:#FFFFFF;font-size:13px;font-weight:700;border-radius:6px 6px 0 0">
      ⚡ UnitBytes · China Sourcing & E-Commerce Intelligence Ecosystem
    </td>
  </tr>
  <tr>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FFF4ED;vertical-align:top;width:20%">
      <span style="white-space:nowrap">🛍️ <b>Taobao & Tmall</b></span><br><span style="color:#EA580C;font-size:11px;font-weight:700">📍 You are here</span><br>
      <span style="color:#64748B;font-size:11px">Search, Prices, Sales & Shops</span>
    </td>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:20%">
      <span style="white-space:nowrap">🇨🇳 <b><a href="https://apify.com/unitbytes/1688-scraper" style="color:#0F172A;text-decoration:none;font-size:13px">1688 Factory Direct</a></b></span><br><span style="color:#2563EB;font-size:11px;font-weight:600">Wholesale B2B & MOQ</span><br>
      <span style="color:#64748B;font-size:11px">Direct factories & FBA specs</span>
    </td>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:20%">
      <span style="white-space:nowrap">🌐 <b><a href="https://apify.com/unitbytes/alibaba-scraper" style="color:#0F172A;text-decoration:none;font-size:13px">Alibaba Wholesale</a></b></span><br><span style="color:#2563EB;font-size:11px;font-weight:600">Global B2B Suppliers</span><br>
      <span style="color:#64748B;font-size:11px">Verified audits & OEM/ODM</span>
    </td>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:20%">
      <span style="white-space:nowrap">🐟 <b><a href="https://apify.com/unitbytes/goofish-xianyu-search-scraper" style="color:#0F172A;text-decoration:none;font-size:13px">Goofish Xianyu</a></b></span><br><span style="color:#2563EB;font-size:11px;font-weight:600">C2C Resale & Samples</span><br>
      <span style="color:#64748B;font-size:11px">Liquidation & arbitrage</span>
    </td>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:20%">
      <span style="white-space:nowrap">📕 <b><a href="https://apify.com/unitbytes/xiaohongshu-rednote-trend-scraper" style="color:#0F172A;text-decoration:none;font-size:13px">Xiaohongshu Trends</a></b></span><br><span style="color:#2563EB;font-size:11px;font-weight:600">Social Commerce & KOL</span><br>
      <span style="color:#64748B;font-size:11px">Viral products & buyer intent</span>
    </td>
  </tr>
</table>

***

### 🥊 How It Compares to Other Scraping Approaches

| Feature / Capability | ⭐ UnitBytes Scraper | ⚠️ Standard Market Scrapers | ⚠️ Heavy Browser Scrapers |
| :--- | :---: | :---: | :---: |
| **Zero Account / Zero Cookies** | ✅ **100% Cookieless** | ❌ Often Requires Setup | ❌ High Session Fragility |
| **Permanent Full-Res HD Image Links** | ✅ **YES (No Broken 403s)** | ❌ No (Raw Thumbnails) | ❌ No (Expiring Links) |
| **Price per 1,000 Products** | 🟢 **$1.05 – $1.50** | 🔴 $5.00 – $15.00+ | 🔴 High Compute Costs |
| **Startup Fee** | **$0.00** ($0.00005) | $0.01 – $0.05 | Variable |
| **Catalog Coverage** | **100% Domestic Mainland** | ⚠️ Often Restricted | ⚠️ Prone to Blocks |
| **Scraping Speed** | ⚡ **~29 items/second** | ⚠️ 2–5 items/second | ⚠️ 1–3 items/second |
| **Memory Allocation** | **Strictly 256 MB** | 512 MB – 1 GB | 1 GB – 4 GB |
| **Manual `startPage` Pagination** | ✅ **Yes (e.g. Page 2, 5, 10)** | ❌ No | ❌ No |
| **Stateful Resumption (0 Duplicates)** | ✅ **Yes (`resumptionToken`)** | ❌ No | ❌ No |
| **Dual Output Architecture** | ✅ **Flat Table + Legacy JSON** | ⚠️ Flat only | ⚠️ Flat only |

***

### 💰 Transparent Pricing Tiers & Apify Discounts

We operate on a transparent **Pay-Per-Event (PPE)** model. You only pay for what you extract, and we pass through all Apify subscription volume discounts automatically:

| Apify Plan Tier | Monthly Apify Fee | Apify PPE Discount | Search Catalog Mode (per 1,000 items) | What $5.00 Free Monthly Credit Gets You | Ideal Use Case |
| :--- | :---: | :---: | :---: | :---: | :--- |
| **Free Plan** | **$0 / mo** | Base Rate | **$1.50** ($0.0015 / item) | **3,330 Product Listings** | Testing queries, sample extractions & ad-hoc market research |
| **Starter Plan** | **$49 / mo** | **10% OFF** | **$1.35** ($0.00135 / item) | High-volume dropshipping & price tracking | E-commerce stores, price monitoring & catalog enrichment |
| **Scale Plan** | **$499 / mo** | **20% OFF** | **$1.20** ($0.00120 / item) | Large-scale retail catalog intelligence | Market aggregators, competitor benchmark tracking & ERP sync |
| **Business Plan** | **$999+ / mo** | **30% OFF** | **$1.05** ($0.00105 / item) | Enterprise data pipelines & LLM training | High-frequency catalog crawlers, AI models & data lakes |

- **Billing Protection**: Startup fee is nominal ($0.00005). If a search returns 0 products or is blocked by target rate limits, you are charged **$0.00**.

***

### ✨ Key Features & Extracted Data Fields

- **🔍 Multi-Query Batch Search**: Pass multiple search keywords (e.g. `["phone case", "蓝牙耳机", "smart watch"]`) in a single run with 0 cookies required.
- **💰 True Prices & Promotional Discounts**: Extracts current selling price, original price, and currency (`CNY`).
- **📈 Sales Volume & Buyer Signals**: Extracts real sales numbers (e.g. `1000+人付款`, `月销500+`).
- **🏪 Verified Shop & Seller Scorecards**: Includes shop name, seller nickname, location (e.g. `广东 广州`), seller credit rating, and direct shop URL.
- **🖼️ 100% Working Permanent HD Photos**: Thumbnail modifiers (`_400x400`, `_Q75.jpg_.webp`) and expiring authentication query strings are stripped automatically. Product photo URLs link to master high-resolution assets on `img.alicdn.com`.
- **🔢 Deep Pagination Scaling**: Powered by standard 60-item batch streaming—crawl hundreds or thousands of products consecutively with **0 duplicates**.
- **🚀 Manual Page Jumps (`startPage`)**: Start directly from page 2, 5, or 10 without needing cookies or resumption tokens.
- **🔄 Multi-Batch Resumption**: Emits an encrypted `resumptionToken` for automated batching pipelines, webhooks, and scheduled incremental crawls.
- **📊 Dual Output Modes**: Choose `flat` (clean unnested columns ready for Excel, CSV, Google Sheets, Pandas, and BI dashboards) or `legacy` (nested raw JSON envelope).

***

### 📥 Input Parameters

| Parameter | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `queries` | Array | `["phone case"]` | List of search keywords in English or Chinese (e.g. `["phone case", "女装", "蓝牙耳机"]`). Scrapes multiple keywords in 1 run with 0 cookies required. |
| `keyword` | String | `None` | Single keyword in English or Chinese. Combined with `queries` if provided. |
| `startUrls` | Array | `[]` | Search listing or category URLs pasted from your browser. Keywords will be extracted automatically. |
| `maxItems` | Integer | `30` | Maximum number of products to scrape (1 to 10,000). |
| `startPage` | Integer | `1` | Page number to start scraping from (e.g. 1, 2, 5). Allows paginating through large catalogs without tokens. |
| `sortBy` | String | `default` | Sort order: `default` (Relevance), `sales` (Volume), `price_asc` (Low to High), `price_desc` (High to Low). |
| `priceMin` | Integer | `None` | Minimum unit price filter in Chinese Yuan (¥ CNY). |
| `priceMax` | Integer | `None` | Maximum unit price filter in Chinese Yuan (¥ CNY). |
| `outputFormat` | String | `flat` | `flat` (Clean unnested columns for Excel/CSV/AI) or `legacy` (Nested JSON envelope). |

***

### 📤 Sample Output Preview (`flat` format)

```json
{
  "itemId": "1069831484297",
  "title": "适用于iPhone16手机壳新款苹果15ProMax防摔高级感磁吸保护套",
  "platform": "taobao",
  "url": "https://item.taobao.com/item.htm?id=1069831484297",
  "price": 15.00,
  "originalPrice": 29.90,
  "currency": "CNY",
  "salesCount": "5000+人付款",
  "reviewCount": 850,
  "shopName": "数码优品数码专营店",
  "sellerNick": "digital_master",
  "shopUrl": "https://shop123456.taobao.com",
  "location": "广东 深圳",
  "mainImage": "https://img.alicdn.com/imgextra/i1/123456/O1CN01example.jpg",
  "images": [
    "https://img.alicdn.com/imgextra/i1/123456/O1CN01example1.jpg",
    "https://img.alicdn.com/imgextra/i2/123456/O1CN01example2.jpg"
  ],
  "scrapedAt": "2026-10-07T19:30:00.000Z",
  "searchQuery": "phone case",
  "detailLevel": "full"
}
```

***

### 🛠️ How to Use via API

#### 🐍 Python Integration

```python
from apify_client import ApifyClient

## Initialize client with your Apify API Token
client = ApifyClient("YOUR_APIFY_TOKEN")

## Run the actor
run = client.actor("unitbytes/taobao-tmall-scraper").call(
    run_input={
        "queries": ["phone case", "wireless earbuds"],
        "maxItems": 100,
        "sortBy": "sales",
        "outputFormat": "flat"
    }
)

## Fetch results from dataset
dataset_items = client.dataset(run["defaultDatasetId"]).list_items().items
print(f"Scraped {len(dataset_items)} products.")
for item in dataset_items[:3]:
    print(f"- {item['title']} (¥{item['price']}) | Sales: {item.get('salesCount')} | Shop: {item.get('shopName')}")
```

#### 🟨 Node.js Integration

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const run = await client.actor('unitbytes/taobao-tmall-scraper').call({
    queries: ['phone case'],
    maxItems: 50,
    sortBy: 'sales',
    outputFormat: 'flat',
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Scraped ${items.length} products.`);
```

#### 🔌 MCP Server Setup: Claude Code, Cursor & AI Agents

Connect this scraper directly to **Claude Code**, **Claude Desktop**, **Cursor**, or any MCP-compatible AI agent via the hosted Apify MCP server:

```json
{
  "mcpServers": {
    "apify": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=actors,docs,unitbytes/taobao-tmall-scraper"
    }
  }
}
```

***

### ❓ Frequently Asked Questions (FAQ)

#### Do I need a Taobao account, Alipay, or a Chinese phone number?

**No.** The actor operates 100% cookieless. You do not need to register an account, provide session cookies, or verify an SMS code.

#### Can I search using English keywords?

**Yes.** Standard English terms (e.g. `phone case`, `bluetooth earbuds`, `yoga pants`, `smart watch`) are fully supported. For maximum catalog breadth, you can also search with native Chinese product terms (e.g. `手机壳`, `蓝牙耳机`, `女装`).

#### Can I paginate using `startPage` without tokens or cookies?

**Yes, 100%.** You can simply set `"startPage": 2` or `"startPage": 5` in your input. The scraper starts directly from that page without requiring any cookies or encrypted tokens.

#### What is the purpose of `resumptionToken`?

The `resumptionToken` is an automated, stateful checkpoint saved to your run's Key-Value Store. While human users prefer `startPage`, automated workflows and webhooks can pass `resumptionToken` to resume multi-batch crawls with guaranteed zero duplicate items across runs.

#### Are the product image links permanent?

**Yes.** Raw thumbnail parameters (`_400x400.jpg`, `_Q75.jpg_.webp`) and expiring authentication tokens are automatically stripped, rewriting images to permanent master resolution CDN links on `img.alicdn.com`.

***

### 📞 Support & Custom Sourcing Pipelines

Need high-volume enterprise crawls, custom ERP feeds, or dedicated SLAs?

- **Apify Actor**: [Taobao & Tmall Search & Product Catalog Scraper](https://console.apify.com/actors/deplqV6g1hYjwrETX)
- **Author**: UnitBytes
- **Email**: <contact@unitbytes.com>
- **Enterprise Platform**: <https://unitbytes.com>

***

### 🔍 Keywords & Search Tags

`taobao-scraper` • `tmall-scraper` • `taobao-search-scraper` • `tmall-search-scraper` • `taobao-api` • `tmall-api` • `taobao-product-scraper` • `tmall-product-scraper` • `taobao-pricing-api` • `scrape-taobao` • `scrape-tmall` • `taobao-dropshipping` • `taobao爬虫` • `天猫爬虫` • `淘宝数据采集` • `天猫数据采集` • `taobao-seller-scraper` • `china-ecommerce-scraper` • `apify-actor` • `pay-per-event`

# Actor input Schema

## `queries` (type: `array`):

List of product keywords to search on Taobao and Tmall (e.g., \['phone case', '女装', '蓝牙耳机']). Scrapes multiple keywords in a single run with 0 cookies required.

## `keyword` (type: `string`):

Single keyword in English or Chinese (e.g. 'phone case', '手机壳', '女包'). Added to search queries if provided.

## `startUrls` (type: `array`):

Paste Taobao or Tmall search listing or category URLs directly from your browser. Keywords will be extracted automatically.

## `maxItems` (type: `integer`):

Maximum number of products to scrape (1 to 10,000).

## `startPage` (type: `integer`):

Page number to start scraping from (e.g. 1, 2, 5). Allows paginating through large catalogs without tokens.

## `outputFormat` (type: `string`):

Choose 'flat' for clean unnested rows (ideal for CSV, Excel, Google Sheets, AI analysis, and Pandas), or 'legacy' for a nested JSON envelope.

## `sortBy` (type: `string`):

Sorting order for product search results.

## `priceMin` (type: `integer`):

Minimum unit price in Chinese Yuan (CNY ¥).

## `priceMax` (type: `integer`):

Maximum unit price in Chinese Yuan (CNY ¥).

## `resumptionToken` (type: `string`):

Optional encrypted resumption token copied from a previous run or dataset item. Restores session and cursor to continue scraping seamlessly with zero duplicates.

## `proxyConfiguration` (type: `object`):

Proxy group settings. By default, auto-routes through external proxies with automatic Apify Residential fallback to prevent IP blocks.

## Actor input object example

```json
{
  "queries": [
    "phone case"
  ],
  "maxItems": 30,
  "startPage": 1,
  "outputFormat": "flat",
  "sortBy": "default",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Extracted Taobao and Tmall products, SKU matrices, prices, and seller intelligence

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "queries": [
        "phone case"
    ],
    "maxItems": 30,
    "startPage": 1,
    "outputFormat": "flat"
};

// Run the Actor and wait for it to finish
const run = await client.actor("unitbytes/taobao-tmall-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "queries": ["phone case"],
    "maxItems": 30,
    "startPage": 1,
    "outputFormat": "flat",
}

# Run the Actor and wait for it to finish
run = client.actor("unitbytes/taobao-tmall-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "queries": [
    "phone case"
  ],
  "maxItems": 30,
  "startPage": 1,
  "outputFormat": "flat"
}' |
apify call unitbytes/taobao-tmall-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,unitbytes/taobao-tmall-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/deplqV6g1hYjwrETX/builds/K9d05aDddZ3d8zFxI/openapi.json