# 1688.com Scraper (`automation-lab/1688-scraper`) Actor

Scrape product listings from 1688.com — Alibaba's B2B domestic wholesale platform. Extract factory-direct prices, tiered bulk pricing, MOQ, supplier quality scores, and order counts by keyword.

- **URL**: https://apify.com/automation-lab/1688-scraper.md
- **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community)
- **Categories:** E-commerce
- **Stats:** 111 total users, 10 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 3.00 out of 5 stars

## Pricing

from $2.40 / 1,000 product 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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## 1688.com Scraper — B2B Wholesale Product Extractor

### What does it do?

This actor scrapes **1688.com** — Alibaba's B2B domestic marketplace and China's largest wholesale platform. Search listings by keyword, or submit saved product URLs / offer IDs to collect sourcing-grade details such as MOQ, every quantity-price tier, gallery images, attributes, supplier, and dispatch location.

The two additive input modes are:

- **Keyword search:** fast discovery with title, URL, thumbnail, list price, supplier, and order count where shown. Anonymous searches usually return up to about 40 listings per keyword; optional logged-in cookies enable the browser-search route.
- **Product details:** one enriched row per unique `productUrls` offer. This mode uses 1688.com's public mobile product surface through the configured proxy and does not require account cookies.

Available fields include:

- 💰 **Factory-direct prices** in CNY + USD equivalent
- 📦 **MOQ & tiered bulk pricing** — see price breaks at different volumes
- 🏭 **Supplier information** — name, location, performance scores
- 📊 **Demand metrics** — order count and repurchase rate
- 🏅 **Supplier quality scores** — logistics, goods quality, dispute resolution

***

### Who is it for?

#### 🚀 Dropshippers & Product Sourcers

Find products at factory-direct prices (typically 30–60% lower than Alibaba international). Validate demand with real order counts before placing bulk orders.

#### 📦 Amazon FBA Sellers

Identify high-potential products by filtering for items with 500+ orders. Compare factory prices against Amazon selling prices to calculate exact margins before sourcing.

#### 🔍 Competitive Intelligence Analysts

Monitor competitor product catalogs, track price changes over time, and identify trending categories in the Chinese wholesale market.

#### 💼 B2B Procurement Teams

Automate supplier discovery. Search for specific product types, filter by supplier quality scores, and build a shortlist of pre-vetted manufacturers.

#### 📈 E-commerce Entrepreneurs & AI Developers

Build product databases, train price prediction models, or feed AI pipelines with real wholesale pricing data from China's largest B2B platform.

***

### Why use this scraper?

- ✅ **Extracts data competitors don't** — tiered bulk pricing tiers, supplier score breakdowns, repurchase rates
- ✅ **Fresh data** — scrapes live 1688.com listings, not cached datasets
- ✅ **Structured output** — clean JSON/CSV ready for spreadsheets or databases
- ✅ **Numeric fields** — prices as numbers (not strings), scores as decimals
- ✅ **Anonymous by default** — reads 1688.com's public market index; optional logged-in cookies enable full browser search
- ✅ **Multi-keyword support** — run multiple product searches in a single job
- ✅ **Direct offer collection** — pass product URLs or numeric offer IDs for MOQ, full price ladders, images, attributes, and service terms

***

### What data does it extract?

