1688 Products Wholesale Scraper - Full Supplier Details

1688 Products Wholesale Scraper - Full Supplier Details

1688 Products Wholesale Scraper - Full Supplier Details extracts public wholesale product data from 1688.com by keyword or offer ID, including supplier details, tiered prices, MOQ, product media, shipping signals, and optional SKU details.

Search Chinese or English wholesale keywords, enrich specific 1688 offer IDs, and export structured product and supplier records for sourcing, market research, and procurement workflows.

Copy to your AI assistant

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

Use Apify Actor parsebird/1688-wholesale-scraper to scrape public 1688.com wholesale products. Example with ApifyClient: client.actor("parsebird/1688-wholesale-scraper").call(run_input={"keywords":["手机壳"],"maxResults":10,"sortBy":"bestSelling","proxyConfiguration":{"useApifyProxy":true,"apifyProxyGroups":["RESIDENTIAL"]}}), then read client.dataset(run["defaultDatasetId"]).iterate_items(). Key inputs: keywords array, offerIds array, maxResults integer default 50, priceMin/priceMax integer CNY filters, province/city Chinese supplier filters, minOrderQuantity integer, merchantType enum any/superFactory/verifiedMerchant, sortBy enum relevance/bestSelling/priceAsc/priceDesc, includeSkuDetails boolean, includeDescriptionHtml boolean, includeSupplierIntelligence boolean, proxyCountryMode rotate/CN/HK, proxyConfiguration residential proxy object. Output fields include offerId, title, detailUrl, price, quantityPrices, images, videoUrl, province, city, sales counts, MOQ, tags, category, supplier, specs, skuDetails, certificates, dropship, shipping, promotions, services, coupons, productFlags, description images/text/HTML when requested, sourceKeyword, scrapedAt. API docs: https://docs.apify.com/api/client/python/ and https://docs.apify.com/api/client/js/. Token: https://console.apify.com/account/integrations.

What is 1688 Products Wholesale Scraper?

1688 Products Wholesale Scraper - Full Supplier Details is a 1688 scraper for collecting public wholesale product and supplier data from 1688.com. Use it to search wholesale products by keyword, scrape specific product offer IDs, and export structured records for sourcing, price tracking, supplier research, or ecommerce analysis.

The actor runs on Apify, so you can use scheduling, API access, webhooks, integrations, and dataset exports without maintaining scraping infrastructure yourself.

What can this 1688 wholesale scraper do?

• Search 1688 products by Chinese or English keyword.
• Scrape specific 1688 offers by offerIds when you already know the product IDs.
• Apply price, province, city, MOQ, merchant type, and sorting filters.
• Extract product titles, prices, quantity price tiers, product images, SKU images, videos, category data, and public sales signals where available.
• Extract supplier fields such as company name, member ID, shop URL, factory flags, business inspection signals, ratings, and public factory stats where available.
• Optionally include full SKU variant matrices and raw description HTML.
• Send results to Apify integrations, Apify API, webhooks, databases, spreadsheets, or BI tools.
• Download results in JSON, CSV, Excel, HTML, XML, or RSS from the Apify dataset.

What data can you extract from 1688.com?

Field	Description
offerId	1688 product offer ID
title	Product title from the 1688 offer page
detailUrl	Direct 1688 product URL
price	Minimum and maximum unit price in CNY when exposed
quantityPrices	Tiered wholesale price breaks and quantity ranges
images, videoUrl, skuImages	Product media URLs from public page data
province, city	Supplier location when available
orderCount, saledCount, recentSoldCount	Public sales and demand signals when exposed
minOrderQuantity	Minimum order quantity
mixWholesale	Mixed-wholesale minimum amount and variety rules
supplier	Supplier identity, shop URL, inspection flags, ratings, factory stats, certifications, and public badges
specs	Product attribute table, such as material, brand, function, model, or category-specific specs
skuDetails	Optional SKU properties and variant matrix when includeSkuDetails is enabled
certificates	Public certificates, licenses, inspections, or patent labels when exposed
dropship	Optional distribution and dropship intelligence when includeSupplierIntelligence is enabled and the source exposes it
shipping	Public shipping, delivery, carrier, fee, weight, and buyer protection fields when available
promotions, services, coupons	Public promotion, service, and coupon metadata
descriptionImages, descriptionText	Product description images and extracted plain text
descriptionHtml	Raw product description HTML only when includeDescriptionHtml is enabled
sourceKeyword	Search keyword that produced the result in keyword mode
scrapedAt	UTC timestamp for the scrape

