Pricing

Rating

Developer

Actor stats

Categories

Share

1688 Wholesale Scraper | Fastest China B2B Supplier Data Extraction (2026)

50+ fields per result at 250+ products/minute — full supplier verification, tiered wholesale pricing, and dropship intelligence from 1688.com. The fastest and richest 1688 scraper on Apify.

Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.

zen-studio/1688-wholesale-scraper on Apify. Call:ApifyClient("TOKEN").actor("zen-studio/1688-wholesale-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items for results. Key inputs:keywords(array of search terms, Chinese or English, each searched separately),offerIds(array, alternative to keywords),maxResults(int, per keyword,default100). Full actor spec(input schema with all params/enums/defaults, output dataset fields,README):GEThttps://api.apify.com/v2/acts/zen-studio~1688-wholesale-scraper/builds/default(Bearer TOKEN) → inputSchema(JSON string, parse it), actorDefinition.storages.dataset.views.overview.transformation.fields(output field list), readme. Requires CN residential proxy. Get token: https://console.apify.com/account/integrations

How It Works

How to Scrape 1688.com Wholesale Data

Basic — single keyword

{
"keywords":["wireless earbuds"],
"maxResults":50
}

Multiple keywords in one run

{
"keywords":["wireless earbuds","phone case","蓝牙耳机"],
"maxResults":100
}

Each keyword is searched separately. maxResults applies per keyword, so this returns up to 300 products total. Every result includes a sourceKeyword field so you can tell which keyword produced it.

Best-selling products under 50 CNY

{
"keywords":["手机壳"],
"maxResults":100,
"priceMax":50,
"sortBy":"bestSelling"
}

Specific products by offer ID

{
"offerIds":["735353578254","672929783458","927875250705"]
}

Verified factories in Shenzhen with low MOQ

{
"keywords":["silicone case"],
"province":"广东",
"city":"深圳市",
"minOrderQuantity":50,
"merchantType":"superFactory",
"maxResults":200
}

Input Parameters

What Data Can You Extract from 1688.com?

Every result includes:

Product

• Title, detail URL, offer ID, category ID/name, full category path (e.g. 美容护肤/彩妆 > 面膜、面膜粉 > 贴片面膜), unit, top category
• Full image gallery (all images, not just the main one), video URL, description URL
• Tiered wholesale pricing (quantity breaks with min/max quantity and price per tier)
• Product specs (material, style, function, brand, dimensions — 15-20 attributes typical)
• SKU variants (optional): colors, sizes, models with per-variant price, discount price, original price, stock, image, weight, promotion flag, structured attributes (e.g. per-model technical specs), and per-variant packaging scale + unit (e.g. 10 片) and sales-volume band
• Customization / OEM support: whether the supplier accepts private-label, repackaging, or spec changes, with the supplier's own description
• Order count, total sales, repeat-customer rate, tags, out-of-stock flag
• Per-unit weight; mixed-batch minimums (min units & min varieties); per-buyer and promotion purchase limits and sampling support when the supplier sets them

Supplier

• Company name, founded year, province, city, login ID, user ID, member ID
• Seller type (super factory, TP factory, shili factory, brand-certified)
• Certification: type, number, link to inspection report
• Six trade service scores: composite, goods, logistics, dispute, return, consultation
• Factory stats (super factory only): employees, area (m²), patents, main devices, scale tier, certifications
• Stats (other tiers): repeat buyers, cross-border buyers, repeat rate, positive review rate, response rate, brand partner, total offers
• Verification flags: super factory, TP factory, shili factory, brand-certified, factory, TP, hyper, brand+, processing
• Detail-page trust badge (e.g. on-site verified · source-selected · service guaranteed)
• Factory tour video(s) when the supplier publishes one (title, playable URL, cover image, duration)
• Origin-merchant certification when present (industrial-belt flagship standing, with the official description) + the supplier's ranking-list standing

Supplier Intelligence (optional paid add-on — enable includeSupplierIntelligence; off by default)

• Authorized resale channels (Taobao/Cainiao, Pinduoduo, Xiaohongshu, Douyin, Kuaishou, etc.)
• Consign price (with shipping bundled)
• Metrics: 24h/48h pickup rates, 7-day/30-day dropship orders, distributor count, downstream store count, publish date

When the add-on is off, the dropship block still reports whether the product is distribution-enabled; the intelligence metrics and channels above are returned only when it is active.

Shipping

• Delivery promise in hours and days, carrier name, total shipping cost (CNY), unit weight (kg), origin location + region code
• Shipping-fee note when the cost is a platform estimate (e.g. "平台指导运费")

Promotions & flags

• Shop promotions (minimum spend, coupon codes, bundles) — each with its validity window and any regions excluded from free shipping
• Offer-specific coupons (claim link, discount value, validity dates, coupon type)
• After-sales services: warranty, return policy, claim-back guarantees, quality inspection, late-shipment compensation, rapid refund — with full descriptions
• Product flags: SKU offer, pre-sell, consign market, free sample, buyer protection, WeChat supply

Output Example

{
"offerId":"927875250705",
"title":"跨境苹果17pm手机壳磁吸16pro肤感防摔iphone15promax磨砂保护套",
"detailUrl":"https://detail.1688.com/offer/927875250705.html",
"price":{
"min":7.58,
"max":9.0,
"currency":"CNY",
"priceType":"UMP",
"promoLabel":"限时价"
},
"quantityPrices":[
{
"quantityRange":"2~99个",
"quantityMin":2,
"quantityMax":99,
"price":9.0
},
{
"quantityRange":"≥100个",
"quantityMin":100,
"quantityMax":null,
"price":7.58
}
],
"images":[
"https://cbu01.alicdn.com/img/ibank/O1CN01HTCT63.jpg",
"... 8 more"
],
"videoUrl":"https://cloud.video.taobao.com/play/.../538822573635.mp4",
"skuImages":[
{
"name":"白色",
"imgUrl":"https://cbu01.alicdn.com/img/ibank/O1CN01HTCT63.jpg"
},
"... 5 more"
],
"province":"广东",
"city":"深圳市",
"orderCount":1280,
"saledCount":52000,
"saledCountStr":"5万+",
"wantBuyCount":860,
"recentSoldCount":12000,
"soldDisplay":"全网10万+件",
"returnRate":0.56,
"repurchaseRate":0.56,
"offerRepurchaseRate":0.13,
"isPromoted":false,
"block":"BUSINESS",
"stock":99998,
"minOrderQuantity":2,
"supportsMix":true,
"mixWholesale":{
"minAmount":600,
"minVarieties":50
},
"purchaseLimits":{
"personalLimit":5,
"promotionLimit":2
},
"supportsSampling":true,
"unitWeight":0.03,
"tags":[
"退货包运费",
"先采后付",
"回头率56%"
],
"serviceTags":[
"深度验厂"
],
"promotionTags":[
"包邮"
],
"serviceLabels":[
"7天无理由退货",
"晚发必赔"
],
"categoryId":"126798019",
"topCategoryId":"122896001",
"categoryName":"手机保护套",
"categoryPath":"手机配件 > 手机壳/保护套 > 手机保护套",
"unit":"个",
"isOutOfStock":false,
"isCrossBorderTrade":true,
"customization":{
"supported":true,
"title":"商品支持贴牌等服务",
"shortTitle":"支持贴牌"
},
"supplier":{
"memberId":"b2b-2850655109d72ea",
"companyName":"佛山市南海区三丰手机配件有限公司",
"legalCompanyName":"佛山市南海区三丰手机配件有限公司",
"loginId":"sanfeng888",
"userId":"2850655109",
"foundedYear":2014,
"sellerType":"super_factory",
"bizType":"生产加工",
"tpYear":10,
"isOnline":true,
"fans":1280,
"mainCategory":"手机配件",
"address":"广东省佛山市南海区",
"coordinates":"113.13,23.02",
"shopUrl":"https://winport.m.1688.com/page/index.html?memberId=b2b-2850655109d72ea",
"imUrl":"https://wangwang.m.1688.com/chat?siteid=cnalichn&clientid=...",
"supportsDistribution":true,
"isFactoryInspected":true,
"isBusinessInspected":true,
"isSuperFactory":true,
"inspectionCreditUrl":"https://r.1688.com/...",
"sameDesignUrl":"https://s.1688.com/...",
"featureBadge":"实地验真 源头甄选 服务保障",
"factoryTags":[
{
"text":"回头率",
"value":"54%"
},
{
"text":"履约率",
"value":"96%"
}
],
"videos":[
{
"title":"老板带看视频",
"url":"https://cloud.video.taobao.com/play/.../443755241598.mp4",
"coverImage":"https://img.alicdn.com/.../tbvideo.jpg",
"durationSeconds":74,
"type":"factoryBossShowVideo",
"videoId":"475212724"
}
],
"rank":{
"text":"手机壳行业榜第1名",
"url":"https://r.1688.com/...",
"type":"ranking_list#jpzz"
},
"originMerchant":{
"type":"OF_ORIGIN_MERCHANT",
"description":"1688官方认证的深圳手机配件产业带旗舰商家",
"url":"https://popups.m.1688.com/..."
},
"certification":{
"type":"sgs",
"number":"编号:CANWT00466895",
"reportUrl":"https://r.1688.com/auth/fcaReportWireless.htm?..."
},
"scores":{
"composite":5.0,
"goods":4.0,
"logistics":4.0,
"dispute":5.0,
"return":4.33,
"consultation":4.5
},
"stats":{
"repeatBuyers":"1600+",
"crossBorderBuyers":"300+",
"repeatRate":0.54,
"positiveReviewRate":0.98,
"responseRate":0.99,
"brandPartner":"品胜",
"factoryArea":10380,
"employees":350,
"patents":33,
"mainDevices":46,
"scaleTier":"规上企业",
"certifications":"FDA认证",
"ownBrand":"三丰",
"totalOffers":180,
"rawCardDetail":[
{
"code":"byrRepeatCustomer",
"title":"回购老客",
"info":"1600+",
"unit":"人"
},
"... more"
]
},
"flags":{
"isSuperFactory":true,
"isFactory":true,
"isTp":true,
"isTpFactory":false,
"isShiliFactory":false,
"isSiliCertifiedBrand":false,
"isHyper":false,
"isBrandPlus":false,
"isProcessingTag":true,
"isSmt":true,
"isImall":false,
"isFullOnline":false,
"isTuoguan":false,
"isYuantouFlagship":true,
"isChtMember":false,
"isIndustrySeller":true,
"isEaseBuyDealer":true,
"isFactoryDealer":true
}
},
"specs":[
{
"name":"材质",
"value":"硅胶"
},
{
"name":"款式",
"value":"保护壳"
},
{
"name":"品牌",
"value":"三丰"
},
{
"name":"功能",
"value":"防震,磁吸,防摔"
},
"... more"
],
"skuDetails":{
"priceRange":"￥7.58-￥9.0",
"originalPriceRange":"￥7.58-￥9.0",
"totalVariants":250,
"properties":[
{
"name":"颜色",
"values":[
{
"name":"黑色",
"imageUrl":"https://cbu01.alicdn.com/img/ibank/O1CN01HTCT63.jpg"
},
"... 23 more colors"
]
},
{
"name":"型号",
"values":[
{
"name":"iPhone 16 Pro Max",
"imageUrl":null
},
"... 9 more models"
]
}
],
"variants":[
{
"specs":"黑色>iPhone 16 Pro Max",
"skuId":"5994388491419",
"specId":"8d82c517...",
"price":9.0,
"discountPrice":9.0,
"originalPrice":9.0,
"promotionSku":false,
"stock":9998,
"imageUrl":"https://cbu01.alicdn.com/img/ibank/O1CN01HTCT63.jpg",
"weight":0.03,
"attributes":[
{
"name":"适用机型",
"value":"iPhone 16 Pro Max",
"unit":null
}
],
"specScale":null,
"specUnit":null,
"salesTier":"万件采购"
},
"... 249 more variants"
]
},
"dropship":{
"enabled":true,
"consignPrice":"¥7.58",
"channels":[
"淘宝(菜鸟)",
"拼多多",
"小红书",
"抖音",
"快手"
],
"metrics":{
"orders30d":"10000+",
"orders7d":"1000+",
"pickupRate48h":0.75,
"pickupRate24h":0.49,
"distributorCount":"10000+",
"downstreamStoreCount":"1000+",
"publishDate":"2024年10月"
}
},
"shipping":{
"deliveryHours":48,
"deliveryDays":2,
"carrier":"中通快递",
"logisticsText":"承诺48小时发货·常发中通快递",
"unitWeight":0.03,
"location":"广东佛山",
"postFee":4.0,
"isFreeShipping":false,
"freeShippingThreshold":null,
"templateRemark":"平台指导运费",
"locationCode":"440605",
"protectionInfos":[
{
"name":"7天无理由退货",
"code":"qtwlybt",
"description":"7天无理由退货"
},
"... more"
]
},
"promotions":[
{
"type":"fixed",
"name":"满减",
"label":"满300元包邮",
"detail":null,
"discountFee":null,
"summary":null,
"availablePeriod":"有效期：2026.06.10 00:00:00-2026.12.29 00:00:00",
"extendDetail":"不免邮区域:新疆,西藏,海外,台湾,香港,澳门"
}
],
"services":[
{
"name":"延期必赔",
"code":"jqx_s",
"description":"当订单实际发货时间晚于约定发货时间，可获得理赔。",
"linkUrl":null
},
"... more"
],
"coupons":[
{
"couponId":"c1",
"type":"FIXED",
"typeName":"满减券",
"label":"满100减5",
"summary":"满100元减5元",
"validFrom":"2026-06-01",
"validTo":"2026-12-31",
"linkUrl":"https://..."
}
],
"productFlags":{
"isSkuOffer":true,
"isPreSell":false,
"isConsignMarket":true,
"isFreeSample":true,
"isBuyerProtection":true,
"isWeChatSupply":true,
"isCrossBorder":true,
"isOnePiece":true,
"isWholesale":true,
"isToTikTok":true,
"isToKuaiShou":true,
"isSupportMix":true,
"hasRelationOffer":true,
"isChtSingleOffer":false,
"isDetailForbidden":false,
"supportsCustomization":true
},
"sameDesignUrl":"https://s.1688.com/youyuan/index.htm?tab=imageSearch&imageId=...",
"winportUrl":"https://winport.1688.com/...",
"descriptionUrl":"https://itemcdn.tmall.com/...",
"descriptionImages":[
"https://cbu01.alicdn.com/img/ibank/desc-1.jpg",
"... more"
],
"descriptionText":"产品详情：本款手机壳采用液态硅胶材质，磁吸防摔……",
"descriptionHtml":"<div><img src=\"https://cbu01.alicdn.com/...\"/>……</div> (only when includeDescriptionHtml=true)",
"sourceKeyword":"手机壳",
"scrapedAt":"2026-06-19T07:55:00.000000+00:00"
}

Advanced Usage

Find suppliers with patents and large factories

{
"keywords":["bluetooth speaker"],
"merchantType":"superFactory",
"sortBy":"bestSelling",
"maxResults":100
}

The supplier.stats.patents, employees, and factoryArea fields let you filter post-scrape for serious manufacturers vs resellers.

Build a dropship sourcing list

{
"keywords":["LED strip light"],
"sortBy":"bestSelling",
"priceMax":30,
"maxResults":500
}

Filter results where dropship.enabled = true and wantBuyCount > 500 to find distribution-ready products with strong buyer demand.

Full product audit with SKU variants

{
"offerIds":["735353578254","672929783458"],
"includeSkuDetails":true
}

Adds full skuDetails matrix — every color/size combination with per-variant price, discountPrice, originalPrice, stock, imageUrl, weight, and promotionSku flag. Each variant carries its own skuId and specId for downstream catalog linking (TikTok Shop, Shopify, etc.).

Notes:

• Per-variant price / discountPrice / originalPrice are populated when the seller publishes a price per SKU. For listings priced by quantity tier instead of by SKU, those fields are null and priceRange (e.g. "￥7.58-￥9.0") covers the whole listing.
• Per-variant weight is populated when the seller declares a per-SKU shipping weight; otherwise null. The listing-wide shipping.unitWeight always carries the base weight.
• specs for two-axis matrices is joined by > (HTML-encoded as > for some listings) — e.g. "黑色>iPhone 15PLUS".

City-specific supplier research

{
"keywords":["硅胶制品"],
"city":"东莞市",
"minOrderQuantity":100,
"maxResults":300
}

Pricing

$4.99 per 1,000 products (free tier). Apify Starter/Scale/Business plans get volume discounts down to $3.99/1,000. Platform usage included.

Supplier Intelligence add-on (optional): enable includeSupplierIntelligence to add distribution & dropship intelligence. Only products that actually carry this data are billed the small add-on, on top of the base rate. Off by default, so standard runs are never charged for it.

Free plan preview: up to 20 results per run for your first 25 runs. Upgrade to any paid Apify plan for unlimited results.

FAQ

How many results can I extract? Up to 10,000 per keyword. Set maxResults to any value between 1 and 10,000. With multiple keywords, each keyword gets its own budget.

Can I search multiple keywords at once? Yes. Pass an array of keywords and each is searched separately in a single run. Results land in one dataset with a sourceKeyword field so you can tell which keyword produced each result.

How fresh is the data? Real-time. Every product, price, and supplier stat is fetched live on each run — no caching.

Do I need a 1688 account? No. All data is publicly visible on 1688.com. No login, no cookies, no session setup.

Does it work with English keywords? Yes, but Chinese keywords typically return more and better results since 1688 is a domestic Chinese marketplace. The scraper also translates certain category terms automatically.

Can I scrape specific products without searching? Yes. Pass product IDs in the offerIds array. The ID appears in any 1688 product URL as offerId=....

How fast is it? Search runs sequentially on a token-holding connection; supplier and product detail fetches run in parallel (40 concurrent per run) with automatic seller deduplication. Typical throughput: 250+ fully-enriched products per minute.

Can I filter by supplier verification? Yes. Set merchantType to superFactory (top-tier manufacturers) or verifiedMerchant (trusted sellers). Combine with province/city and minOrderQuantity for precise targeting.

What's the difference between orderCount, saledCount, soldDisplay, returnRate/repurchaseRate, and offerRepurchaseRate? orderCount is the 30-day order volume shown in search results. saledCount is lifetime sales (from the product detail page) and soldDisplay is the platform's headline sales figure (e.g. 全网10万+件). returnRate and repurchaseRate both carry the shop's repeat-customer rate (回头率) — the share of buyers who come back, a positive signal. Despite its name, returnRate is not a product return/refund rate; both fields hold the same 回头率 value (repurchaseRate is kept for backward compatibility). offerRepurchaseRate (复购率) is a distinct offer-level figure — the share of buyers who re-ordered this specific product (often empty on newer offers).

Do I get product images? Yes. Every result includes the full image gallery (not just the main image), plus the product video URL when available.

What happens if a supplier's data is incomplete? Fields return null rather than dropping entries. You always get the product data, and the scraper retries supplier fetches automatically on anti-bot blocks.

Scraping Product Reviews

This actor focuses on product and supplier data. For buyer reviews (star ratings, review text, buyer location, purchased specs, repeat-customer flags), use the dedicated 1688 Reviews Scraper. Copy the offerId values from this actor's output and paste them into the Reviews Scraper's productUrls input. Each review is a flat JSON row with 19 fields, paginated up to 500 reviews per product.

More Zen Studio scrapers for Chinese platforms

🛒 E-commerce

• 👁 Image
  Taobao 淘宝
  • Taobao Search Scraper
  • Taobao Product Detail Scraper
  • Taobao Seller Products Scraper
• 👁 Image
  JD.com 京东
  • JD.com Search Scraper
• 👁 Image
  Alibaba 阿里巴巴
  • Alibaba Scraper
• 👁 Image
  Goofish 闲鱼
  • Goofish (Xianyu) Search Scraper
  • Goofish (Xianyu) Seller Scraper
  • Goofish (Xianyu) Item Detail Scraper
  • Goofish (Xianyu) Item Comments & Q&A Scraper

🎬 Short-video & social

• 👁 Image
  Douyin 抖音
  • Douyin Search Scraper
  • Douyin Profile Scraper
  • Douyin Video Scraper
  • Douyin Comments Scraper
  • Douyin Transcripts Scraper
  • Douyin Creator Rankings Scraper
  • Douyin Live Recorder
  • Douyin Hot Search Scraper
  • Douyin Product Search Scraper
• 👁 Image
  RedNote 小红书
  • RedNote User Profile Scraper
  • RedNote Search Scraper
  • RedNote Comments Scraper
  • RedNote Product Search Scraper
  • RedNote Note Detail Scraper
  • RedNote Product Reviews Scraper
  • RedNote Live Recorder
• 👁 Image
  Xigua 西瓜视频
  • Xigua Video Search Scraper
  • Xigua Video Detail Scraper

🏠 Real estate & autos

• 👁 Image
  Anjuke 安居客
  • Anjuke For-Sale Listings Scraper
  • Anjuke New-Home Scraper
  • Anjuke Rental Listings Scraper
  • Anjuke Listing Detail Scraper
• 👁 Image
  58.com 58同城
  • 58.com Real Estate Scraper
• 👁 Image
  Autohome 汽车之家
  • Autohome (Che168) Used-Car Scraper

More from Clearpath

Sourcing from the SHEIN marketplace: enter a keyword and get the real factory or manufacturer behind each marketplace seller (name, address, phone, email), plus the EU responsible person.

• 👁 Image
  SHEIN Seller & Manufacturer Leads

Support

• Bugs: Issues tab
• Features: Issues tab

Legal Compliance

Extracts publicly available data from 1688.com. Users must comply with 1688 terms of service and data protection regulations (GDPR, CCPA). This tool is for research, sourcing, and competitive analysis purposes.

Fast 1688.com scraper with full product, supplier, dropship, and shipping data in every result.