| Field | Description | Example |
|-------|-------------|---------|
| `productId` | 1688 listing ID | `549929725456` |
| `title` | Product title (Chinese) | `TWS无线蓝牙耳机5.0` |
| `url` | Direct product URL | `https://detail.1688.com/offer/...` |
| `thumbnailUrl` | Main product image | `https://cbu01.alicdn.com/...` |
| `imageUrls` | Full product gallery (detail mode) | `["https://cbu01.alicdn.com/..."]` |
| `priceCny` | Price in CNY (numeric) | `28.50` |
| `priceUsd` | Approx USD price | `3.93` |
| `moq` | Minimum order quantity (detail mode) | `10` |
| `unit` | Seller's order unit (detail mode) | `个` |
| `currency` | Always "CNY" | `CNY` |
| `supplierName` | Factory/supplier name | `深圳市XX电子有限公司` |
| `supplierId` | Seller member ID | `b2b-2582465574` |
| `supplierUrl` | Supplier storefront URL | `https://winport.m.1688.com/...` |
| `location` | Seller dispatch location (detail mode) | `广东深圳` |
| `province` | Province (Chinese) | `广东` |
| `city` | City (Chinese) | `深圳市` |
| `orderCount` | Total orders placed | `2547` |
| `repurchaseRate` | Customer repurchase % | `18%` |
| `compositeScore` | Overall supplier rating (0–5) | `4.2` |
| `logisticsScore` | Shipping performance (0–5) | `4.5` |
| `goodsScore` | Product quality rating (0–5) | `4.0` |
| `disputeScore` | Dispute resolution (0–5) | `4.3` |
| `consultationScore` | Customer service (0–5) | `4.1` |
| `returnScore` | Return processing (0–5) | `4.4` |
| `quantityPrices` | Complete seller quantity-price ladder (detail mode) | `[{quantity: "1-99", priceCny: 28.5}]` |
| `attributes` | Seller-provided product specifications (detail mode) | `[{name: "材质", value: "亚克力"}]` |
| `serviceTags` | Service terms (Chinese) | `["退货包运费", "先采后付"]` |
| `productBadges` | Certifications/badges | `["认证工厂", "实力商家"]` |
| `searchKeyword` | Search term, or `null` for direct detail inputs | `"phone case"` |
| `scrapedAt` | ISO 8601 timestamp | `2026-04-01T12:00:00Z` |

#### Field availability by mode

Keyword rows reflect fields exposed by the selected search surface. Anonymous public-index rows reliably include the product identity, URL, image, list price, supplier, order count, and keyword, but may leave MOQ, tiers, location, ratings, and badges empty. Direct `productUrls` rows are the sourcing-detail mode: they populate MOQ, the seller's quantity-price ladder, gallery images, attributes, supplier, dispatch location, and service terms when 1688 exposes them. Supplier rating fields remain nullable because the public product surface does not consistently publish them.

***

### 💰 How much does it cost to scrape 1688.com products?

This actor uses **Pay Per Event (PPE)** pricing — you only pay for what you scrape:

| Event | FREE Plan | BRONZE | SILVER | GOLD | PLATINUM | DIAMOND |
|-------|-----------|--------|--------|------|----------|---------|
| Run start | $0.020 | $0.019 | $0.017 | $0.015 | $0.012 | $0.010 |
| Per product | $0.0040 | $0.0036 | $0.0030 | $0.0024 | $0.0016 | $0.0011 |

**Example costs:**

- Scrape 50 products: ~$0.22 (FREE tier)
- Scrape 200 products: ~$0.82
- Scrape 1,000 products: ~$4.02

**Free trial:** New Apify accounts include a $5 free credit — enough to scrape 1,000+ products.

**Tip:** Use Apify's subscription plans for volume discounts (up to 72% off at DIAMOND tier).

***

### How to scrape 1688.com products

#### Step 1: Open the actor

