# 1688 Supplier Scraper — Factories & Wholesalers · $2/1k (`memo23/1688-supplier-scraper`) Actor

Find the factories and wholesalers selling any product on 1688.com, by keyword or photo, or read every product of a supplier you name. One row per supplier with location, factory badges, year founded, factory size, staff, patents, rating and service scores. $2 per 1,000 rows.

- **URL**: https://apify.com/memo23/1688-supplier-scraper.md
- **Developed by:** [Muhamed Didovic](https://apify.com/memo23) (community)
- **Categories:** E-commerce, Lead generation, Business
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 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 — Chinese Factories & Wholesalers for Any Product

Type a product, in English or Chinese, or paste a product photo, and get the **factories and wholesalers selling it on 1688.com**: one row per supplier with its **location**, **manufacturer or trader**, **factory badges**, **years on 1688**, **repeat-buyer rate**, **service scores**, the **lowest price** it offers and **sample products** with links. Each row carries the supplier's **factory profile** when it has one: year founded, factory area, employees, production lines, certificates, the company that audited it, brands it makes for and export markets. Name a supplier and get **every product it lists**. English names included. No login, no 1688 account.

| Input | What you get |
|---|---|
| `yoga mat` | The suppliers selling yoga mats on 1688, the ones with the most matching offers first |
| A photo of an Amazon product | The factories selling something that looks like it |
| `phone case` + Manufacturers only + 广东 | Phone case factories in Guangdong only |
| `shengdecn` in Supplier shops | Every product that supplier lists, plus its profile |

### Why use 1688 Supplier Scraper?

- **A supplier shortlist, not a product dump.** Offers are grouped by company, so you see who makes and sells the product, how many matching offers each one has and its lowest price.
- **Factory or trader, at a glance.** `isManufacturer` from the business type and the factory badges: super factory (超级工厂) and on-site inspected factory.
- **Trust signals.** Years on 1688, the repeat-buyer rate and the trade-service scores (goods, logistics, consultation, disputes, returns).
- **Company profile.** Year founded, factory area in m², employees, production lines, machines, patents, certificates (ISO9001, BSCI), the on-site auditor (SGS, TUV), brands it makes for, export markets, OEM minimum order, response and on-time delivery rates, rating and followers. Included in the price.
- **Every product of a supplier.** Paste a supplier from your shortlist and get its whole catalogue with price, orders and links, best sellers or newest first.
- **English keywords and names.** English keywords are searched with the Chinese words 1688 matches best, and supplier names and sample titles get an English copy.
- **Search by photo.** Find the suppliers behind a product picture from Amazon, AliExpress, Shopify or your own camera.
- **Filters before billing.** Manufacturers only, provinces or cities, price range, sponsored offers and words to exclude. You pay per supplier delivered, never for the offers looked at.

### How it works

1. Each keyword is searched on 1688 (English is translated first), and each photo is searched by image.
2. The matching offers are grouped by supplier, about three offers looked at for every supplier you ask for.
3. Offers outside your filters are left out before suppliers are counted.
4. Each supplier's company profile is added to its row.
5. One row per supplier lands in the dataset, the ones with the most matching offers first.
6. For each supplier in Supplier shops, a profile row and then one row per product it lists.

### Input

| Field | Notes |
|---|---|
| `searchQueries` | Product keywords, one per line, English or Chinese. |
| `imageUrls` | Product photo links (.jpg, .png, .webp). |
| `startUrls` | Optional 1688 search links; an offer link adds that offer's supplier. |
| `maxSuppliers` | Suppliers per keyword, photo or link. Default `50`, up to `1,000`. |
| `includeCompanyProfile` | Add the company profile to each supplier row. Default `true`, no extra charge. |
| `supplierShops` | Suppliers whose every product you want: the `supplierId` from a row (`shengdecn`, `b2b-2217636012473…`), a `name.1688.com` link, or any product link from the shop. |
| `maxProductsPerShop` | Products per supplier shop. Default `200`, up to `5,000`. |
| `shopSort` | Shop order, newest first, most orders first, or price low to high. |
| `manufacturersOnly` | Keep only manufacturers and inspected factories. |
| `locations` | Province or city names in Chinese: 浙江, 广东, 义乌, 深圳. |
| `priceMin` / `priceMax` | Unit price range in CNY. Applies to shop products too. |
| `excludeAds` / `excludeKeywords` | Leave out sponsored offers or offers whose title has these words. Excluded words apply to shop products too. |
| `translateToEnglish` | English supplier names and sample titles. Default `true`. |

```json
{
    "searchQueries": ["yoga mat", "phone case"],
    "maxSuppliers": 50,
    "manufacturersOnly": true
}
```

### Output sample

A real supplier row for `yoga mat`, sample offers and profile cut short:

```json
{
  "type": "supplier",
  "supplierId": "shengdecn",
  "supplierName": "福清胜德智造科技有限公司",
  "supplierNameEn": "Fuqing Shengde Intelligent Manufacturing Technology Co., Ltd.",
  "supplierUrl": "http://shengdecn.1688.com",
  "location": "福建福清市",
  "businessType": "生产加工",
  "isManufacturer": true,
  "superFactory": true,
  "factoryInspection": true,
  "supplierYears": "17",
  "repurchaseRate": "41%",
  "serviceScores": { "composite": 4.5, "goods": 4.33, "logistics": 3.43, "consultation": 3.5, "dispute": 4, "returns": 4 },
  "offersInRun": 3,
  "lowestPriceCny": 20.5,
  "sampleOffers": [
    {
      "offerId": "787646790056",
      "title": "TPE抗菌瑜伽垫专业防滑加厚女加宽健身垫家用减震静音舞蹈垫定制",
      "titleEn": "TPE antibacterial yoga mat professional non-slip thickened women's widened fitness mat home shock-absorbing silent dance mat customization",
      "offerUrl": "https://m.1688.com/offer/787646790056.html",
      "priceValue": 26
    }
  ],
  "keywords": ["yoga mat"],
  "profileFound": true,
  "yearsOn1688": 17,
  "factoryLevel": "金牌制造3钻",
  "factoryAuditBy": "SGS",
  "factoryAreaM2": 15000,
  "employees": 99,
  "productionLines": 2,
  "equipmentCount": 39,
  "patents": 52,
  "certificates": ["出口产品质量监督检查证书", "BSCI验厂", "GRS验厂", "ISO9001-质量体系认证"],
  "ownBrands": ["胜德"],
  "partners": ["三六一度（福建）体育用品有限公司"],
  "mainProducts": ["瑜伽垫", "瑜伽辅助用品", "瑜伽砖"],
  "capabilities": ["来样加工", "可接外贸订单", "可打样", "支持贴牌"],
  "oemMinOrder": "300件",
  "annualTradeVolume": "2000万以上",
  "exportMarkets": ["波兰"],
  "responseRate": 94,
  "onTimeDeliveryRate": 96,
  "rating": 4.5,
  "followers": 36734,
  "factoryAddress": "福建省福州市福清市高山镇后安村"
}
```

A product row from `supplierShops`:

```json
{
  "type": "product",
  "offerId": "993445105817",
  "title": "定制全球通转换插头70W快充自带伸缩线转换插座多功能插座转换器",
  "titleEn": "Customized Global Communication plug 70W fast charging comes with retractable cord conversion socket multi-function socket converter",
  "offerUrl": "https://m.1688.com/offer/993445105817.html",
  "image": "https://cbu01.alicdn.com/img/ibank/O1CN01YgFJzQ1gmmdgcRqSP_!!969344185-0-cib.jpg",
  "priceCny": 112,
  "priceUsd": 16.75,
  "orders": 9,
  "positionInShop": 1,
  "supplierId": "wontravel168",
  "supplierName": "东莞市万旅电器有限公司",
  "supplierNameEn": "Dongguan Wanlv Electric Co., Ltd."
}
```

### Key output fields

| Field | Description |
|---|---|
| `supplierName` / `supplierNameEn` | Company name in Chinese and English |
| `supplierUrl` / `supplierId` | The supplier's 1688 shop and its id |
| `location` / `province` / `city` | Where the supplier is, when 1688 shows it |
| `businessType` / `isManufacturer` | 生产加工 (production) or 经销批发 (trading), and whether it counts as a manufacturer |
| `superFactory` / `factoryInspection` / `businessInspection` | 1688's factory and business badges |
| `supplierYears` / `repurchaseRate` / `serviceScores` | Years on 1688, repeat-buyer rate, trade-service scores out of 5 |
| `offersInRun` / `lowestPriceCny` | Matching offers found for this supplier, and the lowest unit price among them |
| `sampleOffers` | Up to 5 of its matching offers with title, link and price |
| `keywords` | The keywords that found it, as you typed them |
| `photos` | The photos that found it, for a photo search |
| `profileFound` | Whether the supplier has a factory profile on 1688; the fields below are empty when it does not |
| `foundedYear` / `foundedDate` / `yearsOn1688` | When the company was registered, and years on 1688 |
| `factoryAreaM2` / `employees` / `employeesRange` | Factory floor area in m², and staff as a number or a range (51~100人) |
| `productionLines` / `equipmentCount` / `patents` | Production lines, machines and patents |
| `factoryLevel` / `goldManufacturer` / `factoryAuditBy` | 1688's factory grade (金牌制造3钻 = gold manufacturer, 3 diamonds), and the company that audited the factory on site (SGS, TUV) |
| `certificates` / `honours` | Certificates it uploaded (ISO9001, BSCI, GRS) and honours such as 高新技术企业 (high-tech enterprise) |
| `ownBrands` / `clientBrands` / `partners` | Its own brands, brands it makes products for, and companies it names as customers |
| `mainProducts` / `capabilities` | What it makes, and what it offers buyers: 来样加工 (made to your sample), 可打样 (samples), 支持贴牌 (private label), 可接外贸订单 (export orders) |
| `oemMinOrder` / `annualTradeVolume` / `monthlyOutputValue` / `issuesVatInvoice` | Minimum custom order, yearly trade and monthly output as the supplier states them (万 = 10,000 CNY), and whether it issues VAT invoices |
| `exportMarkets` | Its main export markets |
| `responseRate` / `onTimeDeliveryRate` / `rating` / `followers` | Messages answered and orders shipped on time in %, buyer rating out of 5, buyers following the shop |
| `factoryAddress` / `description` | Factory address and the supplier's own company description |
| `factoryVideoUrl` / `virtualTourUrl` / `factoryProfileUrl` | Factory video, 360° factory tour and 1688's factory page |

Shop product rows (`type: "product"`):

| Field | Description |
|---|---|
| `offerId` / `title` / `titleEn` / `offerUrl` / `image` | The product, its link and main picture |
| `priceCny` / `priceUsd` | Unit price in yuan, and in US dollars at the day's rate |
| `orders` / `ordersText` | Orders on 1688, as a number and as shown (成交2.0万笔 = 20,000 orders) |
| `positionInShop` | Its place in the shop order you chose |
| `supplierId` / `supplierName` / `supplierUrl` | The supplier the product belongs to |

### Pricing

Pay per event: **$0.002 per row** delivered ($2 per 1,000), plus $0.005 per run start. A row is a supplier or a shop product. The company profile is included at no extra charge. The offers looked at to find the suppliers are not charged, and neither are offers or products your filters leave out. The free Apify plan returns up to 20 suppliers per keyword and 100 products per shop.

### FAQ

**How is this different from the 1688 Wholesale Scraper?**
[1688 Wholesale Scraper](https://apify.com/memo23/1688-wholesale-scraper) returns the offers, one row per product. This actor returns the companies behind them, one row per supplier, and charges per supplier.

**Why is location empty on some rows?**
1688 leaves it out of some listings. The shop link always works.

**Can I get every product of one supplier?**
Yes. Put the supplier in Supplier shops: its `supplierId` from a row of this actor, its `name.1688.com` link, or any product link from the shop. Rows carry price, orders, picture and link; for MOQ, price tiers and every SKU, send the links to [1688 Product Details](https://apify.com/memo23/1688-product-details-scraper).

**Why is my shopNNNN.1688.com link skipped?**
A link like `shop9700417490502.1688.com` does not say which supplier it is. Paste any product link from that shop, or the `supplierId` from a row of this actor, and the shop is read.

**Why do some suppliers have an empty factory profile?**
Only suppliers that published a factory profile on 1688 have one: most factories and some traders. For the rest `profileFound` is `false` and the profile fields are empty. In a phone case search on 2026-11-12, 4 to 7 of 10 suppliers had one.

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

### Use cases

- **Sourcing shortlists**: find 20 to 50 factories for a product and compare them before you message any.
- **Manufacturer discovery**: filter to inspected factories in one province.
- **Private label and OEM**: find who actually makes a product you sell.
- **Supplier lead lists**: build a list of Chinese manufacturers in a category.
- **Supplier vetting**: compare founding year, factory size, staff and audits before you send an inquiry.
- **Catalogue monitoring**: pull a supplier's whole catalogue with prices and orders, newest first.

### 🤖 For AI Agents & LLM Apps

One keyword in, a ranked supplier list out. Rows are flat JSON with stable fields (`isManufacturer`, `repurchaseRate`, `offersInRun`, `lowestPriceCny`, `foundedYear`, `employees`) ready to filter and sort, and `sampleOffers` link to products for a next step. A `supplierId` from any row goes straight back in as a Supplier shop to read its catalogue. Available over the Apify API and MCP.

### Support

A keyword that returns nothing, or a field you need? Open an issue on the actor's Issues tab.

### Explore more scrapers

- [1688 Wholesale Scraper](https://apify.com/memo23/1688-wholesale-scraper): 1688 offers by keyword, photo or link
- [1688 Product Details Scraper](https://apify.com/memo23/1688-product-details-scraper): full product pages with every SKU
- [1688 Image Search](https://apify.com/memo23/1688-image-search-scraper): find 1688 offers from a product photo

### ⚠️ Disclaimer

This actor reads publicly visible 1688.com listings. It is not affiliated with 1688.com or Alibaba Group. You are responsible for using the data in line with applicable laws and 1688's terms. Translations are automatic; the Chinese original is the reference.

### SEO Keywords

1688 supplier scraper, 1688 suppliers, 1688 factory finder, 1688 shop scraper, 1688 store products, 1688 supplier products, 1688 factory profile, find 1688 suppliers, 1688 manufacturer list, chinese factory finder, china supplier scraper, 1688 wholesalers, 1688 supplier search, alibaba 1688 supplier, find manufacturers in china, 1688 factory list, 1688 supplier data, sourcing agent tool, OEM manufacturer finder, private label supplier china

# Actor input Schema

## `searchQueries` (type: `array`):

Product keywords, one per line, in English or Chinese: yoga mat, phone case, 蓝牙耳机. English is translated to the Chinese words 1688 matches best. Each keyword returns the factories and wholesalers selling it, most offers first.

## `imageUrls` (type: `array`):

Links to product photos (an Amazon, AliExpress or Shopify picture, or your own). Each photo returns the suppliers selling something that looks like it.

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

Optional. A 1688 search results link (s.1688.com/selloffer/offer_search.htm?keywords=...) is read like a keyword. An offer link adds that offer's supplier.

## `maxSuppliers` (type: `integer`):

How many suppliers each keyword, photo or search link returns, the ones with the most matching offers first. Each supplier is one billed row.

## `includeCompanyProfile` (type: `boolean`):

Add each supplier's factory profile to its row: year founded, factory area, employees, production lines, patents, certificates, the company that audited the factory, brands it makes for, export markets, response and on-time delivery rates, rating and followers. Suppliers without a profile on 1688 get empty fields. No extra charge.

## `supplierShops` (type: `array`):

One per line: the supplierId from a row of this actor (shengdecn, b2b-2217636012473...), the supplier's name.1688.com link, or any product link from that shop. A shopNNNN.1688.com link does not say which supplier it is; paste a product link from that shop instead.

## `maxProductsPerShop` (type: `integer`):

Products read from each supplier shop, in the order below. Each product is one billed row. The free Apify plan reads up to 100 per shop.

## `shopSort` (type: `string`):

Which products come first when a shop has more than Max products per shop.

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

Keep only manufacturers: suppliers listed as 生产加工 (production), super factories (超级工厂) and on-site inspected factories. Traders and wholesalers are left out.

## `locations` (type: `array`):

Keep only suppliers whose location contains one of these, in Chinese: 浙江 (Zhejiang), 广东 (Guangdong), 义乌 (Yiwu), 深圳 (Shenzhen). A province matches every city in it. Empty keeps every location.

## `priceMin` (type: `integer`):

Keep only offers priced at or above this, in yuan. Offers whose card shows no price are kept.

## `priceMax` (type: `integer`):

Keep only offers priced at or below this, in yuan.

## `excludeAds` (type: `boolean`):

Leave out offers placed by paid ads (isAd: true). Skipped offers are not billed.

## `excludeKeywords` (type: `array`):

Drop offers whose title contains any of these words, Chinese or English, case-insensitive. Useful when a keyword has a second meaning, e.g. 夹板 also matches 电夹板 hair straighteners. Dropped offers are not billed.

## `sortBy` (type: `string`):

Order of 1688's search before suppliers are grouped: best match, or best-selling first.

## `translateKeywords` (type: `boolean`):

Search queries written in English (yoga mat, phone case) are machine-translated to the Chinese words 1688 matches best before searching. Each row keeps the Chinese keyword in sourceQuery and your original in sourceQueryOriginal. Chinese queries are searched as typed.

## `translateToEnglish` (type: `boolean`):

Add supplierNameEn and English titles of the sample offers, machine-translated from the Chinese. The Chinese originals stay in the row.

## `proxy` (type: `object`):

Residential proxies recommended. The default works out of the box; set your own only if you have one.

## Actor input object example

```json
{
  "searchQueries": [
    "yoga mat"
  ],
  "startUrls": [],
  "maxSuppliers": 50,
  "includeCompanyProfile": true,
  "supplierShops": [],
  "maxProductsPerShop": 200,
  "shopSort": "default",
  "manufacturersOnly": false,
  "locations": [],
  "excludeAds": false,
  "excludeKeywords": [],
  "sortBy": "default",
  "translateKeywords": true,
  "translateToEnglish": true
}
```

# Actor output Schema

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

Dataset of 1688 suppliers found for your keywords or photos, the ones with the most matching offers first.

## `products` (type: `string`):

Products of the supplier shops you named, one row each.

# 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 = {
    "searchQueries": [
        "yoga mat"
    ],
    "startUrls": [],
    "supplierShops": [],
    "locations": [],
    "excludeKeywords": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("memo23/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 = {
    "searchQueries": ["yoga mat"],
    "startUrls": [],
    "supplierShops": [],
    "locations": [],
    "excludeKeywords": [],
}

# Run the Actor and wait for it to finish
run = client.actor("memo23/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 '{
  "searchQueries": [
    "yoga mat"
  ],
  "startUrls": [],
  "supplierShops": [],
  "locations": [],
  "excludeKeywords": []
}' |
apify call memo23/1688-supplier-scraper --silent --output-dataset

```

## MCP server setup

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