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

Enable includeSkuDetails for variant prices and stock. Availability varies by product; the hero shows illustrative product values.

50+ fields per result at 250+ products/minute: supplier verification, tiered pricing & dropship intelligence.

1688.com Scraper Suite   •  China wholesale and marketplace intelligence

1688 ➤ You are here  Taobao 淘宝 + Tmall  Reviews Reviews & specs  JD.com 京东 products  Weidian 微店 contacts

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, default 100). Full actor spec (input schema with all params/enums/defaults, output dataset fields, README): GET https://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 To reach the maintainers, add feedback="<what you needed and did not get>" to any run, including one that worked: feature requests, a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. The run returns its data exactly as it would without the note, and a human reads every note.

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"]
}

A handful of fields come from the search listing itself and are therefore empty in this mode: orderCount, returnRate, repurchaseRate, offerRepurchaseRate, tags, serviceTags, block, isPromoted, sameDesignUrl and sourceKeyword. province and city are taken from where the product ships from instead. Everything else, including full supplier data, pricing tiers and SKUs, is identical to keyword mode.

Verified factories in Shenzhen with low MOQ

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

Input Parameters

• keywords (array): Search terms, Chinese or English. Each keyword is searched separately. Ignored if offerIds is set.
• offerIds (array, default []): Specific offer IDs to scrape directly. Skips search.
• maxResults (integer, default 100): Max products per keyword (1-10,000). Ignored in offerIds mode.
• priceMin (integer): Minimum unit price in CNY.
• priceMax (integer): Maximum unit price in CNY.
• province (string): Supplier province (Chinese name, e.g. 广东, 浙江).
• city (string): Supplier city (Chinese name, e.g. 深圳市, 义乌市).
• minOrderQuantity (integer): Filter by supplier MOQ threshold.
• merchantType (string, default any): any, superFactory (超级工厂), or verifiedMerchant (实力商家).
• sortBy (string, default relevance): relevance, bestSelling, priceAsc, priceDesc.
• includeSkuDetails (boolean, default false): Include full SKU variant matrix (colors, sizes, stock per variant).
• includeDescriptionHtml (boolean, default false): Include the full product description as raw HTML. Detail-image URLs and plain-text description are always included regardless.
• includeSupplierIntelligence (boolean, default false): Add distribution & dropship intelligence, product certificates and compliance data, package size per variant, sales volume and product badges. Optional paid add-on, off by default.
• proxyCountryMode (string, default rotate): rotate, CN, or HK.

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
• Review summary (reviewSummary): product rating, positive rate, review counts (total, positive, neutral, negative, with text), auto-generated review count, buyer impression tags with counts, and the product's on-time shipping and refund rates
• 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, typically 15-20 attributes)
• SKU variants (optional): colors, sizes, models with per-variant price, discount price, original price, stock, image, weight (kg, with the field that says whether the seller declared it per SKU or for one piece of the listing), promotion flag, structured attributes (e.g. per-model technical specs), and per-variant packaging scale + unit (e.g. 10 片) and sales-volume band. Every variant names each axis it is sold by (variantSpecs, e.g. 颜色 = 黑色 and 适用型号 = iPhone 16 Pro Max) beside the joined label, and every axis carries the id that identifies it across listings (properties[].propertyId)
• Customization / OEM: whether the supplier offers it, which services (printing, packaging, size, colour or material changes), each option with price tiers, linked offers, sample images and size ranges, plus the minimum order and lead time for customized orders
• 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
• Supplier stats for every seller type: repeat, positive-review, response and fulfillment rates; repeat and cross-border buyers; recent reviews and sales; hot new, top-rated and dropship bestseller products; employees, area (m²), devices, patents, certificates, management certificates, scale tier, OEM mode, factory type, own brands and brand count, brand partners and major-brand partnership, honors, total offers
• Verification flags: super factory, TP factory, shili factory, brand-certified, factory, TP, hyper, brand+, processing
• Detail-page trust badge when available (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.), each with its channel logo
• Consign price, plus the full dropship price tiers (per-quantity)
• Metrics: 24h/48h pickup rates, 7-day/30-day dropship orders, distributor count, downstream store count, publish date
• Return-protection services offered (e.g. official-warehouse returns) and downstream high-performance store lists
• Product certificates (certificates): quality/inspection reports, production licenses, and patents, when the offer carries them
• Seller intelligence (supplier.intelligence): total transaction volume, shop-favorited count, company label, and factory certification/ranking tags (HACCP/JET/工厂榜), on top of the supplier scores and factory stats already in every result
• Package size and weight per variant (packageDetails): length, width and height (cm), volume (cm³) and weight (g) for each variant, when the supplier lists them. Each row names every variant axis the supplier packs by (variant, e.g. 绿色 > 7页内袋, and variantSpecs with one entry per axis), plus the skuId that links it to skuDetails. Suppliers who pack every variant the same way publish no table: they declare the package size of the product itself, reported as unitDimensions (length, width, height in cm and volume in cm³) and unitWeightKg, with variants empty
• Sales volume (salesVolume): the headline sales figure with the period it covers (e.g. 1.4万+ within the last year)
• Compliance (compliance): official registration numbers such as the China Compulsory Certification (CCC) code or a cosmetics filing number, each with its description and reference link, plus regulatory safety warnings
• Product badges (productBadges): marketplace badges such as 1688严选 (quality-selected) or 镇店之宝 (the shop's flagship product), including the brand name on brand badges

When the add-on is off, the dropship block still reports whether the product is distribution-enabled; the intelligence fields above (including certificates, supplier.intelligence, packageDetails, salesVolume, compliance and productBadges) are returned whenever you enable it.

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,
  "reviewSummary": {
    "rating": 4.8,
    "positiveRate": 0.958,
    "reviewCount": 95,
    "positiveCount": 91,
    "neutralCount": 3,
    "negativeCount": 1,
    "withTextCount": 61,
    "withPhotosCount": null,
    "autoGeneratedCount": 34,
    "impressionTags": [
      { "tag": "质量挺好", "count": 7 },
      { "tag": "商家客服态度很好", "count": 5 },
      { "tag": "价格很便宜", "count": 4 }
    ],
    "positiveReviewRate": 0.96,
    "onTimeShippingRate": 0.98,
    "refundRate": 0.0
  },
  "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": [
    "深度验厂"
  ],
  "serviceLabels": [
    "7天无理由退货",
    "晚发必赔"
  ],
  "categoryId": "1042207",
  "topCategoryId": "7",
  "categoryName": "手机保护套",
  "categoryPath": "数码、电脑 > 手机配件 > 手机保护套",
  "unit": "个",
  "isOutOfStock": false,
  "isCrossBorderTrade": true,
  "customization": {
    "supported": true,
    "title": null,
    "shortTitle": null,
    "services": ["换材质"],
    "options": [
      {
        "service": "换材质",
        "selection": "single",
        "choices": [
          {
            "name": "三层瓦楞",
            "description": null,
            "priceTiers": [{ "minQuantity": 1000, "price": 2 }],
            "isDefault": false,
            "isDisabled": false,
            "imageUrl": null,
            "colorCode": null,
            "offerIds": ["1069497094284"],
            "unit": null,
            "minValue": null,
            "maxValue": null,
            "decimalPlaces": null,
            "listedDate": null
          },
          "... more"
        ]
      }
    ],
    "minOrderQuantity": 1,
    "minOrderUnit": "个",
    "leadTimeDays": 2
  },
  "supplier": {
    "memberId": "b2b-2850655109d72ea",
    "companyName": "佛山市南海区三丰手机配件有限公司",
    "legalCompanyName": "佛山市南海区三丰手机配件有限公司",
    "loginId": "sanfeng888",
    "userId": "2850655109",
    "intelligence": {
      "transactionAmount": "15,922.94",
      "shopFavoritedCount": 328072,
      "companyLabel": "源头旗舰",
      "isStrengthMerchant": true,
      "hasWinport": true,
      "certificationTags": ["入围2026必找工厂榜", "HACCP认证", "JET认证"]
    },
    "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+",
      "recentPositiveReviews": "200+",
      "recentSales": "1.3万+",
      "hotNewProducts": "20+",
      "topRatedProducts": "60+",
      "dropshipBestsellers": "30+",
      "repeatRate": 0.54,
      "positiveReviewRate": 0.98,
      "responseRate": 0.99,
      "fulfillmentRate": 0.96,
      "factoryArea": 10380,
      "employees": 350,
      "mainDevices": 46,
      "patents": 33,
      "certificateCount": 5,
      "brandCount": 2,
      "scaleTier": "规上企业",
      "ownBrand": "三丰",
      "brandPartner": "品胜",
      "certifications": "FDA认证",
      "oemMode": "OEM",
      "factoryType": "自有工厂",
      "isMajorBrandPartner": true,
      "managementCertificates": ["ISO9001", "ISO14001"],
      "honors": ["高新技术企业", "专精特新企业"],
      "totalOffers": 180
    },
    "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": "颜色",
        "propertyId": 3216,
        "values": [
          {
            "name": "黑色",
            "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01HTCT63.jpg"
          },
          "... 23 more colors"
        ]
      },
      {
        "name": "适用型号",
        "propertyId": 100018377,
        "values": [
          {
            "name": "iPhone 16 Pro Max",
            "imageUrl": null
          },
          "... 9 more models"
        ]
      }
    ],
    "variants": [
      {
        "specs": "黑色 > iPhone 16 Pro Max",
        "variantSpecs": [
          { "name": "颜色", "value": "黑色" },
          { "name": "适用型号", "value": "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,
        "weightSource": "sku",
        "attributes": [
          {
            "name": "适用机型",
            "value": "iPhone 16 Pro Max",
            "unit": null
          }
        ],
        "specScale": null,
        "specUnit": null,
        "salesTier": "万件采购"
      },
      "... 249 more variants"
    ]
  },
  "certificates": {
    "items": [
      {
        "name": "品牌资质",
        "type": "品牌资质",
        "number": "14945947",
        "issuer": "某认证机构",
        "images": ["http://cbu01.alicdn.com/i4/.../cert.png"]
      }
    ],
    "productLicenses": [],
    "inspections": ["品牌资质"],
    "patents": ["发明专利：一种..."],
    "content": "品牌资质"
  },
  "dropship": {
    "enabled": true,
    "consignPrice": "¥7.58",
    "consignPriceTiers": [
      { "price": "7.58", "text": "1件代发" },
      { "price": "7.2", "text": "≥2件" }
    ],
    "channels": [
      "淘宝(菜鸟)",
      "拼多多",
      "小红书",
      "抖音",
      "快手"
    ],
    "channelDetails": [
      { "name": "淘宝(菜鸟)", "icon": "https://img.alicdn.com/imgextra/i4/.../taobao.png" }
    ],
    "metrics": {
      "orders30d": "10000+",
      "orders7d": "1000+",
      "pickupRate48h": 0.75,
      "pickupRate24h": 0.49,
      "distributorCount": "10000+",
      "downstreamStoreCount": "1000+",
      "publishDate": "2024年10月",
      "dropshipHeat": 1014,
      "qualityPassRate": 1.0,
      "buyerKeepRate": 0.82
    },
    "hasMarketingAssets": true,
    "protections": [
      { "serviceName": "官方仓退货", "description": "通过官方退货仓将全网售后包裹转寄1688商家，提升售后效率，降低快递成本。" }
    ],
    "downstreamPerformance": {
      "highExperienceScoreList": [],
      "highPerfectLgtRateList": []
    }
  },
  "shipping": {
    "deliveryHours": 48,
    "deliveryDays": 2,
    "expectedDispatchHours": 20,
    "expectedDispatchText": "预计明天发货",
    "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"
}

Extra fields with the Supplier Intelligence add-on

With includeSupplierIntelligence enabled, each result also carries these fields (they are null or empty when the product has none):

{
  "packageDetails": {
    "variants": [
      { "skuId": "6173608954455", "variant": "3L小号--1个装",
        "variantSpecs": [{ "name": "规格", "value": "3L小号--1个装" }],
        "lengthCm": 15.0, "widthCm": 15.0, "heightCm": 12.0, "volumeCm3": 2700.0, "weightG": 500.0 },
      { "skuId": "6173608954456", "variant": "5L中号-1个装",
        "variantSpecs": [{ "name": "规格", "value": "5L中号-1个装" }],
        "lengthCm": 12.0, "widthCm": 25.0, "heightCm": 12.0, "volumeCm3": 3600.0, "weightG": 600.0 }
    ],
    "unitWeightKg": null,
    "unitDimensions": null,
    "verificationNote": "通过AI数据校验准确"
  },
  "salesVolume": { "display": "1.6万+", "period": "全网销量" },
  "compliance": {
    "registrations": [
      {
        "name": "非特化妆品备案证号",
        "number": "粤G妆网备字2023238779",
        "description": "本品已填写符合国家监管部门批准的化妆品证号",
        "referenceUrl": "https://baike.taobao.com/view.htm?id=37270575900"
      }
    ],
    "safetyWarning": "国家药监局提示您：请正确认识化妆品功效，化妆品不能替代药品，不能治疗皮肤病等疾病。"
  },
  "productBadges": [
    { "name": "1688严选", "description": "品质严选，放心采购 / 现货快发，服务保障", "brand": null },
    { "name": "品牌", "description": "100%正品 假一赔四", "brand": "奥吉利" }
  ]
}

Offer IDs that could not be returned

When you scrape by offerIds, every ID you submit gets a row, so an automation can always match input to output (unless the run stops early on your own charge limit). An offer that could not be returned comes back like this instead of being left out:

{
  "offerId": "692151573712",
  "error": "Offer is no longer available or is restricted by the marketplace"
}

Filter on the error field to route failures in Make.com, Zapier or n8n. Four reasons are reported:

error	Meaning
Offer is no longer available or is restricted by the marketplace	The listing is gone, hidden, or region-locked. Retrying will not help.
Offer could not be retrieved this run, retry it	A temporary problem. Submit the ID again.
Offer took too long to retrieve and was skipped this run, retry it	The offer was still being collected when the run moved on. Submit the ID again.
Not a valid offer ID. Expected the numeric 1688 offer ID (for example 692151573712), not a product title or URL	The input was not an offer ID. Check the value you sent.

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.), plus variantSpecs, which names every axis the listing is sold by (颜色 = 黑色, 尺码 = S) so colour and size are separate columns, not one string to split, and properties[].propertyId, the axis's own id for mapping the same axis across listings.

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 in kg and weightSource says where it comes from: "sku" when the seller declares a weight per SKU, "offer" when the seller declares one weight for a piece of the listing and it therefore applies to every variant (the same figure as unitWeight / shipping.unitWeight), null with a null weight when the seller declares neither. Of 30 listings measured, 18 declare per-SKU weights and 12 declare the per-piece weight. Package length, width, height and volume come with the Supplier Intelligence add-on (packageDetails), per variant or for the product's own package.
• A supplier declares package data one of two ways: a size table, which fills packageDetails.variants with one row per variant, or the package of the product itself, which fills packageDetails.unitDimensions (length, width, height, volume) and packageDetails.unitWeightKg (kg, the same figure as shipping.unitWeight) and leaves variants empty. Suppliers who state only a weight leave unitDimensions null, and packageDetails is null only when the listing declares neither.
• A listing priced per variant has no quantity breaks, so quantityPrices is empty for it and the spread is reported by price.min / price.max and priceRange. An empty quantityPrices therefore means "one price per variant, whatever the order size", not missing data.
• specs is the variant as the listing shows it, axis values joined by > (e.g. "黑色 > iPhone 15PLUS"). variantSpecs carries the same values one per axis, each with the axis name, and names nothing (name: null) only when the label does not split into as many values as the listing has axes.
• properties[].propertyId is the id of the axis itself, for normalising axes across listings where the label alone will not: 颜色 arrives as 3216 on most listings and 404 on others, 颜色分类 is a third colour axis, and a phone-case listing's 适用型号 is 100018377. Measured over 33 axes, no id ever appeared under two different labels, so the same id means the same axis; the reverse does not hold. It is null whenever no id is published for that axis, which happens for some products, so treat it as an identifier when present rather than a column that is always filled; the axis name is always there. A variant's variantSpecs entries line up with properties by position whenever they are named, which is how a variant row reaches its axis id.