How to scrape 1688 wholesale products

1. Open 1688 Products Wholesale Scraper - Full Supplier Details on Apify.
2. Enter one or more keywords, such as 手机壳, 蓝牙耳机, or wireless earbuds.
3. Or add offerIds to scrape specific 1688 products directly.
4. Set maxResults; it applies per keyword and is ignored in offer ID mode.
5. Add optional filters such as priceMax, province, city, minOrderQuantity, and merchantType.
6. Keep residential proxy enabled for reliable access to 1688.
7. Run the actor, open the dataset, and export results as JSON, CSV, Excel, or connect them through the Apify API.

Input parameters

Parameter	Type	Required	Default	Description
keywords	array	No	Prefilled ["手机壳"]	Search terms, Chinese or English. Each keyword is searched separately. Ignored if offerIds is set
offerIds	array	No	[]	Specific offer IDs to scrape directly. Skips search
maxResults	integer	No	50	Max products per keyword, from 1 to 10,000. Ignored in offerIds mode
priceMin	integer	No	-	Minimum unit price in CNY
priceMax	integer	No	-	Maximum unit price in CNY
province	string	No	-	Supplier province in Chinese, for example 广东 or 浙江
city	string	No	-	Supplier city in Chinese, for example 深圳市 or 义乌市
minOrderQuantity	integer	No	-	Filter by supplier MOQ threshold
merchantType	string	No	any	any, superFactory, or verifiedMerchant
sortBy	string	No	relevance	relevance, bestSelling, priceAsc, or priceDesc
includeSkuDetails	boolean	No	false	Include full SKU variant matrix when available
includeDescriptionHtml	boolean	No	false	Include raw description HTML; description images and text are extracted when available
includeSupplierIntelligence	boolean	No	false	Include optional dropship and distribution intelligence when available
proxyCountryMode	string	No	rotate	rotate, CN, or HK
proxyConfiguration	object	No	Apify residential proxy	Proxy settings; residential proxy is recommended for 1688

Input / Output

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 can return up to 300 products total. Every keyword result includes sourceKeyword.

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
}

Example output:

{
  "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
    }
  ],
  "images": ["https://cbu01.alicdn.com/img/ibank/O1CN01HTCT63.jpg"],
  "province": "广东",
  "city": "深圳市",
  "minOrderQuantity": 2,
  "supplier": {
    "memberId": "b2b-2850655109d72ea",
    "companyName": "佛山市南海区三丰手机配件有限公司",
    "shopUrl": "https://winport.m.1688.com/page/index.html?memberId=b2b-2850655109d72ea",
    "isSuperFactory": true
  },
  "specs": [
    {
      "name": "材质",
      "value": "硅胶"
    }
  ],
  "descriptionImages": ["https://cbu01.alicdn.com/img/ibank/desc-1.jpg"],
  "descriptionText": "产品详情：本款手机壳采用液态硅胶材质...",
  "sourceKeyword": "手机壳",
  "scrapedAt": "2026-07-20T00:00:00+00:00"
}

Some fields depend on what public 1688 pages expose for a given offer. The actor returns null, empty arrays, or empty objects instead of invented values when a field is unavailable.

