1688 Listings Scraper

🇨🇳 1688.com Listings Scraper

Easily extract wholesale product data from 1688.com, Alibaba's domestic-China B2B marketplace and the original source for most products you'll find on Alibaba.com — usually at a fraction of the export price. The 1688.com Listings Scraper lets you search by keyword (Chinese or English) or fetch specific offer IDs and pulls back structured product data for sourcing, price intelligence, and supplier research.

✨ Features

• 🎯 Search filters: sort by price, set a price range in CNY, cap the minimum order quantity, and pick the supplier's city (Shenzhen, Yiwu, Guangzhou …).
• 🏭 Supplier intelligence on every row: manufacturer vs wholesaler, factory inspection, 1688 supplier rating with five service sub-scores, years on 1688, repurchase rates and buyer protections, with no detail page needed.
• 📈 Sales signals: orders, total units sold, units sold in the last 30 days and 30-day sales value, plus a flag on paid (sponsored) placements.
• 💴 Tiered wholesale prices: the volume-discount ladder, straight from the search card when it shows one and always on offer rows.
• 🔍 Keyword search & direct offer lookup: Chinese or English keywords, or known offer IDs.
• 🧾 Full offer pages on demand: attribute matrix, every image, after-sales policy, logistics and seller identity with includeDetails.
• 🌏 Built for 1688's IP blocking: every search races several proxy pools (your proxy, Residential HK, CN and any residential), so a blocked exit IP does not stop the run.

🛠️ How It Works

1. Enter keywords or offer IDs: Chinese (蓝牙耳机) or English (wireless earbuds) both work.
2. Narrow the search (optional): price sort, price range, maximum MOQ, supplier city.
3. Choose the depth: search rows only ($2 per 1,000) or full offer pages with includeDetails ($4 per 1,000).
4. Run it: the Actor handles pagination, deduplication, proxy rotation and retries.

📋 Input

Field	Type	Default	Description
keywords	string[]	["iphone case"]	Search terms. Chinese or English. Each keyword is paginated on its own.
offerIds	string[]	[]	Specific 1688 offer IDs (e.g. 782846321577). Skips search; filters do not apply.
maxItems	integer	50	Cap on rows saved across all keywords. 0 = unlimited.
maxPagesPerKeyword	integer	5	Search pages per keyword (50 offers each; 1688 stops at 2,000 results per keyword).
includeDetails	boolean	false	Open each offer page for the attribute matrix, images, after-sales policy, logistics and seller IDs.
sortBy	string	relevance	relevance, price-asc or price-desc.
minPrice / maxPrice	number	—	Price range in CNY, e.g. 10 and 20.
maxMoq	integer	—	Only offers you can order in this quantity or less, e.g. 1 for single-unit (dropshipping, samples) suppliers.
supplierCity	string	—	Supplier's city. English names of the main sourcing hubs work (Shenzhen, Guangzhou, Dongguan, Yiwu, Ningbo, Shantou, Quanzhou …); any other city in Chinese, e.g. 深圳. Provinces are not supported by 1688.
proxyConfiguration	object	Apify Proxy	Used for each search's first pool. You normally do not need to change it: searches also race Residential HK, CN and any residential, and offer pages start on Residential HK.

Example input: earbuds from Shenzhen suppliers, 10–30 CNY, buyable from 2 units, cheapest first:

{
  "keywords": ["wireless earbuds", "蓝牙耳机"],
  "sortBy": "price-asc",
  "minPrice": 10,
  "maxPrice": 30,
  "maxMoq": 2,
  "supplierCity": "Shenzhen",
  "maxItems": 200,
  "includeDetails": false
}

How the filters behave: 1688 applies them on its side, but it checks price on a slightly different price than the one on the search card. The Actor re-checks every row against minPrice, maxPrice and maxMoq and drops anything outside them before saving, so you are never charged for an off-filter row. The run may scan a few more pages to reach maxItems. The city filter is left to 1688: for county-level cities such as Yiwu, rows show the parent city (金华).

📊 Sample Output Data

A search row (includeDetails: false) from the example input above:

{
    "offerId": "639818266652",
    "keyword": "wireless earbuds",
    "title": "Pro4 TWS Wireless Headphone Pro5 Music Rename Earbuds5.0",
    "priceFrom": 10,
    "unit": "条",
    "minOrderQuantity": 2,
    "tierPrices": [
        { "price": 11.9, "beginAmount": 2 },
        { "price": 11, "beginAmount": 800 },
        { "price": 10, "beginAmount": 1000 }
    ],
    "soldCount": "成交59笔",
    "orderCount": 59,
    "unitsSold": 9690,
    "unitsSold30Days": 0,
    "location": "深圳市",
    "province": "广东",
    "sellerCompany": "深圳市音锐嘉科技有限公司",
    "businessType": "wholesaler",
    "factoryInspected": false,
    "businessInspected": false,
    "supplierRating": 4.5,
    "serviceScores": { "consultation": 3, "product": 2.67, "logistics": 4.14, "disputes": 5, "returns": 4.33 },
    "sellerYears": 8,
    "sellerTenure": "8年",
    "repurchaseRate": "16%",
    "supplierBadges": ["诚信通8年"],
    "buyerProtections": ["48小时发货"],
    "freightInsurance": false,
    "isSponsored": false,
    "sellerLoginId": "音锐嘉科技",
    "sellerUserId": "2205808694613",
    "sellerMemberId": "b2b-220580869461388141",
    "sellerWinportUrl": "https://m.1688.com/winport/b2b-220580869461388141.html?__existtitle__=1",
    "image": "https://cbu01.alicdn.com/img/ibank/O1CN01AsyWAj1jwniONesfL_!!2205808694613-0-cib.jpg",
    "url": "https://m.1688.com/offer/639818266652.html",
    "scrapedAt": "2026-10-04T07:56:22.522Z"
}

An offer row (includeDetails: true) keeps the search-row fields and adds the offer page (trimmed here):

{
    "offerId": "1080618692439",
    "keyword": "手机壳",
    "title": "适用苹果Duo折叠屏透明PC手机壳 iphone Duo磨砂半透防摔保护壳套",
    "priceFrom": 5,
    "priceTo": 6.5,
    "unit": "个",
    "minOrderQuantity": 3,
    "tierPrices": [
        { "price": 5, "beginAmount": 3 },
        { "price": 6.5, "beginAmount": 3 }
    ],
    "orderCount": 1,
    "unitsSold30Days": 3,
    "attributes": [
        { "name": "材质", "value": "PC" },
        { "name": "功能", "value": "防摔" },
        { "name": "款式", "value": "透明" }
    ],
    "images": ["https://cbu01.alicdn.com/img/ibank/O1CN01gIRcZiWY6cI3thOC_!!2215594841224-0-cib.jpg"],
    "services": ["退货包运费", "晚发必赔", "极速退款"],
    "logistics": { "location": "广东深圳", "deliveryLimit": "承诺25天发货", "unitWeight": 0.03 },
    "sellerCompany": "深圳市福田区荣华数码产品商行",
    "businessType": "manufacturer",
    "factoryInspected": false,
    "supplierRating": 4.5,
    "serviceScores": { "consultation": 3, "product": 5, "logistics": 4.14, "disputes": 5, "returns": 5 },
    "sellerWinportUrl": "https://winport.m.1688.com/page/index.html?memberId=b2b-2215594841224a1709",
    "url": "https://m.1688.com/offer/1080618692439.html"
}

📋 Output Fields

A search row has up to 35 fields and costs $0.002 ($0.001 until October 18, 2026). An offer row (includeDetails: true) has about 40 and costs $0.004: everything on the search row plus the offer page. Offers requested by offerIds skip search, so they carry only the offer-page fields. The dataset has a view for each row type.

