# 1688 Supplier Scraper: Factory Profiles & Products (`theshark/1688-supplier-scraper`) Actor

Scrape 1688.com suppliers by shop link, shop ID or company name: company registration, founding year, shop ratings, factory card, shop metrics and hot offers. Optionally collect each supplier's products with tiered prices, MOQ, stock and sales. No contacts, no login.

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

## Pricing

from $1.60 / 1,000 supplier profiles

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: Factory Profiles, Shop Data and Products

Scrape supplier profiles from [1688.com](https://www.1688.com) (Alibaba 1688), China's largest wholesale marketplace. Give shop links, shop IDs or company names and get one profile row per supplier: company registration, founding year, shop header and ratings, factory card for verified factories (equipment, production lines, OEM minimums, capacity, videos, rankings), shop metrics, buyer rating summary and the shop's hot offers. Optionally collect each supplier's products with tiered prices, MOQ, stock and sales.

No 1688 account, login, cookies or proxies of your own are needed. You pay only for suppliers and products that were collected successfully.

### What can you do with 1688 Supplier Scraper?

- **Vet suppliers before you order:** company registration, founding year, registered capital, factory verification, service and rating scores.
- **Compare factories:** factory area, staff, equipment, production lines, OEM minimums, monthly output and rankings.
- **Collect a supplier's products:** give a shop link and get its products with full product data.
- **Build a supplier database:** shop links, main categories, years on 1688, repeat buyer rate and followers for many suppliers at once.
- **Find a supplier's best sellers:** the IDs of the shop's hot offers come with every profile.

### What data do you get?

| Data | Fields |
|---|---|
| Supplier | company name, shop ID (`memberId`), shop link, supplier type (`sellerType`, for example `super_factory`), number of products |
| Shop header | founding date, years on 1688, repeat buyer rate, fulfilment rate, service score, ranking, certification, address and coordinates, main category, experience scores, factory area, staff, equipment |
| Company registration | registered name and address, founding date, registered capital, registration authority, business scope, verification date |
| Supplier profile | verification, tags, company properties |
| Shop metrics | star level, quality and fulfilment rates, followers, years on 1688, main category |
| Factory card (factories) | medal, response and on-time delivery rates, rankings, tags, videos, virtual tour, equipment, production lines, brands, main products, processing types, OEM minimums, trade volume, monthly output, material purchase time, description, address |
| Buyer ratings | good rate, grade, review counts, buyer impression tags |
| Hot offers | offer IDs of the shop's hot products |
| Supplier intelligence (optional) | certificates, customization services and prices, lead times, dropshipping metrics and ranking, taken from the shop's hot offer; for products also the factory card |
| Products (optional) | for each product: title, tiered prices, MOQ, stock, sales, images, attributes, shipping; optional SKU variants, reviews and same items |

### How to scrape 1688 suppliers

1. Paste shop links (`https://shop....1688.com/` or any page of the shop), shop IDs (`b2b-...`) or exact company names into **Supplier shop links, shop IDs or company names**.
2. To get products too, set **Max products per supplier** above 0.
3. Click **Start**. Supplier rows and products appear in the dataset while the run goes on.
4. Download the results as JSON, CSV, Excel or HTML, or get them through the API.

If you start the actor with an empty input, it runs a small example with two suppliers and 5 products each, so you can see what the data looks like.

### Input

| Field | Type | Default | What it does |
|---|---|---|---|
| `suppliers` | list of strings | empty | Shop links, shop IDs (`b2b-...`) or exact company names. One profile row per supplier. |
| `maxProductsPerSupplier` | integer, 0 to 1000 | `0` | How many products to scrape for each supplier. `0` means only the profile. |
| `scrapeProductPages` | boolean | `true` | Off: supplier products found by the company-name search come as cheaper search cards. |
| `includeSkuDetails` | boolean | `false` | Add every variant of a product with its options, price, stock and sales. |
| `includeDescriptionHtml` | boolean | `false` | Add the full product description as HTML. |
| `includeReviews` | integer, 0 to 100 | `0` | How many latest reviews to attach to each product. Charged per review. |
| `includeSupplierIntelligence` | boolean | `false` | Add a `supplierIntelligence` block to supplier and product rows. Charged as an add-on. |
| `includeSameItems` | boolean | `false` | Add up to 8 offers of the same item from other sellers to each product. Charged as an add-on when the list is not empty. |

#### Examples

Supplier profiles only:

```json
{ "suppliers": ["https://shop1388209852876.1688.com/", "b2b-2207252800234f4b31", "深圳市亿佳合兴科技有限公司"] }
```

Suppliers with up to 50 products each and supplier intelligence:

```json
{
  "suppliers": ["https://shop1388209852876.1688.com/"],
  "maxProductsPerSupplier": 50,
  "includeSupplierIntelligence": true
}
```

### Output

One row per supplier (`rowType` is `supplier`) and, with `maxProductsPerSupplier` above 0, one row per product (`rowType` is `product`). Supplier products carry the supplier in `source`. The dataset has three views: **Suppliers**, **Products** and **Search cards**. A dataset view shows all rows, so in the Suppliers view look at the rows that have a company name. Text fields are in the original Chinese. Example supplier row (shortened; real rows have more fields and full lists):

```json
{
  "rowType": "supplier",
  "status": "OK",
  "memberId": "b2b-1943477882",
  "companyName": "绍兴念念供应链有限公司",
  "offerCount": 233,
  "sellerType": "super_factory",
  "shopUrl": "https://shop1388209852876.1688.com/",
  "shopHeader": {
    "yearsOnPlatform": 13,
    "repeatBuyerRatePercent": 77.8,
    "fulfillmentRatePercent": 100,
    "serviceScore": 5,
    "ranking": "2026上榜一钻工厂",
    "address": "浙江省杭州市临平区和睦桥村",
    "mainCategory": "女装",
    "properties": [
      { "name": "工厂面积", "value": "1100m²" },
      { "name": "员工人数", "value": "40人" },
      { "name": "生产设备", "value": "100台" }
    ]
  },
  "registration": {
    "companyName": "绍兴念念供应链有限公司",
    "foundedDate": "2025年08月19日",
    "registeredCapital": "10万元",
    "registrationAuthority": "绍兴市柯桥区市场监督管理局"
  },
  "shopCard": { "starLevel": 4, "followers": "5.1w粉丝", "yearsOnPlatform": 13, "mainCategory": "连衣裙" },
  "factoryCard": {
    "medal": "金牌制造1钻",
    "onTimeDeliveryRatePercent": 99,
    "rankings": ["2026上榜一钻工厂", "连衣裙实力榜 第5名"],
    "equipment": [{ "name": "缝纫机", "brand": "LEJIANG", "count": 100 }],
    "productionLines": 2,
    "mainProducts": ["连衣裙", "时尚休闲套装", "女式毛呢外套"],
    "minOrderQuantityOem": "100件",
    "monthlyOutputValue": "5万以下"
  },
  "ratingSummary": { "goodRate": 99.9, "grade": 5, "counts": { "total": 11129, "good": 11129 } },
  "hotOfferIds": ["1017077334634", "987447954732", "939866835652"],
  "scrapedAt": "2026-11-13T12:00:51+00:00"
}
```

Product rows have the same fields as in the [1688 Product Details Scraper](https://apify.com/TheShark/1688-product-details-scraper): tiered prices, MOQ, stock, sales, images, attributes, supplier and shipping.

### How much does it cost to scrape 1688 suppliers?

Pay per event: a flat price per supplier, per product and per add-on. The current prices are on the **Pricing** tab.

| Event | When it is charged |
|---|---|
| `supplier` | One supplier profile collected (status `OK`). |
| `product` | One supplier product collected from its page. |
| `product-card` | One supplier product taken from the search results (`scrapeProductPages` off). |
| `reviews` | One review attached to a product. |
| `supplier-intelligence` | At least part of the supplier intelligence data was found for a row. |
| `same-items` | `sameItems` is not empty. |

Only rows with status `OK` are charged, and an add-on only when its data is in the row. A supplier found twice (for example by link and by name) is charged once. Set a maximum charge per run in Apify and the actor stops cleanly when it is reached.

#### Row statuses

| Status | Meaning | Charged? |
|---|---|---|
| `OK` | The supplier profile or the product was collected. | Yes |
| `NOT_FOUND` | No shop with this link, ID or company name, or the product is no longer on 1688. | No |
| `BLOCKED` | 1688 did not show this page this time. Run it again later. | No |
| `ERROR` | The row could not be collected, for example a value that is not a shop link. `statusMessage` says why. | No |

### Good to know

- **Products per supplier.** Products come from a search by the exact company name, the factory card list (factories) and the shop's hot and new offers. Up to about 180 to 260 products per supplier can be found without a 1688 account; the full catalog is shown only to logged-in users, and small shops have fewer.
- **Factory cards exist only for verified factories.** For trading companies the factory card is empty, and many suppliers have no customization data.
- **Company names must be exact.** A name is looked up with a 1688 search, and the supplier with the same name is taken. A shop link or shop ID is the most reliable input.
- **No contacts.** No phone numbers, emails, WeChat or QQ, or names of company contact persons. The only supplier contact in product rows is the public seller chat link.
- **Data is in Chinese.** Company names, addresses and tags come as 1688 shows them. Prices are in CNY.
- **Run settings.** Give the run a timeout of at least 5 minutes. The minimum memory is 1024 MB.

### Integrations and API

Start runs and download results with the [Apify API](https://docs.apify.com/api/v2) or the Apify clients for Python and JavaScript, run on a schedule, and send results to Google Sheets, Slack, Make, Zapier, webhooks and other tools supported by Apify.

### FAQ

**Where do I find the shop link or shop ID?**
Open the supplier's shop on 1688 and copy the link from the address bar: any page of the shop works. A shop ID looks like `b2b-1943477882`.

**Can I find suppliers by product keyword?**
Search the keyword with the [1688 Search Results Scraper](https://apify.com/TheShark/1688-search-results-scraper): every product card has the supplier's company name. Then give the company names to this actor.

**Can I paste a product link?**
A product link is not a supplier and is skipped. For products use the [1688 Product Details Scraper](https://apify.com/TheShark/1688-product-details-scraper); its rows include the supplier profile.

**Do I need a 1688 account or proxies?**
No. The actor uses its own proxies in China and does not log in.

**Is it legal to scrape 1688?**
The actor collects only publicly visible company and product information and no personal data. You are responsible for how you use the data and for following the laws and terms that apply to you.

### More 1688 scrapers

- [1688.com Wholesale Scraper](https://apify.com/TheShark/china-1688-scraper): every mode in one actor.
- [1688 Search Results Scraper](https://apify.com/TheShark/1688-search-results-scraper): fast, low-cost product cards by keyword, link or category.
- [1688 Product Details Scraper](https://apify.com/TheShark/1688-product-details-scraper): full product pages by link or offer ID.
- [1688 Image Search Scraper](https://apify.com/TheShark/1688-image-search-scraper): find products and suppliers by photo.
- [1688 Price Monitor](https://apify.com/TheShark/1688-price-monitor): track prices, stock and sales of your products.

# Actor input Schema

## `suppliers` (type: `array`):

Get a profile row for each supplier (rowType "supplier"): company name, registration, shop header and ratings, factory card, shop metrics and the IDs of the shop's hot offers. Accepted: a shop link (https://shop....1688.com/ or https://<name>.1688.com/, any page of the shop), m.1688.com/winport/b2b-....html, winport.m.1688.com/...?memberId=b2b-..., a shop ID (b2b-...) or the exact company name. A product link is not a supplier and is skipped. One supplier profile found is billed as one supplier event; not found suppliers and errors are free. No contacts (phones, emails, WeChat, QQ, names) are collected.

## `maxProductsPerSupplier` (type: `integer`):

How many products to scrape for each supplier. 0 (default) means only the supplier profile. Products come from a search by the exact company name, the factory card list (factories only) and the shop's hot and new offers. This is not the full catalog: 1688 closes it, and about 180-260 products per seller can be found. Each product is scraped as a normal product (full card, billed as a product) and carries the supplier in source. With 'Open product pages' off, products found by the company-name search come as cheaper search cards, but products without a search card (factory card list, hot and new offers) are still scraped from their product page and billed as a product.

## `scrapeProductPages` (type: `boolean`):

On (default): every supplier product is scraped from its own page, with the full set of fields. Off: products found by the company-name search are taken straight from the search results, which is much faster and cheaper (billed as the cheaper product-card event); such rows have the search-card fields (title, price tiers, image, seller, sales, trade scores). Products without a search card (factory card list, hot and new offers) are still scraped from their product page and billed as a product. Reviews, supplier intelligence and same items need product pages, so they are off in this mode.

## `includeSkuDetails` (type: `boolean`):

Add the full variant matrix: each variant with its options, price, stock and sales.

## `includeDescriptionHtml` (type: `boolean`):

Add the full product description as HTML. Description text and images are always included.

## `includeReviews` (type: `integer`):

How many latest reviews to attach to each product (0 to 100). 1688 shows anonymous visitors only part of a product's reviews, so some products get fewer. Buyer names, avatars and profiles are never collected. Charged per review delivered.

## `includeSupplierIntelligence` (type: `boolean`):

Add a supplierIntelligence block to supplier rows and product rows: certificates (including CE/FCC/RoHS), customization (services with prices, printing price list, lead times by quantity), dropshipping metrics and the ranking on 1688. A supplier row takes them from the shop's hot offer; a product row also gets the factory card. Charged as an extra event per row only when at least part of this data is found. Always included for free: company registration, shop header and ratings, the factory card of supplier rows and shop metrics.

## `includeSameItems` (type: `boolean`):

Add a sameItems list to each product: up to 8 offers of the same item from other sellers (title, price, sales text, image and link; no seller details). Billed as a same-items event only when the list is not empty. Needs product pages, so it is off when scrapeProductPages is false.

## Actor input object example

```json
{
  "maxProductsPerSupplier": 0,
  "scrapeProductPages": true,
  "includeSkuDetails": false,
  "includeDescriptionHtml": false,
  "includeReviews": 0,
  "includeSupplierIntelligence": false,
  "includeSameItems": false
}
```

# Actor output Schema

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

One dataset row per supplier and one per supplier product.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("theshark/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 = {}

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

```

## MCP server setup

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