Python API example

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run = client.actor("parsebird/1688-wholesale-scraper").call(run_input={
    "keywords": ["手机壳"],
    "maxResults": 10,
    "sortBy": "bestSelling",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["offerId"], item["title"])

See the official Apify Python client documentation for authentication and dataset options.

JavaScript API example

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const run = await client.actor('parsebird/1688-wholesale-scraper').call({
  offerIds: ['735353578254', '672929783458', '927875250705'],
  includeSkuDetails: true,
  proxyConfiguration: {
    useApifyProxy: true,
    apifyProxyGroups: ['RESIDENTIAL'],
  },
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

See the official Apify JavaScript client documentation for more examples.

How much does it cost to scrape 1688 products?

What is the price per 1688 product?

Event	Free	Bronze	Silver	Gold
result	$0.00001 ($0.01 / 1,000)	$0.00001 ($0.01 / 1,000)	$0.00001 ($0.01 / 1,000)	$0.00001 ($0.01 / 1,000)
product	$0.00799 ($7.99 / 1,000)	$0.00779 ($7.79 / 1,000)	$0.00749 ($7.49 / 1,000)	$0.00699 ($6.99 / 1,000)

Each result event means one dataset item was saved. Each product event means one 1688 product was successfully enriched. Apify free trial credits may cover test runs where applicable.

Use cases

• Source 1688 suppliers for ecommerce, dropshipping, Amazon, Shopify, TikTok Shop, or offline wholesale buying.
• Compare tiered wholesale prices, MOQ, category, shipping, and supplier location across product niches.
• Monitor supplier pages and product details with Apify schedules.
• Build procurement dashboards or sourcing databases through Apify integrations.
• Export 1688 product data to JSON, CSV, Excel, Google Sheets, databases, or BI tools.

How it works

1. The actor validates keyword, offer ID, filter, enrichment, and proxy inputs.
2. In keyword mode, it searches 1688 and extracts public offer IDs from result pages.
3. In offer ID mode, it builds direct product URLs and skips search.
4. It fetches each public product page and parses embedded structured data and page metadata.
5. It normalizes source-backed fields into a stable dataset object and leaves unavailable values empty.
6. It pushes each product to the default Apify dataset and applies PPE charging only on the Apify platform.

Is it legal to scrape 1688.com?

Is scraping 1688 products legal?

Scraping publicly available web data is generally allowed in many jurisdictions, but you should review 1688.com's terms, avoid collecting private or sensitive information, and make sure your use case complies with applicable laws. For background, read Apify's guide: Is web scraping legal?.

Other 1688 scrapers / Related Actors

Actor	Best for
1688 Products Wholesale Scraper - Full Supplier Details	1688 products, prices, supplier details, SKU data, shipping, and sourcing research
Shopify Store Leads Scraper	Finding Shopify stores and ecommerce leads
eBay Sold Listings Scraper	Marketplace price research and sold listing data
YouTube Search Scraper	Search result data for product research content workflows
Website Contact Finder	Finding public contact details for supplier or lead lists

FAQ

Can I use this as a 1688 scraper API?

Yes. Start runs and fetch datasets through the Apify API, Python client, JavaScript client, webhooks, or integrations.

Can I scrape 1688 by English keywords?

Yes. The keywords field accepts Chinese or English search terms. Chinese terms often match 1688 listings more directly because the marketplace is Chinese-language.

Can I scrape specific 1688 products?

Yes. Add product offer IDs to offerIds. The actor skips search and enriches those product pages directly.

Why are some fields empty?

1688 pages vary by product, seller, category, region, and availability. The actor only returns source-backed values and leaves unavailable fields as null, empty arrays, or empty objects.

Does this actor require a proxy?

Residential proxy is recommended for reliable 1688 access. The input schema defaults to Apify residential proxy settings.

Can I schedule recurring 1688 monitoring?

Yes. Use Apify schedules to run this 1688 scraper daily, weekly, or at any interval.

Where can I report issues or request fields?

Open the Issues tab on the actor page and include your input example, run ID, and the 1688 product URL or offer ID.