# Taobao Catalogue Scraper - Products, CNY Prices & Shops (`automation-lab/taobao-overseas-public-catalogue-products-and-prices`) Actor

Export Taobao and Tmall products by keyword, category or shop from Taobao's public overseas catalogue: CNY/HKD/TWD prices, discounts, shop scores and optional item-page seller details and review highlights. No login.

- **URL**: https://apify.com/automation-lab/taobao-overseas-public-catalogue-products-and-prices.md
- **Developed by:** [Automation Lab](https://apify.com/automation-lab) (community)
- **Categories:** E-commerce, Lead generation
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.92 / 1,000 products

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

## Taobao Catalogue Scraper - Products, CNY Prices & Shops

Export **Taobao (淘宝) and Tmall (天猫) products** by keyword, category or shop from the public catalogue that Taobao publishes for overseas shoppers. Each product comes with its **yuan (CNY) price**, the Hong Kong dollar and New Taiwan dollar equivalents, Taobao's price label, images, shop ID and name, category IDs and the shop's description score. Turn on **Include item details** to add the seller profile, the three shop service scores, ship-from location, Taobao vs. Tmall, payment methods, review count, review highlights and the latest review.

No Taobao account, no cookies and no browser. The Actor reads plain catalogue pages, so runs are fast and cheap.

### What does Taobao Catalogue Scraper do?

- **Keyword search** – enter Chinese or English keywords and get the best-selling matching products.
- **Category listings** – enter a numeric category ID (for example `1512` for mobile phones).
- **Shop catalogues** – enter a shop ID and get the products that shop lists.
- **Catalogue links** – paste `www.taobao.com/list/...` or `world.taobao.com/...` keyword, category, shop or item links.
- **Deep scan** – Taobao shows signed-out visitors one page per listing (20 products per keyword or category, 60 per shop). Deep scan also reads the listing in price bands and other sort orders, which usually gives **100-230 unique products per keyword, about 120 per category and about 140 per shop**.
- **Price filter** – keep only products between a minimum and maximum yuan price.
- **Item details (optional)** – open each product's catalogue page for the seller profile, service scores and buyer review summary.

### Who is it for?

- **Sourcing agents and importers** who compare Chinese supplier prices for the same product every week.
- **Cross-border e-commerce sellers** (Shopee, Lazada, Amazon, eBay, Etsy) who check what a product costs on Taobao before listing it.
- **Dropshippers and buying agents** who need product links, CNY prices and shop scores for their customers.
- **Brand owners** who monitor how their products and lookalikes are priced on Taobao and Tmall.
- **Market researchers and analysts** who track price levels, best sellers and shop quality in a niche.

### Why use this Taobao scraper?

- **Recurring price comparisons** – run the same keywords or shops on a schedule and compare yuan prices over time.
- **More than one page** – deep scan reaches several times the products a single signed-out page shows, including for categories.
- **Shop quality at a glance** – description, service and delivery scores, seller type (Tmall business or individual seller), shop age and size.
- **Buyer voice** – review count and highlights such as "声音质量好 (good sound) – 99 buyers", plus the latest review with the variant bought.
- **Honest limits** – Taobao does not serve numeric item links (`item.taobao.com/item.htm?id=...`) to signed-out visitors, so the Actor rejects them up front with a clear message instead of charging for empty rows.

### What data can you extract from Taobao?

| Field | Example | Available |
| --- | --- | --- |
| `itemId`, `title` | `1079352038299`, `爱国者蓝牙耳机半入耳式2026新款...` | Always (Taobao shortens the title on item pages, so catalogue item links given as input return the short title) |
| `price`, `currency`, `listPrice` | `118`, `CNY`, `118` | Always |
| `priceHkd`, `priceTwd` | `140.41`, `584.21` | Listings (`null` for catalogue item links given as input) |
| `discountType` | `优惠价` (offer price), `特价秒杀` (flash sale) | When Taobao shows a label |
| `image`, `images` | img.alicdn.com URLs | Always |
| `shopId`, `shopName` | `503709453`, `腔调会员精选旗舰店` | Always |
| `categoryId`, `rootCategoryId` | `50005050`, `50011972` | Always |
| `descriptionScore`, `freeShipping`, `areaLimited` | `4.91`, `false`, `false` | Listings |
| `sellingPoints` | `["全网通制 信号稳定"]` | When the seller sets them |
| `shopScores` | description / service / delivery out of 5 | Shop listings and item details |
| `url`, `taobaoUrl` | catalogue page and item.taobao.com link | Always |
| `platform`, `location`, `categoryPath` | `tmall`, `上海`, `["影音视听","耳机耳放","耳机"]` | Item details |
| `originalPrice`, `promotionPrice`, `hasRangePrice` | `118`, `118`, `false` | Item details |
| `sellerId`, `sellerType`, `sellerCreditLevel` | `2215824413675`, `B`, `19` | Item details |
| `shopOpenedAt`, `shopItemCount`, `shopNewItemCount` | `2023-05-08`, `1707`, `172` | Item details |
| `paymentMethods` | `["蚂蚁花呗","信用卡支付","集分宝"]` | Item details |
| `reviewCount`, `reviewHighlights`, `latestReview` | `3000+`, tags with buyer counts, rating/text/date/variant | Item details, when the product has reviews |
| `detailsIncluded`, `detailError` | `true`, `null` | Always; `detailError` explains why a product has no item details |
| `sourceType`, `sourceInput`, `searchSlice`, `position` | `search`, `蓝牙耳机`, `price 200-500 CNY, best sellers`, `3` | Always |

### How much does it cost to scrape Taobao products?

This Actor uses pay-per-event pricing. You pay a small fee per run plus a fee per product saved. Products removed by your price filter, duplicates and failed pages are never charged. The run fee is taken together with the first saved product, so a run that finds no products costs nothing.

| Event | Free plan | Bronze | Silver | Gold and above |
| --- | ---: | ---: | ---: | ---: |
| Run start (once per run, with the first product) | $0.001 | $0.001 | $0.001 | $0.001 |
| Product | $0.00368 | $0.0032 | $0.002496 | $0.00192 |
| Item page details (only with Include item details, also for catalogue item links; only when the details were added) | $0.00253 | $0.0022 | $0.001716 | $0.00132 |

Examples at Bronze prices:

- **100 products from a keyword search**: $0.001 + 100 × $0.0032 = **about $0.32**.
- **100 products with item details**: $0.001 + 100 × ($0.0032 + $0.0022) = **about $0.54**.
- **1,000 products from 10 keywords**: $0.001 + 1,000 × $0.0032 = **about $3.20**.

**Maximum cost per run:** the Actor charges for each product before saving it and stops when your maximum cost per run is reached, so you never get rows beyond your budget. If the budget covers a product but not its item details, that last product is saved with listing fields only and only the product is charged.

Platform usage (compute and proxy) is included in these event prices; a typical 100-product run uses well under one cent of platform resources. Apify's free plan includes monthly credit, enough for several thousand products.

### How to scrape Taobao products

1. Open the Actor and enter one or more **Search terms**, for example `蓝牙耳机` (Bluetooth earphones). Chinese keywords reach far more products.
2. Optionally add **Category IDs**, **Shop IDs** or catalogue links.
3. Set **Maximum products** (shared between all inputs).
4. Keep **Deep scan** on to go beyond the first page.
5. Turn on **Include item details** if you need seller profiles and review summaries.
6. Click **Start**, then download the results as JSON, CSV, Excel or HTML, or read them through the API.

### Input parameters

| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| `searchTerms` | array of strings | – | Keywords to search in the Taobao catalogue. |
| `categoryIds` | array of strings | – | Numeric category IDs, e.g. `1512`. |
| `shopIds` | array of strings | – | Numeric shop IDs (the `shopId` field of results). |
| `startUrls` | array of URLs | – | Catalogue keyword, category, shop (`/list/dianpu/<id>.htm`) or item (`/list/item/<code>.htm`) links. |
| `maxItems` | integer | `100` | Maximum products in total, shared equally between inputs. |
| `deepScan` | boolean | `true` | Also read price bands and sort orders for more unique products. |
| `includeDetails` | boolean | `false` | Add seller and review details from each product's item page. Also applies to catalogue item links given as input. |
| `minPrice`, `maxPrice` | integer (CNY) | – | Keep only products in this yuan price range. |

Example input:

```json
{
    "searchTerms": ["蓝牙耳机", "保温杯"],
    "shopIds": ["72104903"],
    "maxItems": 200,
    "deepScan": true,
    "includeDetails": true,
    "minPrice": 30,
    "maxPrice": 500
}
```

### Output example

One product with item details (real output, review text shortened):

```json
{
    "itemId": "1079352038299",
    "itemCode": "RjRZL1NqR2pVTkxHOTFNTUIvZU8wZz09",
    "title": "爱国者蓝牙耳机半入耳式2026新款降噪高音质无线运动超长续航游戏",
    "url": "https://www.taobao.com/list/item/RjRZL1NqR2pVTkxHOTFNTUIvZU8wZz09.htm",
    "taobaoUrl": "https://item.taobao.com/item.htm?id=1079352038299",
    "price": 118,
    "currency": "CNY",
    "listPrice": 118,
    "priceHkd": 140.41,
    "priceTwd": 584.21,
    "discountType": null,
    "image": "https://img.alicdn.com/imgextra/i3/2215824413675/O1CN01E5GhXKqZBrE1chua_!!4611686018427384811-0-item_pic.jpg",
    "shopId": "503709453",
    "shopName": "腔调会员精选旗舰店",
    "categoryId": "50005050",
    "rootCategoryId": "50011972",
    "descriptionScore": 4.91,
    "freeShipping": false,
    "areaLimited": false,
    "shopScores": { "description": 4.9, "service": 4.9, "delivery": 4.9 },
    "position": 1,
    "sourceType": "search",
    "sourceInput": "蓝牙耳机",
    "searchSlice": null,
    "detailsIncluded": true,
    "platform": "tmall",
    "location": "上海",
    "categoryPath": ["影音视听", "耳机耳放", "耳机"],
    "originalPrice": 118,
    "promotionPrice": 118,
    "sellerType": "B",
    "sellerCreditLevel": 19,
    "shopOpenedAt": "2023-05-08",
    "shopItemCount": 1707,
    "paymentMethods": ["蚂蚁花呗", "信用卡支付", "集分宝"],
    "reviewCount": "3000+",
    "reviewHighlights": [
        { "tag": "声音质量好", "count": 99 },
        { "tag": "续航能力强", "count": 72 }
    ],
    "latestReview": { "rating": 5, "text": "声音挺清晰的。价格实惠，很快收到", "date": "2026-10-04", "variant": "商品规格:黑色" },
    "detailError": null,
    "scrapedAt": "2026-11-03T07:19:31.570Z"
}
```

A `SUMMARY` record in the run's key-value store lists, per input, how many pages were read, how many products were saved and any input Taobao had no page for.

### Tips and limits

- **Use Chinese keywords.** Taobao does not translate searches; `phone case` only matches titles that contain those English words.
- **Titles are in Simplified Chinese**, as the sellers wrote them. Translate them downstream if needed.
- **Prices are in yuan.** HKD and TWD values are Taobao's own conversions.
- **Signed-out limits:** Taobao shows 20 products per keyword or category page and 60 per shop page. Deep scan multiplies this with price bands and sort orders, but it cannot list a whole category of 100,000 products.
- **No SKU matrix.** The public catalogue does not publish per-variant prices, stock or full descriptions.
- **Numeric item links are not supported** (`item.taobao.com/item.htm?id=...`, `detail.tmall.com/...`). Use the catalogue item link from a result's `url`, or search for the product or its shop.
- **Unknown inputs**: a keyword with no matches or a shop ID that does not exist returns no products and is not charged; the log and `SUMMARY` say which input had no page.
- **Item details are best effort.** If an item page cannot be loaded, the product is still saved with listing fields, `detailsIncluded: false` and a `detailError` message. Such a product is billed as a product only, without the item-details fee. After 5 item pages fail in a row, the Actor stops opening item pages for the rest of the run and saves listing fields only.
- **Catalogue item links given as input** return the item page's shortened title and no HKD/TWD prices. Results from keyword, category and shop listings keep the full title and all prices.
- If one deep-scan page cannot be loaded after several retries, the Actor skips that page, keeps everything else and logs it.

### Integrations

- **Weekly price tracking** – schedule the Actor with your keywords or shop IDs and send the dataset to Google Sheets to see price changes week over week.
- **Supplier shortlists** – filter by `sellerType`, `shopScores` and `reviewCount` to shortlist reliable shops before contacting them.
- **Listing research** – push results to Airtable or a database and match Taobao prices against your own store's prices.
- **Alerts** – use Make, Zapier or n8n to post to Slack when a product's `price` drops below a threshold.
- **Webhooks** – trigger your own pipeline when a run finishes.

### Use the Taobao scraper through the API

cURL:

```bash
curl -X POST "https://api.apify.com/v2/acts/automation-lab~taobao-overseas-public-catalogue-products-and-prices/run-sync-get-dataset-items?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms":["蓝牙耳机"],"maxItems":50}'
```

JavaScript:

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

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });
const run = await client.actor('automation-lab/taobao-overseas-public-catalogue-products-and-prices').call({
    searchTerms: ['蓝牙耳机'],
    maxItems: 50,
    includeDetails: true,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.map((p) => `${p.title} – ¥${p.price}`));
```

Python:

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("automation-lab/taobao-overseas-public-catalogue-products-and-prices").call(
    run_input={"searchTerms": ["保温杯"], "maxItems": 50, "minPrice": 30, "maxPrice": 150}
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["title"], item["price"], item["shopName"])
```

### Use it with AI agents through MCP

Add the Actor to Claude Code:

```bash
claude mcp add --transport http apify \
  "https://mcp.apify.com?tools=automation-lab/taobao-overseas-public-catalogue-products-and-prices"
```

Or add this to the JSON configuration of Claude Desktop, Cursor or VS Code:

```json
{
    "mcpServers": {
        "apify": {
            "url": "https://mcp.apify.com?tools=automation-lab/taobao-overseas-public-catalogue-products-and-prices"
        }
    }
}
```

Selecting this Actor also adds the run, dataset and key-value store tools (`get-actor-run`, `get-dataset-items`, `get-key-value-store-record`, `abort-actor-run`), so the server exposes more than one tool. Check the exact tool names and arguments with `tools/list` and use only the ones you need.

A reliable way for an agent to go from a run to results:

1. **Start the run once** and keep the returned run ID and `defaultDatasetId`. `call-actor` waits at most 45 seconds (default 30), so a larger scrape may still be running when it returns. Set your client's request timeout above that wait plus a few seconds.
2. **Follow that same run.** While it is `READY` or `RUNNING`, call `get-actor-run` for the same run ID with growing pauses (for example 2, 4, 8, then every 10 seconds) up to a deadline you choose, for example 120 seconds. Never start a new run just to check progress. If the client times out, check the run ID you already have. At the deadline, report that the run is still pending, with its run ID, and stop.
3. **Handle the end state honestly.** `SUCCEEDED` means you can read results. `FAILED`, `ABORTED` or `TIMED-OUT` means report the failure and its status message; any rows already saved are a partial result, not the full answer.
4. **Read results in bounded pages.** Call `get-dataset-items` with that dataset ID, an explicit `limit`, `offset` and only the `fields` you need (for example `title,price,shopName,url`). A sensible budget is pages of 20 rows from offset 0, at most 100 rows and at most 64 KiB of result text in total, whichever comes first. Measure the size of each page before giving it to the model; if a page or a row is too large, shorten or leave it out and say so.
5. **Say when the result is partial.** When you stop at the budget, report how many rows you read, the next `offset` to continue from and that more rows exist. For full exports, download the dataset (JSON, CSV or Excel) outside the chat instead of reading it all into the conversation.

These budget numbers are example choices for keeping an agent's context small, not Apify limits; they do not reduce what the Actor collects.

Example prompts:

- "Find 50 Bluetooth earphones (蓝牙耳机) on Taobao between 100 and 300 yuan and list the shops with the best service scores."
- "Get the products of Taobao shop 72104903 and tell me the cheapest five."
- "Compare Taobao prices for 保温杯 from Tmall shops versus individual sellers."

### Is it legal to scrape Taobao?

This Actor reads only public catalogue pages that Taobao publishes for search engines and overseas visitors, without logging in. It does not collect buyers' personal data; review authors appear masked (`***`) on Taobao and are not exported. You are responsible for how you use the data: respect Taobao's terms, copyright in product images and descriptions, and the data-protection laws that apply to you. If unsure, ask a lawyer.

Taobao and Tmall are trademarks of Alibaba Group. This Actor is independent and not affiliated with or endorsed by them.

**Error diagnostics:** when an operation fails, the Actor sends sanitized diagnostic input, the exception and the Actor/build/run IDs to our private GlitchTip error-tracking service so we can repair it. Secret fields and URL query strings are removed, and reports are retained for 30 days.

### FAQ

**Why do I get only 20 products for my keyword?**
Turn on **Deep scan** (on by default). If it is on and you still see few products, the keyword has few matches in the catalogue; try a broader or Chinese keyword.

**Why did my item link fail?**
Numeric item links (`item.taobao.com/item.htm?id=...`) are not shown to signed-out visitors, so the Actor stops with a message. Use the `url` field from an earlier result (`www.taobao.com/list/item/<code>.htm`) or search for the product.

**Why is `reviewHighlights` empty for some products?**
Taobao only publishes review highlights for products with enough reviews. New products have none.

**Can I get prices in US dollars?**
The Actor returns CNY plus Taobao's HKD and TWD conversions. Convert CNY to any currency downstream with your preferred rate.

**A run logged "Skipped one result slice". Is my data incomplete?**
Taobao occasionally refuses one filtered page. The Actor retries with new connections and then skips only that page. You still get every other product; rerun later if you need the extra slice.

### Related Actors

- [1688 Scraper](https://apify.com/automation-lab/1688-scraper) – wholesale prices and suppliers from Alibaba's Chinese B2B marketplace.
- [AliExpress Products Scraper](https://apify.com/automation-lab/aliexpress-products-scraper) – retail prices for products shipped from China.
- [Alibaba Products Scraper](https://apify.com/automation-lab/alibaba-products-scraper) – international B2B product listings and suppliers.

# Changelog

This Actor's version history is a separate document: https://apify.com/automation-lab/taobao-overseas-public-catalogue-products-and-prices/changelog.md

# Actor input Schema

## `searchTerms` (type: `array`):

Keywords to look up in the Taobao catalogue, one per line. Chinese keywords (for example 蓝牙耳机) reach far more products than English ones, because Taobao does not translate searches.

## `categoryIds` (type: `array`):

Numeric Taobao category IDs, for example 1512 for mobile phones. You find them in the categoryId field of earlier results or in links such as www.taobao.com/list/category/1512.htm.

## `shopIds` (type: `array`):

Numeric Taobao or Tmall shop IDs (the shopId field of results). Each shop returns up to 60 products per sort order.

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

Taobao catalogue links: keyword pages (www.taobao.com/list/product/<keyword>.htm), category pages (/list/category/<id>.htm), shop pages (/list/dianpu/<shopId>.htm) or item pages (/list/item/<code>.htm). world.taobao.com versions of these links also work. Numeric item.taobao.com or detail.tmall.com links are not supported, because Taobao does not show them to signed-out visitors.

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

Maximum number of products to save in total. With several inputs, the limit is shared between them.

## `deepScan` (type: `boolean`):

Taobao shows signed-out visitors one page per listing (20 products per keyword or category, 60 per shop). When on, the Actor also reads the listing in price bands and other sort orders, which usually gives 100-200 unique products per keyword. Turn off to read only the first page.

## `includeDetails` (type: `boolean`):

Also open each product's catalogue page to add the Taobao/Tmall type, ship-from location, category path, original and promotion price, seller profile and service scores, payment methods, review count, review highlights and the latest review. Applies to catalogue item links given as input too. Charged as an extra event only for products saved with these details; if an item page cannot be loaded, the product is saved with listing fields and a detailError.

## `minPrice` (type: `integer`):

Only save products that cost at least this many yuan.

## `maxPrice` (type: `integer`):

Only save products that cost at most this many yuan.

## Actor input object example

```json
{
  "searchTerms": [
    "蓝牙耳机"
  ],
  "maxItems": 20,
  "deepScan": true,
  "includeDetails": false
}
```

# Actor output Schema

## `overview` (type: `string`):

All saved products with listing fields: title, CNY/HKD/TWD price, price label, shop, category and source input.

## `details` (type: `string`):

The same products with item-page fields: Taobao or Tmall, ship-from location, seller profile, shop scores and review summary.

## `summary` (type: `string`):

Per-input page and product counts, inputs Taobao had no page for, and request statistics.

# 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 = {
    "searchTerms": [
        "蓝牙耳机"
    ],
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("automation-lab/taobao-overseas-public-catalogue-products-and-prices").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 = {
    "searchTerms": ["蓝牙耳机"],
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("automation-lab/taobao-overseas-public-catalogue-products-and-prices").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 '{
  "searchTerms": [
    "蓝牙耳机"
  ],
  "maxItems": 20
}' |
apify call automation-lab/taobao-overseas-public-catalogue-products-and-prices --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,automation-lab/taobao-overseas-public-catalogue-products-and-prices"
        }
    }
}
```

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/T1PsGROAAK91kuOKK/builds/WJaVz8qG00SvQT7OH/openapi.json
