1688 Product Listings Scraper

What it does. Search 1688.com — Alibaba's China-domestic wholesale marketplace — by keyword (Chinese or English) or paste a search / category URL, and export every product listing card across pages: title, CNY price range, MOQ (起批量), supplier company, location, 诚信通 (TrustPass) years, 实力商家 (powerful-merchant) and 工厂 (factory) flags, 回头率 (repurchase rate), sold count, image, and offer URL. Lean, search-only, MCP-ready.

When to use it. Sourcing wholesale suppliers upstream of Alibaba.com (1688 prices are usually lower because it's the China-domestic tier), building B2B price datasets, comparing factory vs trading-company offers, populating supplier directories, and feeding sourcing-agent / AI workflows. Use a keyword for the fastest setup; paste startUrls when you already have filtered 1688 queries. This Actor scrapes search/category result pages, not single detail.1688.com/offer/<id>.html product pages.

Output (one record per product)

Field	Description
productId	1688 numeric offer ID
title	Product title (Chinese as listed)
productUrl	https://detail.1688.com/offer/<id>.html
imageUrl	Main product image
priceMin / priceMax	Unit price range in CNY (¥)
currency	CNY
minOrderQuantity	MOQ / 起批量
moqUnit	Order unit (件 / 个 / 双 / …)
supplierName	Supplier company name
supplierId / supplierUrl	Member ID / shop URL (when present)
supplierLocation	Province + city (e.g. 广东 深圳市)
supplierYears	Years on 诚信通 (TrustPass)
isTrustPass	诚信通 member (1688's verified-supplier tier)
isPowerfulMerchant	实力商家 badge
isFactory	Factory / 工厂 / 超级工厂
repurchaseRatePercent	回头率 — share of buyers who order again
soldCount	Recorded sales / 成交 (万 units expanded)
rating	Shop score (0–5, when present)
position	Result rank within the run
searchQuery	Originating keyword
scrapedAt	ISO-8601 timestamp

Pricing

Pay-per-event. $0.003 per product returned + a negligible $0.00005 actor-start fee. Products dropped by your filters are not charged. A 100-product run costs about $0.30. Pay-Per-Usage (compute + proxy passthrough) is also available for very large jobs.

Input

Field	Type	Notes
searchQuery	string	Keyword, e.g. 无线耳机 or data cable
startUrls	string[]	1688 search/category URLs (plain strings)
maxResults	int	Cap + cost ceiling (default 100)
sortBy	enum	relevance (综合) · monthlySales · priceAsc · priceDesc · newest
minPrice / maxPrice	int	CNY unit-price bracket
minMoq / maxMoq	int	MOQ bracket
minSupplierYears	int	Minimum 诚信通 TrustPass years
minRepurchaseRate	int	Minimum 回头率 (%)
minSold	int	Minimum sold count
trustPassOnly	bool	Keep only 诚信通 suppliers
powerfulMerchantOnly	bool	Keep only 实力商家
factoryOnly	bool	Keep only factories (工厂)
proxyConfiguration	object	Defaults to Apify Proxy; residential CN recommended

Example input

{
  "searchQuery": "无线耳机",
  "maxResults": 20,
  "sortBy": "monthlySales",
  "factoryOnly": true,
  "minRepurchaseRate": 20
}

Use via API (JavaScript)

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });
const run = await client.actor('khadinakbar/1688-product-listings-scraper').call({
  searchQuery: 'data cable',
  maxResults: 50,
  trustPassOnly: true,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Use via API (Python)

from apify_client import ApifyClient
client = ApifyClient("YOUR_TOKEN")
run = client.actor("khadinakbar/1688-product-listings-scraper").call(run_input={
    "searchQuery": "无线耳机",
    "maxResults": 50,
    "factoryOnly": True,
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

MCP / AI agents

Exposed as apify--1688-product-listings-scraper in the Apify MCP server. One keyword in → structured wholesale listings out, ideal for sourcing copilots. Pair it with the alibaba-listings-scraper and aliexpress-product-search-scraper actors to compare domestic-China (1688), export (Alibaba), and retail (AliExpress) pricing for the same product.

Reliability & anti-blocking

1688 is protected by Alibaba's Baxia anti-bot (the same family as Alibaba.com and AliExpress). The Actor uses a resilient proxy chain (residential preferred, China exit IPs ideal), Crawlee session pools with browser fingerprints, embedded-JSON-first parsing with a DOM fallback, and honest-fail: if every request is blocked it returns a single diagnostic record with a clear status message and charges nothing, rather than silently reporting an empty success. Residential proxies are strongly recommended — datacenter IPs are usually blocked, and overseas IPs may be redirected to global.1688.com.

FAQ

Does it scrape a single product page? No — it scrapes search/category result pages. Single detail.1688.com/offer/<id>.html URLs are rejected.

What currency are prices in? CNY (Chinese yuan ¥) — 1688 is a domestic-China marketplace.

Why are some fields null? Search cards don't always expose every field (e.g. supplierUrl, rating); those appear on the supplier's shop page. Price, MOQ, supplier name, location, and trust flags are reliably present when 1688 serves the full page.

Do filtered products cost money? No. Only products that pass your filters and land in the dataset are billed.

Legal

Use this Actor only for data you are legally permitted to access and process. You are responsible for complying with 1688.com / Alibaba's Terms of Service, applicable laws (including data-protection and IP law), and any robots restrictions in your jurisdiction. This Actor collects only publicly visible listing data and stores no credentials.