# 1688.com Supplier Scraper (`devcake/1688-com-supplier-scraper`) Actor

Fast 1688.com supplier scraper. Get verified factory profiles, quality scores, and product offers. Source directly from gold-certified manufacturers for E-commerce.

- **URL**: https://apify.com/devcake/1688-com-supplier-scraper.md
- **Developed by:** [devcake](https://apify.com/devcake) (community)
- **Categories:** E-commerce, Lead generation, Other
- **Stats:** 130 total users, 17 monthly users, 100.0% runs succeeded, 4 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 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/platform/actors/running/actors-in-store#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 Supplier Scraper for Dropshippers & Amazon FBA Sellers

Find verified manufacturers and suppliers on China's largest B2B marketplace. Extract company profiles, factory certification levels, trust metrics, and manufacturing capabilities to identify reliable sourcing partners.

### Why This Matters for Dropshippers & FBA Sellers

| Your Need | What We Extract | Why It Matters |
|-----------|-----------------|----------------|
| 🛡️ Factory Verification | `factory_level`, `is_factory` | Certified manufacturers vs traders |
| 📊 Trust Signals | certifications, repeat rate, buyer interest, years active | Compare suppliers using fields actually returned by factory search |
| 🔧 Manufacturing | category, factory size, employees, AI capabilities | Evaluate production fit before opening a detail page |
| 📍 Location | `province`, `city`, optional enriched address | Verify shipping zones |
| 📦 Featured Product | canonical offer URL, typed CNY/USD price, MOQ | Inspect a representative product from each supplier |
| 🔗 Contact | `company_url` | Direct supplier links |
| 💰 Pricing | `current_offer_price_cny` and estimated USD | Quick typed price reference in both currencies |

### Perfect For

- 🚀 **New Dropshippers** verifying suppliers before first orders
- 📦 **Amazon FBA Sellers** finding certified factories for private labeling
- 🏷️ **Brand Builders** locating OEM/ODM manufacturers for custom products
- 🔍 **Product Researchers** validating capabilities before sampling
- 💰 **Sourcing Agents** building verified manufacturer databases

### Quick Start

```json
{
  "queries": ["wireless earbuds factory"]
}
```

#### Input Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `queries` | array | **Required** | Search keywords |
| `maxSuppliers` | integer | 20 | Suppliers per query |
| `enableEnrichment` | boolean | true | Fetch validated factory-page fields; disable for fastest API-only runs |

### Output Data

#### Supplier Profile

```json
{
  "company_id": "123456",
  "company_name": "Shenzhen Electronics Factory",
  "legal_company_name": "Shenzhen Electronics Factory Co., Ltd.",
  "factory_level": "金牌制造",
  "is_factory": true,
  "repeat_rate": 0.72,
  "years_on_platform": 5,
  "quality_tags": ["CCC认证"],
  "ai_capabilities": ["来图来样"],
  "product_categories": ["无线耳机"],
  "current_offer_title": "Wireless Earbuds TWS Bluetooth 5.0",
  "current_offer_price_cny": 15.5,
  "current_offer_price_usd": 2.17,
  "current_offer_moq": "2",
  "current_offer_moq_unit": "个",
  "current_offer_url": "https://detail.1688.com/offer/789.html",
  "company_url": "https://factory.1688.com",
  "enriched": true,
  "enrichment_status": "success",
  "full_address": "广东省深圳市...",
  "production_staff": "51~100人"
}
```

`current_offer_price_cny` is authoritative. USD is a configurable estimate and every row includes `fx_rate_cny_usd` and `fx_rate_as_of`.

#### Trust & Reliability Metrics

Filter suppliers using these quality indicators:

| Field | Description | Recommended Filter |
|-------|-------------|-------------------|
| `repeat_rate` | Repeat customers (0-1) | `>= 0.6` |
| `years_on_platform` | Years active | `>= 2` |
| `quality_tags` | Certifications returned by 1688 | Review relevant certificates |
| `buyer_will_count` | Buyer-interest signal | Higher = more interest |
| `enrichment_status` | `success`, `no_data`, `failed`, or `not_requested` | Distinguish missing data from fetch failures |

#### Factory Certification Levels

| Level | Chinese | Trust |
|-------|---------|-------|
| Gold | 金牌制造 | ⭐⭐⭐⭐⭐ Highest |
| Silver | 银牌制造 | ⭐⭐⭐⭐ |
| Unbranded | 无牌工厂 | ⭐⭐⭐ |

### Manufacturing Capabilities

Find suppliers by service type:

- **OEM** - Custom branding on existing designs
- **ODM** - Full custom design service
- **来样加工** - Sample processing
- **来图加工** - Design-based manufacturing

### Example Use Cases

#### Find Gold-Certified Electronics Factories

```json
{
  "queries": ["wireless earbuds manufacturer"],
  "maxSuppliers": 50
}
```

### Tips for Best Results

1. **Use "factory" or "manufacturer"** in keywords
2. **Target Guangdong, Zhejiang, Jiangsu** for most factories

**Currency note:** use numeric `current_offer_price_cny` for calculations. USD is an estimate, not a live exchange-rate quote.

### Common Keywords by Category

| Category | Keywords |
|----------|----------|
| Electronics | manufacturer, factory, oem, odm |
| Apparel | garment factory, clothing manufacturer |
| Bags | leather factory, bag manufacturer |
| Home Goods | factory direct, wholesale |

***

### Expand Your Sourcing

Diversify your sourcing across multiple B2B platforms:

| Platform | Purpose | Link |
|----------|---------|------|
| Alibaba Suppliers | Verified international suppliers | [View Actor](https://apify.com/devcake/alibaba-supplier-scraper) |
| Alibaba Products | Product comparison & pricing | [View Actor](https://apify.com/devcake/alibaba-products-scraper) |
| Global Sources Supplier |Extract 300k+ verified suppliers | [View Actor](https://apify.com/devcake/globalsources-supplier-scraper) |
| Global Sources Products | Extract product listings on international Global Sources | [View Actor](https://apify.com/devcake/globalsources-products-scraper) |
| DHgate Products | Explore low-MOQ product listings and brand replicas | [View Actor](https://apify.com/devcake/dhgate-products-scraper) |

#### Why Multi-Platform Sourcing?

- 📊 **Compare pricing** - Same products vary by platform
- 🛡️ **Reduce risk** - Don't rely on one source
- 🏭 **Find exclusives** - Some factories use specific platforms
- ⚡ **Better terms** - Compare MOQ, lead times, payment

***

### 💰 650% Profit Margins: Source 1688 → Sell TikTok Shop

| Source on 1688 | Sell on TikTok Shop |
|----------------|---------------------|
| 💵 $3.99 factory price | 📱 $29.99 retail price |
| 🏭 Direct from manufacturer | 🎯 Viral product potential |
| 📊 Proven demand data | ⭐ Millions of buyers |

**[TikTok Shop Product Scraper](https://apify.com/devcake/tiktok-shop-data-scraper)** - Research trending products, analyze competitor pricing, extract reviews. Maximize your sourcing-to-selling profit pipeline.

> 💰 **Factory prices + TikTok demand = Maximum profit margins!**

***

🏭 **Ready to find verified manufacturers?** Start your first scrape now!

# Actor input Schema

## `queries` (type: `array`):

List of supplier keywords to find manufacturers on 1688.com. Each query searches for companies matching the keyword. Works with BOTH English and Chinese keywords!

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

Maximum number of unique suppliers to extract for each search query (1-500). The scraper fetches stable 24-result API pages and deduplicates suppliers before output.

## `enableEnrichment` (type: `boolean`):

Fetch factory detail pages concurrently for complete address, main products, production capability, and product links. Disable for the fastest and lowest-traffic API-only run; every row reports enrichment\_status.

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

Proxy configuration to bypass 1688 anti-bot protection. Options: (1) Apify Proxy with groups/country selection, (2) Custom proxy URLs for rotation. Using residential proxies is strongly recommended.

## Actor input object example

```json
{
  "queries": [
    "leather wallet manufacturer",
    "phone case factory",
    "钱包工厂"
  ],
  "maxSuppliers": 20,
  "enableEnrichment": true,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `suppliers` (type: `string`):

Supplier rows with stable company identifiers, factory signals, typed offer pricing, canonical links, and explicit enrichment status/error provenance.

# 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 = {
    "queries": [
        "leather wallet manufacturer",
        "phone case factory",
        "钱包工厂"
    ],
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("devcake/1688-com-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 = {
    "queries": [
        "leather wallet manufacturer",
        "phone case factory",
        "钱包工厂",
    ],
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("devcake/1688-com-supplier-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "queries": [
    "leather wallet manufacturer",
    "phone case factory",
    "钱包工厂"
  ],
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call devcake/1688-com-supplier-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=devcake/1688-com-supplier-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/yr4TSFAGrV2HyFZoY/builds/2RqwsEEsTv1vpFY9g/openapi.json