1688 Product Listings Scraper

What is 1688 Product Listings Scraper?

1688 Product Listings Scraper searches 1688.com, Alibaba's China-domestic wholesale marketplace, by keyword (Chinese or English) or by a search or category URL, and returns one dataset row per product listing card. Each row has the title, offer URL, image, CNY unit price range, order unit, supplier city, 诚信通 (TrustPass) years, 实力商家 and 工厂 flags, 回头率 repurchase rate, sold count and result position. Sourcing teams, importers, Amazon and Shopify sellers, price researchers and AI sourcing agents use it to see factory-gate prices and supplier signals before they negotiate.

Why sourcing teams use this 1688 scraper

• Supplier trust signals on every row. supplierYears, isTrustPass, isPowerfulMerchant, isFactory and repurchaseRatePercent let you shortlist reliable suppliers straight from search results.
• Filters that also cap cost. Price, MOQ, TrustPass years, repurchase rate, sold count and factory-only filters drop rows before they are saved, and filtered products are free.
• Chinese or English keywords. Search 无线耳机 or wireless earbuds, or paste filtered 1688 search URLs in startUrls.
• Sorted the way you shop. sortBy supports relevance (综合), monthly sales, price ascending, price descending and newest.
• Flat JSON for agents. One product per row through Apify MCP and the API, ready for spreadsheets, BI tools and LLM prompts.

Best fit for this Actor

• Designed for sourcing research that starts from a product keyword or a 1688 search page and needs a ranked list of wholesale offers.
• Use it when you want China-domestic wholesale pricing in CNY next to supplier tenure and repurchase signals.
• For the export-market view of the same product, continue with Alibaba Listings Scraper and compare supplier prices and MOQ in USD.
• For the retail price that buyers pay, then pass the same keyword to AliExpress Product Search Scraper to size the margin between wholesale and retail.
• Works with search and category result pages; each row links to the offer page through productUrl.

Example workflow: from a product idea to a supplier shortlist

An Amazon seller starts with a product idea, true wireless earbuds. They run the Actor with searchQuery set to 无线耳机, sortBy set to monthlySales, trustPassOnly on and minSupplierYears set to 3. The dataset returns offers with priceMin, priceMax, supplierLocation, supplierYears, repurchaseRatePercent and soldCount. They sort by repurchase rate, keep the suppliers above 20%, export the shortlist to a spreadsheet, then compare those prices with the export-market view from the Alibaba listings dataset. A weekly schedule with the same input tracks how prices and sold counts move over time.

Input

Field	Type	What it controls
searchQuery	string	Keyword to search, for example 无线耳机 or data cable.
startUrls	array	1688 search or category URLs to scrape directly.
maxResults	integer	Maximum products to return; also your cost ceiling. Default 100.
sortBy	string	relevance, monthlySales, priceAsc, priceDesc or newest.
minPrice / maxPrice	integer	CNY unit-price bracket.
minMoq / maxMoq	integer	Minimum-order-quantity (起批量) bracket.
minSupplierYears	integer	Minimum years on 诚信通 (TrustPass).
minRepurchaseRate	integer	Minimum 回头率 repurchase rate in percent.
minSold	integer	Minimum recorded sales (成交).
trustPassOnly	boolean	Keep only 诚信通 TrustPass suppliers.
powerfulMerchantOnly	boolean	Keep only 实力商家 powerful merchants.
factoryOnly	boolean	Keep only factories and manufacturers (工厂).
proxyConfiguration	object	Apify Proxy settings; residential, ideally China exit IPs, works well for 1688.

{
  "searchQuery": "无线耳机",
  "maxResults": 20,
  "sortBy": "monthlySales",
  "trustPassOnly": true,
  "minSupplierYears": 3,
  "proxyConfiguration": { "useApifyProxy": true }
}

Output

Each product is one row with recordType set to product.

Field	What it contains
productId, productUrl	1688 offer ID and detail.1688.com offer link
title, imageUrl	Listing title as shown on 1688 and main image
priceMin, priceMax, currency	Unit price range in CNY
minOrderQuantity, moqUnit	MOQ (起批量) when the card shows it, and the order unit such as 件
supplierName, supplierId, supplierUrl	Supplier identity when the search card includes it
supplierLocation	Supplier city or province
supplierYears, isTrustPass	诚信通 TrustPass tenure and membership
isPowerfulMerchant, isFactory	实力商家 and 工厂 badges
repurchaseRatePercent, soldCount	回头率 repurchase rate and recorded sales
rating	Shop score when the card shows one
position, searchQuery	Rank within the run and the originating keyword
site, scrapedAt	Source site and collection time
_warnings	Notes on a status row when a run ends without products

