# 1688 Supplier Scraper (`piotrv1001/1688-supplier-scraper`) Actor

Find China suppliers on 1688.com by product keyword: one row per factory or wholesaler with company name, manufacturer or trader, city and province, years on 1688, factory audit, rating, service scores, repurchase rate, price range and sample products.

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

## Pricing

from $2.00 / 1,000 suppliers

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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 Supplier Scraper: Find China Suppliers and Chinese Factories

Find **China suppliers on 1688.com** for any product. The **1688 Supplier Scraper** searches 1688 by keyword and returns one row per supplier: company name, manufacturer or wholesaler, city and province, years on 1688, factory audit, rating, service scores, repurchase rate, price range and sample products. Use it to find Chinese manufacturers, build a 1688 suppliers list for sourcing, or as a simple alternative to a 1688 supplier API.

### 🎯 Use Cases

- **Find Chinese factories for a product**: search "phone case" or "手机壳", tick "Manufacturers only" and get a shortlist of factories with audit status and years on 1688.
- **China product sourcing**: compare suppliers of the same product by price range, minimum order, rating and repurchase rate before you send the first inquiry.
- **Sourcing hub research**: limit the search to Yiwu, Shenzhen, Guangzhou or any other city and see who sells there.
- **1688 dropshipping and sourcing agents**: build a vetted supplier list per product category for your clients.
- **Wholesale lead lists**: export China wholesale suppliers with their 1688 shop links to a spreadsheet or CRM.

### ✨ Features

- **One row per supplier**: 1688 search pages list the same supplier many times; the Actor groups them and saves each supplier once per run, even across keywords.
- **Supplier quality signals**: years on 1688, TrustPass membership, factory audit (深度验厂), business verification, overall rating, five service scores and the shop's repurchase rate.
- **Manufacturer or wholesaler**: `businessType` says which, and "Manufacturers only" keeps just the factories.
- **Sample products**: up to 3 of the supplier's products from the search, with price range, unit, MOQ, 30-day sales, image and link.
- **City filter**: English names of the main sourcing hubs work, any other city in Chinese.
- **Chinese and English keywords**: Chinese keywords match more products; English works too.
- **Fair billing**: you pay per supplier saved, never for duplicates or blocked pages.

### 🛠️ How It Works

1. **Enter product keywords**, one per line, e.g. `phone case`, `手机壳` or `led strip`.
2. **Set Max suppliers per keyword** (default 50) and, if you like, a city or "Manufacturers only".
3. **Run the scraper** and download the suppliers as JSON, CSV or Excel, or pull them through the API.

### ⚙️ Input

| Field                         | What it does                                                                                       |
| ----------------------------- | -------------------------------------------------------------------------------------------------- |
| **Product keywords**          | What the suppliers should sell. One keyword per line; each is searched separately.                 |
| **Max suppliers per keyword** | Stop each keyword after this many suppliers. Default 50.                                           |
| **Manufacturers only**        | Keep only suppliers 1688 lists as manufacturers (生产加工). Default off.                           |
| **Supplier city**             | Only suppliers in this city: Shenzhen, Guangzhou, Yiwu, Dongguan, Ningbo … or any city in Chinese. |

```json
{
    "keywords": ["phone case", "手机支架"],
    "maxItems": 100,
    "manufacturersOnly": true,
    "supplierCity": "Shenzhen"
}
```

### 💰 Pricing

Pay only for the suppliers you get. No monthly rental.

| Event           | Price                                 | What you get                       |
| --------------- | ------------------------------------- | ---------------------------------- |
| **Supplier**    | $0.002 per supplier ($2.00 per 1,000) | One supplier with all fields below |
| **Actor start** | $0.00005 per run                      | Charged once when the run starts.  |

Examples: 50 suppliers = $0.10 · 500 suppliers = $1.00 · 1,000 suppliers = $2.00 (plus $0.00005 per run).

### 📊 Sample Output Data

```json
{
    "supplierId": "b2b-22160073164577deeb",
    "companyName": "深圳市安耐佳硅胶制品有限公司",
    "businessType": "manufacturer",
    "province": "广东",
    "city": "深圳市",
    "yearsOn1688": 4,
    "trustPassMember": true,
    "factoryInspected": true,
    "businessVerified": false,
    "badges": ["实商", "深度验厂"],
    "rating": 5,
    "serviceScores": { "consultation": 5, "product": 5, "logistics": 4.57, "disputes": 4, "returns": 4.67 },
    "repurchaseRatePercent": 39,
    "priceFromCny": 2.35,
    "priceToCny": 2.35,
    "productsInResults": 1,
    "sampleProducts": [
        {
            "offerId": "827696512161",
            "title": "现货通用边框式手机套可拉伸硅胶手机壳挂绳合金指环扣款防指纹",
            "priceFrom": 2.35,
            "priceTo": 2.35,
            "unit": "个",
            "minOrderQuantity": 5,
            "unitsSold30Days": 45,
            "image": "https://cbu01.alicdn.com/img/ibank/O1CN01CpCHOm1xZMNcrYVdq_!!2216007316457-0-cib.jpg",
            "url": "https://detail.1688.com/offer/827696512161.html"
        }
    ],
    "shopUrl": "https://m.1688.com/winport/b2b-22160073164577deeb.html?__existtitle__=1",
    "sellerLoginId": "安耐佳硅胶制品",
    "sellerUserId": "2216007316457",
    "keyword": "phone case",
    "searchPage": 1,
    "scrapedAt": "2026-10-29T12:20:34.183Z"
}
```