City-specific supplier research

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

Integrations and scheduling

Run the 1688 wholesale products scraper on a schedule in Apify Console, daily for price and stock monitoring, weekly for catalogue refreshes. Each run can call a webhook when it finishes, so n8n, Make and Zapier flows pick up new rows without polling. The Apify API and the Apify MCP server take the same input, for scripts and AI agents.

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, certificates and compliance data, package sizes, sales volume and product badges. 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, and one search keyword per run (send several keywords and the preview searches the first one). Upgrade to any paid Apify plan for unlimited results and all keywords in one run.

FAQ

Why did a run with offerIds return nothing? The offer is no longer available or is restricted by the marketplace. Such offers are skipped rather than returned as empty rows, and the run reports the reason for each skipped offer. Most empty runs are single-offer lookups. Check the offer in a browser; if it loads, retry, since a detail fetch can fail once.

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 fresh on each run.

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.

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? 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, and which field should I use? Yes, in three separate fields, so you can take exactly what you need:

• images is the product gallery: the photos the listing shows at the top, in order, as complete URLs you can load directly. Use this one for a product card or a catalogue.
• skuImages is one photo per variant, each with its variant name (colour, model), for building a variant picker.
• descriptionImages is the long description strip. It is the seller's own marketing material, so it usually contains size charts, certificate banners, shop logos and repeated shots alongside real product photos. Use it when you want everything, not when you want a clean gallery.