Go to [1688.com Scraper](https://apify.com/automation-lab/1688-scraper) on Apify Store.

#### Step 2: Choose an input mode

For discovery, enter Chinese or English `keywords` such as `手机壳` or `bluetooth earbuds`. For specific products, paste one or more 1688 offer URLs or numeric IDs into `productUrls`. You can combine both modes in one run. A completely empty input retains the useful `手机壳` keyword default.

```json
{
  "productUrls": [
    "https://detail.1688.com/offer/711729262606.html",
    "943456237066"
  ]
}
```

Duplicate references to the same offer are collected and charged only once. Non-1688 URLs and malformed IDs fail input validation before scraping.

#### Step 3: Set max results

Set `maxResults` to control how many products to extract per keyword. Default is 48 (one page).

#### Step 4: Add session cookies (optional)

The default input needs no credentials and returns up to 40 listings per keyword from 1688.com's public market index. Add logged-in cookies to use the full browser search route (including larger result limits and sort controls). In Chrome/Edge:

1. Go to [www.1688.com](https://www.1688.com) and log in
2. Press F12 → Network tab → reload the page
3. Click any request to 1688.com → copy the `Cookie` header value
4. Paste the full cookie string into the **Session Cookies** field

#### Step 5: Choose sort order (authenticated route)

Sort controls apply when logged-in cookies enable the full browser-search route. Anonymous public-index runs use the market index's order.

- **Best Selling** (recommended) — finds proven products with high demand
- **Price: Low to High** — cheapest factory prices first
- **Default** — relevance sorting

#### Step 6: Run and export

Click "Start" and wait for results. Export to JSON, CSV, or Excel from the Results tab.

***

### Input parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `keywords` | array | empty input uses `["手机壳"]` | Optional search keywords (Chinese or English) |
| `productUrls` | array | optional | 1688 product URLs or numeric offer IDs for detail collection |
| `cookies` | string | optional | Logged-in 1688.com cookies that can improve access when an anonymous session is blocked |
| `maxResults` | integer | 48 | Max products per keyword (up to 500) |
| `sortType` | string | `bestSelling` | Authenticated browser route only: `default`, `bestSelling`, `priceLow`, `priceHigh` |
| `proxyConfiguration` | object | CN residential | Used by product-detail collection and the optional authenticated browser-search route; anonymous keyword search uses direct HTTP |

#### Sort type options

| Sort Type | Value | Best for |
|-----------|-------|----------|
| Best Selling | `bestSelling` | Finding proven high-demand products |
| Price Low | `priceLow` | Finding cheapest factory prices |
| Price High | `priceHigh` | Premium/high-value products |
| Default | `default` | Relevance-based results |

***

### Output example

```json
{
  "productId": "549929725456",
  "title": "TWS无线蓝牙耳机5.0降噪运动",
  "url": "https://detail.1688.com/offer/549929725456.html",
  "thumbnailUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01.../image.jpg",
  "imageUrls": [
    "https://cbu01.alicdn.com/img/ibank/O1CN01.../image.jpg",
    "https://cbu01.alicdn.com/img/ibank/O1CN02.../image.jpg"
  ],
  "priceCny": 28.50,
  "priceUsd": 3.93,
  "moq": 10,
  "unit": "个",
  "currency": "CNY",
  "supplierName": "深圳市鸿达电子科技有限公司",
  "supplierId": "b2b-2582465574fd1bb",
  "supplierUrl": "https://winport.m.1688.com/page/index.html?memberId=b2b-2582465574fd1bb",
  "location": "广东深圳",
  "province": "广东",
  "city": "深圳市",
  "orderCount": 2547,
  "repurchaseRate": "18%",
  "compositeScore": 4.2,
  "logisticsScore": 4.5,
  "goodsScore": 4.0,
  "disputeScore": 4.3,
  "consultationScore": 4.1,
  "returnScore": 4.4,
  "quantityPrices": [
    { "quantity": "1~99件", "minQty": 1, "priceCny": 28.50, "priceUsd": 3.93 },
    { "quantity": "100~499件", "minQty": 100, "priceCny": 24.00, "priceUsd": 3.31 },
    { "quantity": "≥500件", "minQty": 500, "priceCny": 19.50, "priceUsd": 2.69 }
  ],
  "attributes": [
    { "name": "材质", "value": "亚克力" },
    { "name": "品牌", "value": "示例品牌" }
  ],
  "serviceTags": ["退货包运费", "先采后付"],
  "productBadges": ["认证工厂", "实力商家"],
  "searchKeyword": null,
  "scrapedAt": "2026-04-01T12:34:56.789Z"
}
```

***

### Tips for best results

#### 🔍 Search tips

- **Use Chinese keywords** for more results (1688 is a Chinese-language platform)
- Combine searches: `["手机壳", "phone case"]` gets overlapping results for more coverage
- Broad keywords work best: `耳机` (earphones) vs a specific model number

#### 📊 Finding winning products

1. Use `sortType: "bestSelling"` to find proven sellers
2. Filter for `orderCount >= 500` — high orders = proven demand
3. Check `repurchaseRate` — 10%+ indicates satisfied customers
4. Verify `compositeScore >= 4.0` for reliable suppliers

#### 🏭 Evaluating suppliers

- `compositeScore 4.0–5.0` = Excellent (recommended)
- `compositeScore 3.0–3.9` = Good (proceed with caution)
- `compositeScore < 3.0` = Below average (higher risk)
- `logisticsScore` = Shipping reliability
- `goodsScore` = Product quality consistency

#### 💰 Calculating margins

Use `quantityPrices` to find your break-even MOQ. Example:

- 1–99 units: ¥28.50 ($3.93) each
- 100+ units: ¥24.00 ($3.31) each — 15% discount for bulk
- 500+ units: ¥19.50 ($2.69) each — 31% bulk discount

#### ⚙️ Service tags reference (Chinese → English)

- `退货包运费` = Free return shipping
- `先采后付` = Buy now, pay later
- `7天无理由退货` = 7-day no-reason returns
- `假一赔四` = Counterfeit product 4x refund guarantee

***

### Integrations

#### 🤖 AI/LLM sourcing pipeline

Feed 1688.com data into an AI system to automate product research:

```
1688 Scraper → GPT-4 analyzer → Supplier shortlist → Order automation
```

#### 📊 Price monitoring workflow

Schedule daily runs to track wholesale price changes:

```
1688 Scraper (daily) → Database → Price alert when > 10% change
```

#### 🔗 Apify integrations

Connect to 500+ apps via [Apify integrations](https://apify.com/integrations):

- **Google Sheets** — auto-update a product research spreadsheet
- **Zapier/Make** — trigger downstream workflows
- **Slack** — notify your team when new products meet criteria
- **Airtable** — build a sourcing CRM with supplier contacts

***

### API usage

#### Node.js

```javascript
const { ApifyClient } = require('apify-client');
const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('automation-lab/1688-scraper').call({
    productUrls: [
        'https://detail.1688.com/offer/711729262606.html',
        '943456237066',
    ],
});

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

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient('YOUR_API_TOKEN')

run = client.actor('automation-lab/1688-scraper').call(run_input={
    'keywords': ['phone case', 'bluetooth earbuds'],
    'maxResults': 100,
    'sortType': 'bestSelling',
})

items = client.dataset(run['defaultDatasetId']).list_items().items
print(f"Scraped {len(items)} products")
for item in items[:3]:
    print(f"{item['title']} — ¥{item['priceCny']} | Orders: {item['orderCount']}")
```

#### cURL

```bash
curl -X POST "https://api.apify.com/v2/acts/automation-lab~1688-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "keywords": ["phone case"],
    "maxResults": 50,
    "sortType": "bestSelling"
  }'
```

***

### Use with Claude (MCP)

Connect this actor to Claude via the **Model Context Protocol (MCP)** to research 1688.com products conversationally.

#### Claude Code setup

```bash
claude mcp add --transport http apify https://mcp.apify.com?tools=automation-lab/1688-scraper
```

#### Claude Desktop / VS Code / Cursor setup

Add to your MCP config (Claude Desktop on macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "apify": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=automation-lab/1688-scraper",
      "headers": {
        "Authorization": "Bearer YOUR_APIFY_TOKEN"
      }
    }
  }
}
```

#### Example prompts for Claude

Once connected, you can ask Claude:

> "Find the top 20 best-selling phone accessories on 1688.com with prices under ¥50 and at least 500 orders"

> "Search 1688.com for 'led strip lights' and summarize the price range, MOQ, and which provinces the suppliers are from"

> "Compare 50 bluetooth earbuds on 1688.com — which have composite scores above 4.0 and what are their prices?"

> "Find 30 products in the 'portable charger' category and calculate potential Amazon FBA margins assuming 3x markup"

***

### Legality: is scraping 1688.com legal?

Web scraping publicly accessible product listings for personal use, research, and non-commercial purposes is generally considered legal in most jurisdictions. This actor scrapes publicly accessible product data (no private data, no user accounts accessed beyond your own session).

**Important:**

- 1688.com's Terms of Service may restrict automated access. Review their ToS before large-scale use.
- This actor does not scrape personal information, messages, or account data.
- Data is intended for research and business intelligence — not for republishing competitor supplier lists or for spamming.
- Apify's [Responsible Data Collection Policy](https://apify.com/legal/responsible-scraping) applies.

***

### FAQ

**Q: Does this actor require a 1688.com account?**
A: No. Without cookies, the actor reads up to 40 listings per keyword from 1688.com's public market index. You can optionally provide cookies from your own account to enable the full browser search route.

**Q: Why are titles in Chinese?**
A: 1688.com is a Chinese-language platform. All product titles, service tags, and location data are in Simplified Chinese. You can use a translation API to convert them.

**Q: What currency are prices in?**
A: Prices are extracted in CNY (Chinese Yuan). The `priceUsd` field provides an approximate USD equivalent using a fixed rate (~0.138 USD/CNY). Verify current rates before financial decisions.

**Q: The actor returned 0 results for my keyword. Why?**
A: This can happen when:

1. The keyword has no results on 1688.com (try a broader term or Chinese equivalent)
2. Anti-bot protection blocked the upstream response (retry once; logged-in cookies may improve access)
3. A transient network or upstream response issue — retry once after a few minutes

**Q: Can I scrape product detail pages for more data?**
A: Yes. Add 1688 offer URLs or numeric IDs to `productUrls`. Detail rows include MOQ, the complete quantity-price ladder shown by the seller, gallery images, attributes, supplier, dispatch location, and service terms when available. `searchKeyword` is `null` for these direct inputs.

**Q: How many results can I get per keyword?**
A: Anonymous runs return up to about 40 products per keyword from the public market index. With logged-in cookies, the browser-search route can return up to 500 products per keyword.

**Q: Do I need a Chinese proxy?**
A: Not for the default anonymous route, which reads the public market index over direct HTTP. The CN residential proxy setting is used only when you provide logged-in cookies and enable the full browser-search route.

***

### Related scrapers

- [Alibaba.com Scraper](https://apify.com/automation-lab/alibaba-scraper) — International wholesale listings
- [AliExpress Scraper](https://apify.com/automation-lab/aliexpress-scraper) — Consumer-facing retail prices
- [Temu Scraper](https://apify.com/automation-lab/temu-scraper) — Cross-border e-commerce platform
- [Amazon Product Scraper](https://apify.com/automation-lab/amazon-scraper) — Calculate FBA margins from source to sale
- [Amazon Reviews Scraper](https://apify.com/automation-lab/amazon-reviews-scraper) — Validate product demand with buyer feedback

# Actor input Schema

## `keywords` (type: `array`):

Optional product keywords to search on 1688.com. Chinese or English keywords both work. Leave empty when collecting specific product URLs. An empty input still searches for 手机壳.

## `productUrls` (type: `array`):

Optional 1688.com product URLs or numeric offer IDs. Each unique offer returns a detail row with MOQ, the full quantity-price ladder, supplier, location, images, product attributes, and service terms when available.

## `maxResults` (type: `integer`):

Maximum number of products to extract per keyword. One page typically has 44-48 products.

## `sortType` (type: `string`):

How to sort search results. 'Best Selling' is recommended for finding proven products.

## `cookies` (type: `string`):

Optional logged-in 1688.com session cookies. Without cookies, the actor reads 1688.com's public market index; cookies enable the full browser search route. In Chrome/Edge: open 1688.com, log in, press F12 → Network tab → reload → click any request to 1688.com → copy the 'Cookie' header value.

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

Used for product-detail collection and the optional logged-in browser-search route. Anonymous keyword searches use direct HTTP and ignore this setting.

## Actor input object example

```json
{
  "keywords": [
    "手机壳"
  ],
  "productUrls": [
    "https://detail.1688.com/offer/711729262606.html"
  ],
  "maxResults": 10,
  "sortType": "bestSelling",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "CN"
  }
}
```

# Actor output Schema

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

Dataset containing the scraped 1688.com products.

# 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 = {
    "keywords": [
        "手机壳"
    ],
    "productUrls": [
        "https://detail.1688.com/offer/711729262606.html"
    ],
    "maxResults": 10,
    "sortType": "bestSelling",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "CN"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("automation-lab/1688-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 = {
    "keywords": ["手机壳"],
    "productUrls": ["https://detail.1688.com/offer/711729262606.html"],
    "maxResults": 10,
    "sortType": "bestSelling",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "CN",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("automation-lab/1688-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 '{
  "keywords": [
    "手机壳"
  ],
  "productUrls": [
    "https://detail.1688.com/offer/711729262606.html"
  ],
  "maxResults": 10,
  "sortType": "bestSelling",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "CN"
  }
}' |
apify call automation-lab/1688-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,automation-lab/1688-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/pm41wTnN9V5snf3ES/builds/Ik6OYv6ry7NaXBiHs/openapi.json