1688 Wholesale Product Search Scraper

Search 1688 for wholesale products and export structured offers with original and English titles, wholesale and dropship prices, sales volume, supplier type, image and direct URL.

Unofficial / independent tool. This Actor is not affiliated with, authorized, sponsored, or endorsed by 1688. It retrieves publicly available data through a third-party API. You are responsible for using the output in compliance with 1688's terms and all applicable laws.

What this Actor does

This Actor focuses on one job: search 1688 wholesale products by keyword on 1688.com. Each query returns live 1688 wholesale offers through a managed commerce API.

• Searches 1688 wholesale products by one or more keywords.
• Returns price, promotion, wholesale and dropship prices in CNY.
• Includes sales volume, supplier type and supplier level.
• Provides offer IDs, images and direct 1688 URLs.

Input

Field	Type	Description
searchQueries	array	Wholesale product keywords to search on 1688. Chinese keywords return the broadest supplier catalog.
maxItems	integer	Maximum records to return (caps your spend).
proxyConfiguration	object	Optional Apify Proxy settings.

Example input

{
  "maxItems": 5
}

Output

The Actor returns one dataset item per 1688 wholesale product. Each item is a flat, analysis-ready JSON record. Example of a real returned item:

{
  "productId": 678901234567,
  "title": "纯棉帆布托特袋 现货批发 可定制LOGO",
  "titleEnglish": "Cotton Canvas Tote Bag, In-stock Wholesale, Custom Logo",
  "price": 8.5,
  "promotionPrice": 7.9,
  "wholesalePrice": 7.2,
  "dropshipPrice": 8.2,
  "sellerType": "factory",
  "unit": "个",
  "imageUrl": "https://cbu01.alicdn.com/img/ibank/example-1.jpg",
  "url": "https://detail.1688.com/offer/678901234567.html",
  "salesVolume": 42000,
  "retentionRate": 61.8,
  "supplierLevel": 6,
  "id": "678901234567",
  "source": "1688-search"
}

Output fields

Field	Description
productId	1688 offer ID
title	Original product title
titleEnglish	English product title
price	Price (CNY)
promotionPrice	Promotion price (CNY)
wholesalePrice	Wholesale price (CNY)
dropshipPrice	Dropship price (CNY)
sellerType	Factory / merchant type
unit	Wholesale unit
imageUrl	Product image URL
url	1688 product URL
salesVolume	Sales volume
retentionRate	Repeat / retention rate
supplierLevel	Supplier level
url	Canonical link to the item on the source site
id	Stable identifier for the item (when available)
source	Which list / query the item came from

How it works

• Direct API, no browser. Data is fetched over HTTP — no headless browser, no login, no cookies to manage.
• Honest failure. Transient upstream blocks (rate limits, edge protection) are retried with exponential backoff. If the source stays unavailable, the run fails loudly instead of returning a misleading empty dataset.
• De-duplicated. Items are de-duplicated by their identifier within a run.
• Pay per successful request. One product-search event ($0.035) is charged only after an upstream request returns data. maxItems caps the records written to the dataset.

Use cases

• Find China wholesale suppliers and products.
• Compare wholesale and dropship prices.
• Research factory assortment and sales signals.
• Export 1688 search results to JSON, CSV or Excel.

Integration

Run it from the Apify Console, on a schedule, or call it programmatically via the Apify API, the JavaScript / Python clients, or MCP. Output can be exported as JSON, CSV, or Excel, or pushed to your own storage.

FAQ

Do I need a 1688 account, cookies, or to log in? No. The Actor only reads publicly available data.

How am I billed? $0.035 per successful request that returns data; empty or failed requests are not charged.

Can I schedule it or call it from my own code? Yes — use Apify Schedules, the REST API, the official clients, or MCP.

Is this an official 1688 product? No. It is an independent tool and is not affiliated with 1688.