Field	Type	Search row	Offer row	Description
offerId, title, url, image	string	✅	✅	Offer ID, title, link and main image
keyword	string	✅	✅	The search term this row came from
priceFrom	number	✅	✅	Lowest price (CNY)
unit	string	✅	✅	Unit the price is quoted in (个, 件, 条 …)
minOrderQuantity	number	✅	✅	MOQ, the minimum you can order
tierPrices	array	✅*	✅	Wholesale ladder, { price, beginAmount } per tier. *On search rows when the card shows tiers
soldCount	string	✅	✅	Sales as 1688 renders them (成交N笔)
orderCount	number	✅	✅	Completed orders as a number
unitsSold	number	✅	✅	Total units sold
unitsSold30Days	number	✅	✅	Units sold in the last 30 days
salesValue30DaysCny	number	✅	✅	30-day sales value in CNY, a floor (1688 shows ranges like 1万+)
location, province	string	✅	✅	Supplier city and province
sellerCompany	string	✅	✅	Registered company name
businessType	string	✅	✅	manufacturer (生产加工) or wholesaler (经销批发)
factoryInspected	boolean	✅	✅	1688 inspected the factory on site (深度验厂)
businessInspected	boolean	✅	✅	1688 verified the business (深度验商)
supplierRating	number	✅	✅	1688 composite supplier rating, 0–5
serviceScores	object	✅	✅	Sub-scores 0–5: consultation, product, logistics, disputes, returns
sellerYears / sellerTenure	number / string	✅	✅	Years on 1688 (number, and as 1688 renders it)
repurchaseRate	string	✅	✅	Share of the shop's buyers who ordered again
productRepurchaseRate	string	✅	✅	Same for this product
supplierBadges	array	✅	✅	Badges such as 实商, 深度验厂, 诚信通N年
buyerProtections	array	✅	✅	e.g. 7天包换 (7-day exchange), 48小时发货 (ships within 48 h)
freightInsurance	boolean	✅	✅	Shipping insurance included
isSponsored	boolean	✅	✅	Paid placement (1688 P4P ad)
sellerLoginId, sellerUserId, sellerMemberId, sellerWinportUrl	string	✅	✅	Seller IDs and storefront link
scrapedAt	string	✅	✅	ISO 8601 timestamp
priceTo	number	—	✅	Top of the tiered price range
attributes	array	—	✅	Specification matrix, { name, value } pairs (material, model, size …), typically ~16
images	array	—	✅	Every image: gallery, offer list and SKU, deduplicated
services	array	—	✅	After-sales guarantees, e.g. 晚发必赔 (compensation for late dispatch)
servicePolicy	object	—	✅	The two headline guarantees plus the full detail list
logistics	object	—	✅	Shipping origin, dispatch commitment, unit weight
wantBuy	string	—	✅	Buyers who registered purchase intent

💡 Tips

• Find factories, not resellers: combine businessType = manufacturer with factoryInspected = true and sort by supplierRating.
• Dropshipping and samples: set maxMoq to 1 to keep only suppliers that sell single units.
• Sourcing hubs: supplierCity narrows a keyword to its cluster: Shenzhen for electronics, Yiwu for small commodities, Guangzhou for apparel and beauty, Dongguan for hardware, Shantou for toys.
• Skip ads: filter out isSponsored rows to see 1688's organic ranking.
• Proxies: leave the default. 1688 blocks by IP reputation and which pool passes changes by the hour, so the Actor races several pools on every search.
• Compare 1688 ↔ Alibaba.com by pairing this Actor with piotrv1001/alibaba-listings-scraper on the same keywords to see domestic vs export pricing.

💰 Pricing

This Actor uses Pay-Per-Event pricing — you only pay for results, not compute time or proxy GBs.

Event	Price	Triggered when
product-listing	$2.00 / 1,000 results (from October 18, 2026; $1.00 until then)	A search row is saved (includeDetails: false): price, MOQ, tiers when shown, sales, supplier rating and scores, business type, inspections, badges, seller IDs.
item-detail	$4.00 / 1,000 results	An offer row is saved (includeDetails: true): the search row plus the full price ladder, attribute matrix, every image, after-sales policy and logistics.

Rows dropped by your price or MOQ filter are never charged. Proxy traffic is included: there is no separate proxy bill.

Optimize your sourcing and price intelligence with 1688.com Listings Scraper today! 🚀