The product video URL is in videoUrl when the listing has one.

What happens if a supplier's data is incomplete? Fields return null rather than dropping entries, so you always get the product data even when some supplier details are unavailable.

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 27 fields, paginated up to 500 reviews per product.

More Zen Studio scrapers for Chinese platforms

• Made-in-China Scraper
• TikTok Shop Review Scraper
• Lazada Product Scraper
• Lazada Reviews Scraper
• Lazada Store Scraper
• Naver Search Scraper

Also from the same studio (name, then account/slug for the URL https://apify.com/account/slug):

• AliExpress Product Scraper (zen-studio/aliexpress-scraper)
• Shopee Product Detail Scraper (zen-studio/shopee-product-detail-scraper)
• Shopee Product Reviews Scraper (zen-studio/shopee-product-reviews-scraper)
• Shopee Product Scraper (zen-studio/shopee-product-scraper)
• Shopee Live Scraper (zen-studio/shopee-live-scraper)
• Taobao Search Scraper (zen-studio/taobao-search-scraper)
• Taobao Product Detail Scraper (zen-studio/taobao-detail-scraper)
• Taobao Seller Products Scraper (zen-studio/taobao-seller-products-scraper)
• Taobao Judicial Auction Scraper (zen-studio/taobao-judicial-auction-scraper)
• Weidian Scraper (zen-studio/weidian-scraper)
• JD.com Search Scraper (zen-studio/jd-com-search-scraper)
• Alibaba Scraper (zen-studio/alibaba-scraper)
• Product Search by Image - 1688, Alibaba, AliExpress (zen-studio/product-search-by-image)
• Goofish (Xianyu) Search Scraper (zen-studio/goofish-xianyu-search-scraper)
• Goofish (Xianyu) Seller Scraper (zen-studio/goofish-xianyu-seller-scraper)
• Goofish (Xianyu) Item Detail Scraper (zen-studio/goofish-xianyu-item-detail-scraper)
• Goofish (Xianyu) Item Comments & Q&A Scraper (zen-studio/goofish-xianyu-item-comments-scraper)
• Goofish (Xianyu) Reverse Image Search Scraper (zen-studio/goofish-xianyu-visual-search-scraper)
• Coupang Review Scraper (zen-studio/coupang-review-scraper)
• Coupang Search Scraper (zen-studio/coupang-search-scraper)
• Coupang Product Detail Scraper (zen-studio/coupang-detail-scraper)
• Naver Shopping Scraper (zen-studio/naver-shopping-scraper)
• Naver Shopping Product Detail Scraper (zen-studio/naver-product-detail-scraper)
• Naver Shopping Review Scraper (zen-studio/naver-review-scraper)
• Douban Scraper (zen-studio/douban-scraper)
• Douban Reviews Scraper (zen-studio/douban-reviews-scraper)
• Douban Group Scraper (zen-studio/douban-group-scraper)
• Zhihu Scraper (zen-studio/zhihu-scraper)
• Weibo Search Scraper (zen-studio/weibo-search-scraper)
• Weibo Comments Scraper (zen-studio/weibo-comments-scraper)
• Kwai Search Scraper (zen-studio/kwai-search-scraper)
• Kwai Comments Scraper (zen-studio/kwai-comments-scraper)
• Kuaishou Scraper (zen-studio/kuaishou-scraper)
• Douyin Search Scraper (zen-studio/douyin-search-scraper)
• Douyin Profile Scraper (zen-studio/douyin-profile-scraper)
• Douyin Video Scraper (zen-studio/douyin-video-scraper)
• Douyin Comments Scraper (zen-studio/douyin-comments-scraper)
• Douyin Transcripts Scraper (zen-studio/douyin-transcripts-scraper)
• Douyin Creator Rankings Scraper (zen-studio/douyin-xingtu-rankings-scraper)
• Douyin Live Recorder (zen-studio/douyin-live-recorder)
• Douyin Hot Search Scraper (zen-studio/douyin-hot-search-scraper)
• Douyin Product Search Scraper (zen-studio/douyin-product-search-scraper)
• Douyin User Search Scraper (zen-studio/douyin-user-search-scraper)
• RedNote User Profile Scraper (zen-studio/rednote-user-profile-scraper)
• RedNote Search Scraper (zen-studio/rednote-search-scraper)
• RedNote Comments Scraper (zen-studio/rednote-comments-scraper)
• RedNote Product Search Scraper (zen-studio/rednote-product-search-scraper)
• RedNote Note Detail Scraper (zen-studio/rednote-note-detail-scraper)
• RedNote Product Reviews Scraper (zen-studio/rednote-product-reviews-scraper)
• RedNote Live Recorder (zen-studio/rednote-live-recorder)
• Xigua Video Search Scraper (zen-studio/xigua-video-search-scraper)
• Xigua Video Detail Scraper (zen-studio/xigua-video-detail-scraper)
• Bilibili Video Scraper (zen-studio/bilibili-video-scraper)
• Bilibili Danmaku Scraper (zen-studio/bilibili-danmaku-scraper)
• Naver Blog & Cafe Scraper (zen-studio/naver-blog-cafe-scraper)
• Naver Real Estate Scraper (zen-studio/naver-land-scraper)
• Anjuke For-Sale Listings Scraper (zen-studio/anjuke-real-estate-scraper)
• Anjuke New-Home Scraper (zen-studio/anjuke-new-home-scraper)
• Anjuke Rental Listings Scraper (zen-studio/anjuke-rent-scraper)
• Anjuke Listing Detail Scraper (zen-studio/anjuke-sale-detail-scraper)
• 58.com Real Estate Scraper (zen-studio/58-real-estate-scraper)
• Autohome (Che168) Used-Car Scraper (zen-studio/che168-car-scraper)
• Mafengwo Reviews Scraper (zen-studio/mafengwo-reviews-scraper)

Full directory: Zen Studio on Apify

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.

• 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.