# 1688 Scraper: Wholesale Products, Prices & Suppliers (`earlytern/1688-product-scraper`) Actor

Scrape 1688.com wholesale products by keyword or URL: prices, quantity price tiers, minimum order, variants, sales and supplier details. No login.

- **URL**: https://apify.com/earlytern/1688-product-scraper.md
- **Developed by:** [earlytern](https://apify.com/earlytern) (community)
- **Categories:** E-commerce, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.90 / 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

## 1688 Scraper: Wholesale Products, Prices & Suppliers

1688 Scraper searches 1688.com, China's largest wholesale marketplace, by keyword and reads 1688 product pages,
without logging in. Each product comes back as one clean row: title, price in yuan, quantity price tiers, minimum
order, variants with stock, units sold, rating, pictures, and the supplier's name, type, location, years on 1688 and
badges.

### What does 1688 Scraper do?

- **Keyword search:** the products 1688 shows for a keyword, page after page (60 per page, sponsored results
  included and marked), up to the number you ask for.
- **Product addresses:** read any 1688 product page from its address or its product number.
- **Prices:** lowest and highest price per unit in CNY, wholesale price tiers by order quantity (for example 10+ units
  at ¥0.75, 500+ at ¥0.73, 5,000+ at ¥0.68), and the price and stock of each variant (color, size…).
- **Product data:** minimum order quantity and unit, units sold, sales in the last 30 days, repeat buyer rate,
  rating, review count, specifications, main picture and gallery.
- **Supplier data:** company name, type (for example factory), province and city, years on 1688, service score,
  repeat buyer rate, shop address, badges and service tags.
- **One row per product per run:** a product found by two keywords is saved and charged once.
- **Free rows that explain:** a keyword with no products, a removed product, or a line that is not usable gets a free
  row saying why, so you always know what happened to each line.

### Why use 1688 Scraper?

- **Product sourcing:** compare factory prices, minimum orders and price tiers for a product across many suppliers.
- **Supplier research:** find factories and wholesalers for a product, with their location, years on 1688 and badges.
- **Dropshipping and e-commerce:** check what a product costs at the source before you list it on your store.
- **Price monitoring:** run it on a schedule to follow prices and sales of the products you buy.
- **AI agents:** give an AI agent fresh 1688 product data through the Apify API or MCP.
- **Low, simple price:** $2.50 per 1,000 products, no start fee, price tiers and supplier data included, nothing
  charged for empty results.
- **No login, no cookies:** you never share a 1688 or Alibaba account.

### How to use 1688 Scraper

1. Click **Try for free**.
2. Add **Search keywords** (for example `手机壳` for phone case), **Product addresses** (for example
   `https://detail.1688.com/offer/931610556637.html`), or both.
3. Set **Maximum products per keyword**.
4. Keep **Open product pages** on to get price tiers, variants, rating and supplier location, or turn it off for
   faster runs with the search results only.
5. Click **Start**, then download the results as JSON, CSV or Excel, or use them through the API.

### Input

```json
{
  "keywords": ["手机壳"],
  "productUrls": ["https://detail.1688.com/offer/931610556637.html"],
  "maxProducts": 50,
  "includeDetails": true
}
```

| Field | What it does |
|---|---|
| `keywords` | Products to search, one per line. Chinese keywords match best; English keywords also work. |
| `productUrls` | 1688 product pages (`https://detail.1688.com/offer/<number>.html`) or just the product number, one per line. |
| `maxProducts` | At most this many products per keyword (1-1,000, default 50). |
| `includeDetails` | Open each product page found by a keyword to add price tiers, variants, rating, supplier type and location (default on). Product addresses always open their page. |
| `proxyConfiguration` | Connection used to open 1688. Residential proxy is the default: 1688 often shows a security check on product pages to other connections. |

Add at least one keyword or one product address.

### Output

One row per product (`type: "product"`), and free rows that explain lines without products. Example product row
(some lists shortened):

```json
{
  "type": "product",
  "source": "keyword",
  "query": "手机壳",
  "offerId": "931610556637",
  "url": "https://detail.1688.com/offer/931610556637.html",
  "title": "厂家批发数码液态硅胶引磁片Magsafe无线充引手机壳配件磁环现货",
  "priceMin": 0.68,
  "priceMax": 0.75,
  "currency": "CNY",
  "priceTiers": [
    { "minQuantity": 10, "price": 0.75 },
    { "minQuantity": 500, "price": 0.73 },
    { "minQuantity": 5000, "price": 0.68 }
  ],
  "variants": [
    { "name": "蓝色", "price": null, "stock": 998801 },
    { "name": "粉色", "price": null, "stock": 1165966 }
  ],
  "minOrderQuantity": 10,
  "unit": "个",
  "salesCount": 37137,
  "monthlySales": 6000,
  "repeatBuyerRate": 11.63,
  "supplierRepeatRate": 74.44,
  "rating": 4.7,
  "reviewCount": 53,
  "supplierName": "东莞阳熠科技有限公司",
  "supplierType": "factory",
  "supplierYears": 2,
  "supplierLocation": "广东省东莞市",
  "supplierServiceScore": 4.5,
  "supplierShopUrl": "https://example-shop.1688.com",
  "supplierBadges": [],
  "tradeAssurance": false,
  "serviceTags": ["48H发货", "混批", "生产加工"],
  "attributes": [
    { "name": "品牌", "value": "阳熠" },
    { "name": "类型", "value": "引磁片" }
  ],
  "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01YOLWYN1qMLtW33ym5_!!2219830355481-0-cib.jpg",
  "imageUrls": ["https://cbu01.alicdn.com/img/ibank/O1CN01YOLWYN1qMLtW33ym5_!!2219830355481-0-cib.jpg"],
  "isAd": false,
  "position": 6,
  "detailsLoaded": true,
  "message": null,
  "scrapedAt": "2026-11-16T05:19:14.833Z"
}
```

#### Fields

| Field | Meaning |
|---|---|
| `type` | `product`, or one of the free row types below |
| `source`, `query` | `keyword` or `url`, and the line as you typed it |
| `offerId`, `url` | 1688 product number and product page |
| `title` | Product title as the supplier wrote it (usually Chinese) |
| `priceMin`, `priceMax`, `currency` | Lowest and highest price per unit, in CNY |
| `priceTiers` | Price per unit by order quantity: from `minQuantity` units the price is `price` |
| `variants` | Variants with their price (null when they follow the price tiers) and stock |
| `minOrderQuantity`, `unit` | Minimum order and the selling unit (个 piece, 件 item, 套 set…) |
| `salesCount`, `monthlySales` | Units sold, and units sold in the last 30 days (a lower bound such as 6000+) |
| `repeatBuyerRate` | Share of this product's buyers who ordered again, in percent |
| `rating`, `reviewCount` | Product rating (0-5) and number of reviews |
| `supplierName`, `supplierType` | Supplier company and its type (for example `factory`) |
| `supplierYears`, `supplierLocation` | Years on 1688, and the province and city the product ships from |
| `supplierServiceScore`, `supplierRepeatRate` | Service score (0-5) and the share of the supplier's buyers who ordered again in the last 3 months |
| `supplierShopUrl`, `supplierBadges` | Supplier's shop on 1688, and badges (Super factory, Powerful merchant) |
| `tradeAssurance`, `serviceTags` | Trade assurance shown, and service tags in Chinese (48H发货 ships within 48 hours, 混批 mixed batches) |
| `attributes` | Specifications (material, brand, size…) as name and value, in Chinese |
| `imageUrl`, `imageUrls` | Main picture and gallery |
| `isAd`, `position` | Sponsored result or not, and position in the keyword's results (all pages) |
| `detailsLoaded` | Whether the product page was opened |
| `message` | Plain-words note: why a row is not a product, or what a product row is missing |
| `scrapedAt` | When the row was saved (ISO 8601, UTC) |

Some fields come from only one of the two pages. From search results only: `monthlySales`, `repeatBuyerRate`,
`supplierYears`, `supplierBadges`, `tradeAssurance`, `serviceTags`, `isAd`, `position`. From the product page only:
`priceTiers`, `variants`, `rating`, `reviewCount`, `supplierType`, `supplierLocation`, `supplierServiceScore`,
`supplierRepeatRate`, `supplierShopUrl`, `attributes`. A product read from its address has no search result data.

#### Row types

| `type` | Meaning | Charged |
|---|---|---|
| `product` | One 1688 product | Yes |
| `no_results` | 1688 found no products for the keyword, or every product was already saved for another line | No |
| `not_found` | No product at this address; it may have been removed | No |
| `blocked` | 1688 asked for a security check and did not show the page after several tries; try again later | No |
| `invalid` | The line is not a usable keyword or product address | No |
| `skipped` | Left out because the run reached your maximum cost per run | No |

### How much does 1688 Scraper cost?

You pay per saved product. There is no start fee; price tiers, variants and supplier data are included, and
explanation rows are free.

| Apify plan | Price per 1,000 products |
|---|---|
| Free | $2.50 |
| Bronze | $2.30 |
| Silver | $2.10 |
| Gold and higher | $1.90 |

Example: 10 keywords with 100 products each are 1,000 products, which cost $2.50 on the Free plan. Set a **maximum
cost per run** in the run options to cap what a run can spend: when it is reached, the run stops cleanly and the
products it could not pay for come back as free `skipped` rows instead.

### Limits

- **Logged-out view only.** The Actor never logs in, so it sees what 1688 shows to visitors. Prices are the public
  prices; prices only shown to members are not available.
- **About 2,000 products per keyword.** 1688 shows visitors at most about 34 pages of 60 results. Add related
  keywords to collect more.
- **Titles stay in Chinese.** 1688 has no English version of these pages for visitors. English keywords work, but
  Chinese keywords match the way suppliers write their titles and find more exact products.
- **Sponsored results** are part of every page (about 15 of 60). They are real products and are marked with
  `isAd: true`; filter them out if you only want the natural ranking.
- **Security checks.** 1688 sometimes asks a visitor for a security check. The Actor never solves or bypasses it: it
  tries again with a new IP address. If a product page still does not open, the product row keeps all the search
  result data, is still saved, and says in `message` which fields are missing. Turn off **Open product pages** for
  the fastest runs with search data only.

### FAQ

**Do I need a 1688 or Alibaba account?** No. The Actor reads public pages without logging in and never uses cookies.

**Can I search in English?** Yes, but 1688 is a Chinese marketplace: Chinese keywords (for example `手机壳` for phone
case, `连衣裙` for dress) find more and closer matches. A translation tool gives you the Chinese word in seconds.

**What currency are the prices in?** Chinese yuan (CNY), per selling unit, without shipping.

**Why are `priceTiers` empty on some products?** The supplier prices each variant on its own instead of by quantity:
look at `variants`. They are also empty when the product page was not opened (`detailsLoaded: false`).

**How do I contact a supplier?** Open `supplierShopUrl` or the product `url` on 1688. The Actor does not collect
personal contact details.

**Can I run it on a schedule?** Yes. Use Apify Schedules to run it daily or weekly, and connect the results to Make,
Zapier, n8n, Google Sheets or your own app through the API.

### Is it legal to scrape 1688?

The Actor collects only product and company data that 1688 shows publicly to visitors who are not logged in, and no
personal data. You are responsible for how you use the results, including the site's terms and the laws that apply to
you; when in doubt, ask a lawyer.

### Questions and feedback

Open an issue on the **Issues** tab; we answer within 2 working days.

# Actor input Schema

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

Products to search on 1688, one per line. Chinese keywords such as 手机壳 (phone case) match best; English keywords also work but find fewer exact matches. Product titles stay in Chinese.

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

1688 product pages, one per line, such as https://detail.1688.com/offer/931610556637.html, or just the product number 931610556637.

## `maxProducts` (type: `integer`):

The run saves at most this many products for each keyword. One page of 1688 results holds 60 products (some of them sponsored); more products come from the next pages.

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

Also open each product found by a keyword to add quantity price tiers, variants, exact sales, rating, supplier type and location. Turn off for faster runs with the search results only. Product addresses always open their page.

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

Connection used to open 1688. Residential proxy is the default because 1688 often shows a security check on product pages to other connections; each request uses a new IP address.

## Actor input object example

```json
{
  "keywords": [
    "手机壳"
  ],
  "maxProducts": 5,
  "includeDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

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

No description

## `summary` (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 = {
    "keywords": [
        "手机壳"
    ],
    "maxProducts": 5,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("earlytern/1688-product-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": ["手机壳"],
    "maxProducts": 5,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("earlytern/1688-product-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": [
    "手机壳"
  ],
  "maxProducts": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call earlytern/1688-product-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,earlytern/1688-product-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/9F2hYzlhKE1IlxgOi/builds/pAz1Ge5GDKmIv2kc0/openapi.json