{
  "recordType": "product",
  "productId": "738026063940",
  "title": "华强北高品质pro4四代双耳入耳式超长续航真无线蓝牙耳机厂家批发",
  "productUrl": "https://detail.1688.com/offer/738026063940.html",
  "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN017pYgvk2484EoOWwtO_!!2215948597345-0-cib.jpg_270x270xzq60.jpg",
  "priceMin": 7.23,
  "priceMax": 7.23,
  "currency": "CNY",
  "minOrderQuantity": null,
  "moqUnit": "件",
  "supplierName": null,
  "supplierId": null,
  "supplierUrl": null,
  "supplierLocation": "东莞市",
  "supplierYears": 4,
  "isTrustPass": true,
  "isPowerfulMerchant": false,
  "isFactory": false,
  "repurchaseRatePercent": 20,
  "soldCount": 20000,
  "rating": null,
  "site": "www.1688.com",
  "scrapedAt": "2026-10-01T02:05:38.523Z",
  "position": 1,
  "searchQuery": "无线耳机"
}

Search cards on 1688 vary, so supplier name, MOQ and shop rating appear when the card carries them. Price, order unit, location, TrustPass years, badges, repurchase rate and sold count are the core signals on each product row.

Pricing

This Actor uses Pay per event plus Apify platform usage. You pay one 1688 product scraped event for each product saved to the dataset and one small Actor start event per run, and Apify platform usage for compute and proxy is billed on top. Products removed by your filters are free, and so is a status row. The live Pricing tab on this page shows the current event prices.

Worked example: a search with maxResults set to 50 that saves 50 products costs 50 product events, one start event and the platform usage of that run. Set maxResults and a maximum charge per run to cap spend.

API example

curl -X POST "https://api.apify.com/v2/acts/khadinakbar~1688-product-listings-scraper/run-sync-get-dataset-items?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchQuery": "data cable", "maxResults": 30, "trustPassOnly": true}'

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_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["title"], item["priceMin"], item["supplierLocation"])

Use with AI agents (MCP)

Connect the Actor to Claude, ChatGPT, Cursor or any MCP client through Apify MCP, then ask:

Search 1688 for 无线耳机 sorted by monthly sales, keep only TrustPass suppliers with at least 3 years, and return 20 offers with price range, supplier city, repurchase rate and sold count.

The agent calls the Actor, reads the dataset with get-dataset-items, and gets one row per offer with productUrl and scrapedAt for provenance. Keep maxResults small for quick answers; cost scales with the number of saved products.

Best results

Starting situation	Helpful action	Expected outcome
A product idea in English	Try the Chinese keyword too, for example 无线耳机	Broader, more native 1688 matches
Looking for proven suppliers	Set minSupplierYears, minRepurchaseRate and trustPassOnly	A shorter list of established sellers
Buying direct from makers	Turn on factoryOnly	Factory and manufacturer offers
Sample or small-batch orders	Set maxMoq to a low number	Offers you can order in small quantities
A filtered 1688 page you already use	Paste it in startUrls	The same results as your saved search
Steady, complete pages	Use residential proxy, ideally China exit IPs	Full search pages from the domestic site

Builder's note

I built this around search results because sourcing decisions start with a ranked list, and 1688's search cards already carry the signals buyers trust most: TrustPass years, factory badges and repurchase rate. I designed the filters to run before rows are saved, so a narrow supplier profile costs less instead of more. Prices stay in CNY exactly as 1688 shows them, which keeps currency conversion in your own workflow.

FAQ

What currency are prices in?

CNY (Chinese yuan). 1688 is the China-domestic marketplace, so prices are domestic wholesale prices.

Do filtered products cost anything?

No. Only products that pass your filters and land in the dataset are charged.

Can I scrape a single offer page?

The Actor works from search and category pages. Each row's productUrl links to the offer page for deeper review.

Why use a keyword in Chinese?

1688 is a Chinese-language site, so Chinese keywords usually match more listings. English keywords also work.

Responsible use

This Actor collects publicly visible 1688 listing data and stores no credentials. Use the data in line with 1688.com's terms, applicable laws and intellectual-property rules in your jurisdiction. 1688 and Alibaba are trademarks of their owners; this independent Actor is not affiliated with or endorsed by them. For questions or bugs, open a ticket in the Issues tab.