`supplierId` is the 1688 member id, stable across runs. `factoryInspected` is 1688's on-site factory audit (深度验厂) and `businessVerified` its business verification (实商). `repurchaseRatePercent` is the share of the shop's buyers who order again. `productsInResults` counts the supplier's products on the search page where it was found, and `priceFromCny`/`priceToCny` span those products. Names and titles stay in Chinese, as 1688 shows them.

### 🔁 Schedule and Integrate

For supplier discovery, run it **once a week** per product category: new suppliers appear in the dataset and you can compare ratings and repurchase rates over time. Set it up in Apify **Schedules**. Send the results to **Google Sheets**, **Zapier**, **Make**, **n8n** or a webhook with Apify **integrations**, so the supplier list lands where your sourcing team works.

### 🤖 Use with AI Agents (MCP)

This Actor works as a tool in Claude, ChatGPT, Cursor and other MCP clients through the Apify MCP server (`https://mcp.apify.com`). An agent can call it with:

```json
{ "keywords": ["bluetooth earphones"], "maxItems": 20, "manufacturersOnly": true }
```

### ❓ FAQ

**Does 1688 have an official supplier API?** 1688's open platform is for registered Chinese businesses and partners and needs an application and approval. This Actor needs no key or account and returns the supplier data any 1688 visitor sees in search, grouped one row per supplier.

**How do I find Chinese manufacturers on 1688?** Enter a product keyword (Chinese matches more), turn on "Manufacturers only" and sort the result by `factoryInspected`, `yearsOn1688` and `repurchaseRatePercent`. Open `shopUrl` or a sample product to contact the factory.

**How many suppliers can I get per keyword?** 1688 shows up to 2,000 products per keyword, and one page of 50 products holds about 35 different suppliers, so a broad keyword gives several hundred suppliers. Use more specific or more keywords to go further.

**Do I need a 1688 account?** No.

**Why is a rating or service score empty?** New shops and some sellers have no scores yet; those fields are left out of the row then.

**Is 1688 the same as Alibaba?** Both belong to Alibaba Group. Alibaba.com is the English export marketplace; 1688.com is the Chinese domestic wholesale site, usually with lower prices and smaller minimum orders.

### 🔗 Related Scrapers

- [1688 Product Details Scraper](https://apify.com/piotrv1001/1688-product-details-scraper): full product pages (prices, stock, SKU options, specs) for the sample products you find here.
- [1688 Listings Scraper](https://apify.com/piotrv1001/1688-listings-scraper): one row per product for the same keywords, with price filters and sorting.
- [1688 Image Search Scraper](https://apify.com/piotrv1001/1688-image-search-scraper): find 1688 suppliers of a product from a photo.
- [Alibaba Listings Scraper](https://apify.com/piotrv1001/alibaba-listings-scraper): the same keywords on Alibaba.com, for export suppliers.
- [Made-in-China Listings Scraper](https://apify.com/piotrv1001/made-in-china-listings-scraper): Chinese manufacturers on Made-in-China.com.

# Actor input Schema

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

What the suppliers should sell, one keyword per line, e.g. phone case or 手机壳. Chinese keywords match more products on 1688, English works too. Each keyword is searched separately; a supplier found under several keywords is saved once.

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

Stop each keyword after this many suppliers. One search page of 50 products holds about 35 different suppliers; 1688 shows up to 2,000 products per keyword. Your maximum charge per run also caps the run.

## `manufacturersOnly` (type: `boolean`):

Keep only suppliers that 1688 lists as manufacturers (生产加工) and skip wholesalers and trading companies.

## `supplierCity` (type: `string`):

Only suppliers based in this city. English names of the main sourcing hubs work (Shenzhen, Guangzhou, Yiwu, Dongguan, Ningbo, Shantou …); any other city in Chinese, e.g. 深圳 or 义乌. Province names are not supported by 1688.

## Actor input object example

```json
{
  "keywords": [
    "phone case"
  ],
  "maxItems": 50,
  "manufacturersOnly": false
}
```

# Actor output Schema

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

No description

## `results` (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": [
        "phone case"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("piotrv1001/1688-supplier-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": ["phone case"] }

# Run the Actor and wait for it to finish
run = client.actor("piotrv1001/1688-supplier-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": [
    "phone case"
  ]
}' |
apify call piotrv1001/1688-supplier-scraper --silent --output-dataset

```

## MCP server setup

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