# 1688 Scraper 🛒 $0.9/1k (`123webdata/1688-scraper`) Actor

$0.9/1k 💰 | Fast ⚡️ | Quick Support 🚀 | Scrape 1688 search and product pages; get prices, minimum order terms, suppliers, and product images. Export JSON or CSV for wholesale sourcing and market research.

- **URL**: https://apify.com/123webdata/1688-scraper.md
- **Developed by:** [123 Webdata](https://apify.com/123webdata) (community)
- **Stats:** 1 total users, 0 monthly users, 87.5% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.80 / 1,000 results

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

## 1688 Scraper

Collect structured wholesale product data from 1688 product and search URLs. Very high data coverage: up to 21 fields are available for each product.

### Issues and feature requests

If you encounter an issue or need a field added, open an issue on the Actor page or write to hello@123webdata.com.

### Output Example (simplified)

The overview shows the most useful fields in a table. Product images are displayed as thumbnails when the website provides them.

| Image | Product URL | Product ID | Product name | Current price | Maximum price | Minimum order | Order unit | Currency | In stock | Brand | Seller | Scraped at |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| <img src="https://cbu01.alicdn.com/img/ibank/O1CN01sF5m8q1PzkOUN636m_!!2213787731912-0-cib.jpg" style="max-width: 100px; max-height: 100px; object-fit: contain;"> | https://detail.1688.com/offer/1010672633131.html | 1010672633131 | M17 Pro Max跨境新款7.3寸incell屏3+16G安卓智能4G全网通手机 | 265 | 265 | 1 | 部 | CNY |  | LANDVO/朗达沃（办公用品） | 深圳市流虹电子商务有限公司 | 2026-08-26T22:10:59.030Z |

### How to scrape supported list pages

This Actor accepts individual product links in `productUrls`. It accepts search result pages in `categoryUrls`.

1. Open a supported list page in your browser.
2. Run a search you need.
3. Copy the final URL from the address bar and paste it into `categoryUrls`.

The Actor follows the products shown on that page.

Add one or more List URLs to scrape. `categoryUrls` is labelled **List URLs** in the Console and accepts search result pages.

#### Scrape 1688 Search Pages

Pass a search results URL and the Actor collects the products that match your query. Example: https://s.1688.com/selloffer/offer_search.htm?keywords=%E6%89%8B%E6%9C%BA

The `scrapeProductDetails` option (labelled Include product details) decides what each List URL produces. When it is enabled, the Actor visits each product page and returns the full detail records; when it is disabled, the Actor returns one list-level record per product card with the fields that are always included.

### Features

- Scrapes detailed wholesale product information from 1688 product pages
- Accepts individual product URLs and search result pages
- Lets you limit the number of saved products and choose whether to continue through additional result pages
- Returns structured prices, minimum order terms, suppliers, product images, and variants for viewing, export, and analysis

### Pricing

This Actor uses pay-per-event pricing. Its running costs are included.

- **Actor start:** $0.02 once per run — One fixed charge for starting a run.
- **Result:** $0.00089 each ($0.89 per 1,000) — A product record collected directly from a supported list page.
- **Product detail:** $0.00199 each ($1.99 per 1,000) — A full product record collected from its product page.

The start charge applies once per run. Each saved product is charged either as a Result or a Product detail, never both.

| Results in one run | Result | Product detail |
| ---: | ---: | ---: |
| 100 | $0.11 | $0.22 |
| 1,000 | $0.91 | $2.01 |

[Apify's Free plan](https://apify.com/pricing) currently includes $5 in monthly usage credits. If the full $5 is available for this Actor, one run covers about 5,595 Results or 2,502 Product details. Other Apify usage reduces the available credit.

### Input

The Actor accepts the following input parameters:

| Field | Type | Description |
| --- | --- | --- |
| `productUrls` | array | Product URLs to scrape |
| `categoryUrls` | array | Supported list pages: search result pages |
| `maxResultsPerScrape` | integer | Maximum number of product records to save |
| `usePagination` | boolean | Whether to continue through additional result pages |
| `scrapeProductDetails` | boolean | If the Include product details option is enabled, the Actor visits each product page for the full detail record; if it is disabled, the Actor returns one list-level result record per product card. Both field lists are in "What data you get in each mode" below. |

### What data you get in each mode

Every saved product is stored as one record. `scrapeProductDetails` decides which mode you receive; the lists below name every field each mode can return. A field is empty when the website does not show that information.

#### Result

A list-level product record with 13 declared fields:

`url`, `product_id`, `name`, `price`, `currency`, `minimum_order_quantity`, `minimum_order_unit`, `main_image`, `images`, `seller_name`, `attributes`, `canonical_url`, `scraped_at`

#### Product detail

A full product record with 21 declared fields:

`url`, `product_id`, `name`, `price`, `max_price`, `currency`, `minimum_order_quantity`, `minimum_order_unit`, `in_stock`, `sku`, `brand`, `category`, `main_image`, `images`, `attributes`, `seller_name`, `seller_url`, `variants`, `rating_value`, `canonical_url`, `scraped_at`

### Output Example (full)

The Actor stores one structured record per product. Card-only records contain only fields available on the list; detail-only fields are omitted.

```json
{
  "url": "https://detail.1688.com/offer/1010672633131.html",
  "product_id": "1010672633131",
  "name": "M17 Pro Max跨境新款7.3寸incell屏3+16G安卓智能4G全网通手机",
  "price": 265,
  "max_price": 265,
  "currency": "CNY",
  "minimum_order_quantity": 1,
  "minimum_order_unit": "部",
  "in_stock": null,
  "sku": "1010672633131",
  "brand": "LANDVO/朗达沃（办公用品）",
  "category": null,
  "main_image": "https://cbu01.alicdn.com/img/ibank/O1CN01sF5m8q1PzkOUN636m_!!2213787731912-0-cib.jpg",
  "images": [
    "https://cbu01.alicdn.com/img/ibank/O1CN01sF5m8q1PzkOUN636m_!!2213787731912-0-cib.jpg",
    "https://cbu01.alicdn.com/img/ibank/O1CN01vRPKCr1PzkOUTlJwV_!!2213787731912-0-cib.jpg",
    "https://cbu01.alicdn.com/img/ibank/O1CN015sISgF1PzkOUAjoeB_!!2213787731912-0-cib.jpg",
    "https://cbu01.alicdn.com/img/ibank/O1CN01e1rxs61PzkOTIOS8V_!!2213787731912-0-cib.jpg",
    "https://cbu01.alicdn.com/img/ibank/O1CN01Oh3V2o1PzkOUX3Ozs_!!2213787731912-0-cib.jpg"
  ],
  "attributes": {
    "手机类型": "通用型",
    "操作系统": "Android/安卓",
    "运行内存": "3GB",
    "摄像头像素": "1200万-1999万",
    "电池容量": "3000mAh-3999mAh",
    "手机版本": "大陆行货",
    "外形": "直板",
    "货号": "M17 Pro Max",
    "型号": "M17 Pro Max",
    "主屏尺寸": "超大屏幕(6.0英寸及以上)",
    "网络制式": "GSM,联通3G(WCDMA)",
    "存储卡": "支持存储卡",
    "处理器核心": "四核",
    "售后类型": "店铺三包",
    "上市时间": "2026",
    "OEM": "可OEM",
    "适用送礼场合": "婚庆,生日,节日,乔迁,展销会,广告促销,员工福利,周年庆典,商务馈赠,开业典礼,颁奖纪念,公关策划",
    "3C证书编号": "2026011606847644",
    "CPU品牌": "联发科",
    "运营商": "中国移动,中国联通,中国电信",
    "网络模式": "双卡双模",
    "机身内存": "美规默认标配,欧规默认标配,英规默认标配,澳规默认标配",
    "颜色": "黑色【外贸版不支持国内使用】,紫色【外贸版不支持国内使用】,白色【外贸版不支持国内使用】,绿色【外贸版不支持国内使用】",
    "主要下游平台": "其他",
    "主要销售地区": "非洲,欧洲,南美,东南亚,北美,东北亚,中东",
    "有可授权的自有品牌": "否",
    "是否跨境出口专供货源": "是",
    "电信设备进网许可证编号": "02-H591-234148",
    "是否专利货源": "否",
    "location": "广东省深圳市"
  },
  "seller_name": "深圳市流虹电子商务有限公司",
  "seller_url": null,
  "rating_value": 5,
  "variants": [
    {
      "availability": 7994,
      "choices": "欧规默认标配&gt;绿色【外贸版不支持国内使用】",
      "price": 265,
      "sku": "6287237927587"
    },
    {
      "availability": 8000,
      "choices": "澳规默认标配&gt;黑色【外贸版不支持国内使用】",
      "price": 265,
      "sku": "6176980063912"
    },
    {
      "availability": 7999,
      "choices": "美规默认标配&gt;黑色【外贸版不支持国内使用】",
      "price": 265,
      "sku": "6176980063900"
    },
    {
      "availability": 7999,
      "choices": "美规默认标配&gt;白色【外贸版不支持国内使用】",
      "price": 265,
      "sku": "6176980063903"
    },
    {
      "availability": 7998,
      "choices": "英规默认标配&gt;黑色【外贸版不支持国内使用】",
      "price": 265,
      "sku": "6176980063908"
    },
    {
      "availability": 7999,
      "choices": "美规默认标配&gt;紫色【外贸版不支持国内使用】",
      "price": 265,
      "sku": "6176980063901"
    },
    {
      "availability": 7997,
      "choices": "欧规默认标配&gt;紫色【外贸版不支持国内使用】",
      "price": 265,
      "sku": "6176980063905"
    },
    {
      "availability": 7998,
      "choices": "英规默认标配&gt;白色【外贸版不支持国内使用】",
      "price": 265,
      "sku": "6176980063911"
    },
    {
      "availability": 8000,
      "choices": "澳规默认标配&gt;白色【外贸版不支持国内使用】",
      "price": 265,
      "sku": "6176980063915"
    },
    {
      "availability": 7997,
      "choices": "英规默认标配&gt;紫色【外贸版不支持国内使用】",
      "price": 265,
      "sku": "6176980063909"
    },
    {
      "availability": 8000,
      "choices": "欧规默认标配&gt;黑色【外贸版不支持国内使用】",
      "price": 265,
      "sku": "6176980063904"
    },
    {
      "availability": 8000,
      "choices": "澳规默认标配&gt;绿色【外贸版不支持国内使用】",
      "price": 265,
      "sku": "6287237927588"
    },
    {
      "availability": 7999,
      "choices": "美规默认标配&gt;绿色【外贸版不支持国内使用】",
      "price": 265,
      "sku": "6287237927586"
    },
    {
      "availability": 7998,
      "choices": "欧规默认标配&gt;白色【外贸版不支持国内使用】",
      "price": 265,
      "sku": "6176980063907"
    },
    {
      "availability": 8000,
      "choices": "英规默认标配&gt;绿色【外贸版不支持国内使用】",
      "price": 265,
      "sku": "6287237927585"
    },
    {
      "availability": 8000,
      "choices": "澳规默认标配&gt;紫色【外贸版不支持国内使用】",
      "price": 265,
      "sku": "6176980063913"
    }
  ],
  "canonical_url": "https://detail.1688.com/offer/1010672633131.html",
  "scraped_at": "2026-08-26T22:10:59.030Z"
}
```

### Use Cases

- Research wholesale product prices and order terms
- Compare suppliers and product variants
- Build structured sourcing datasets

### Integrate with AI and automation

#### Use with AI through MCP

Connect your AI assistant to the [Apify MCP server](https://docs.apify.com/integrations/mcp). It can discover and run Actors, then access the results in the same conversation. For example, ask your assistant to scrape a list of products from 1688, compare prices, or summarize the collected data.

#### Run on a schedule

After one successful run, use [Apify Schedules](https://docs.apify.com/actors/running/schedules) to repeat the same task hourly, daily, weekly, or with a custom cron schedule. Saved tasks are useful when you want to keep the same URLs and settings for every run.

#### Connect with n8n

[Create an n8n account](https://n8n.partnerlinks.io/ezvl1qy3f990) and add the verified Apify node to a workflow. Choose **Run an Actor and Get Dataset** when the workflow should start this Actor, wait for completion, and receive the product rows for the next node. See the [Apify integration for n8n](https://n8n.io/integrations/apify/).

#### Connect with Make

[Create a Make account](https://www.make.com/en/register?pc=vasarmilan) and add the Apify **Run an Actor** module. Follow it with **Get Dataset Items** to pass the product rows to Google Sheets, a database, email, or another Make module. For longer runs, use **Watch Actor Runs** followed by **Get Dataset Items**.

[Read the Make integration guide](https://docs.apify.com/integrations/make).

# Actor input Schema

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

Add one or more product page URLs to scrape. Example product URLs:

- https://detail.1688.com/offer/1010672633131.html

## `categoryUrls` (type: `array`):

Add one or more List URLs to scrape.

Supported page types with examples:

- Search page: https://s.1688.com/selloffer/offer_search.htm?keywords=%E6%89%8B%E6%9C%BA

Leave blank if using direct product URLs instead.

The `scrapeProductDetails` option (labelled Include product details) decides what each List URL produces. When it is enabled, the Actor visits each product page and returns the full detail records; when it is disabled, the Actor returns one list-level record per product card with the fields that are always included.

## `maxResultsPerScrape` (type: `integer`):

Maximum number of product records to save.

## `usePagination` (type: `boolean`):

If this option is enabled and a List URL has more than one page, the Actor continues through the following pages until it reaches the Maximum results limit. If the option is disabled, the Actor only scrapes the first page of each List URL.

## `scrapeProductDetails` (type: `boolean`):

If this option is enabled, the Actor visits each product page and adds the full product details to every record. If it is disabled, the Actor returns one list-level result record per product card.

Fields that are always included:

- `url`
- `product_id`
- `name`
- `price`
- `currency`
- `minimum_order_quantity`
- `minimum_order_unit`
- `main_image`
- `images`
- `seller_name`
- `attributes`
- `canonical_url`
- `scraped_at`

Fields that are only added when this option is enabled (set to true), and not added when it is disabled:

- `max_price`
- `in_stock`
- `sku`
- `brand`
- `category`
- `seller_url`
- `variants`
- `rating_value`

## Actor input object example

```json
{
  "productUrls": [
    "https://detail.1688.com/offer/1010672633131.html"
  ],
  "categoryUrls": [
    "https://s.1688.com/selloffer/offer_search.htm?keywords=%E6%89%8B%E6%9C%BA&sortType=price&descendOrder=true",
    "https://s.1688.com/selloffer/offer_search.htm?keywords=%E6%89%8B%E6%9C%BA"
  ],
  "maxResultsPerScrape": 20,
  "usePagination": true,
  "scrapeProductDetails": true
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

# 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 = {
    "productUrls": [
        "https://detail.1688.com/offer/1010672633131.html"
    ],
    "categoryUrls": [
        "https://s.1688.com/selloffer/offer_search.htm?keywords=%E6%89%8B%E6%9C%BA&sortType=price&descendOrder=true",
        "https://s.1688.com/selloffer/offer_search.htm?keywords=%E6%89%8B%E6%9C%BA"
    ],
    "usePagination": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("123webdata/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 = {
    "productUrls": ["https://detail.1688.com/offer/1010672633131.html"],
    "categoryUrls": [
        "https://s.1688.com/selloffer/offer_search.htm?keywords=%E6%89%8B%E6%9C%BA&sortType=price&descendOrder=true",
        "https://s.1688.com/selloffer/offer_search.htm?keywords=%E6%89%8B%E6%9C%BA",
    ],
    "usePagination": True,
}

# Run the Actor and wait for it to finish
run = client.actor("123webdata/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 '{
  "productUrls": [
    "https://detail.1688.com/offer/1010672633131.html"
  ],
  "categoryUrls": [
    "https://s.1688.com/selloffer/offer_search.htm?keywords=%E6%89%8B%E6%9C%BA&sortType=price&descendOrder=true",
    "https://s.1688.com/selloffer/offer_search.htm?keywords=%E6%89%8B%E6%9C%BA"
  ],
  "usePagination": true
}' |
apify call 123webdata/1688-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,123webdata/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/yvJIJeZ6N3u7fV7J5/builds/IZ5a1OzKP1BwVfhJd/openapi.json