1688 Product Scraper - MOQ Prices & Supplier Data

Get sourcing-ready 1688 products with the full MOQ price ladder, supplier trust signals, and English titles - not a Chinese-only list with one misleading price.

1688 is where most Western sourcing happens before it reaches Alibaba, but the data is hostile to anyone working from a spreadsheet. Titles are Chinese, the page shows a single "from" price that hides the quantity breaks you actually buy at, the minimum order quantity lives in a different block, and the supplier signals that decide whether a factory is worth an inquiry are spread across badges and tags. This Actor turns a keyword, a product URL, an offer ID, or a supplier shop into rows a sourcing agent can filter: every quantity break, the MOQ and unit, the supplier's province and city, the trust flags 1688 publishes, sold count, images, SKU variants, and a machine-translated English title next to the Chinese original.

No login. No proxy configuration. No start fee. You pay per product returned.

✅ What you get / ❌ What this isn't

✅ What you get	❌ What this isn't
The full MOQ price ladder (priceTiers), every quantity break with its unit price	Not a single "from" price that collapses a three-tier ladder into one number
English titles (titleEn) alongside the Chinese original	Not a Chinese-only export you have to paste into a translator column by column
Four entry modes: keyword, offer URL, offer ID, supplier shop	Not a URL-only scraper that makes you find the products yourself first
Sourcing filters: price range, MOQ ceiling, supplier tier, province, city, sort	Not an unfiltered dump you pay for and then throw half of away
Proxy handled for you - CN residential sessions, included in the price	Not a form that asks you to pick a proxy country and fails when you guess wrong
Zero credentials - no login, no session cookie on the form	Not a scraper that asks for your 1688 account cookie before it will run
No start fee, billed per successfully returned product	Not a $0.0049-per-Start fee that doubles the bill on a 10-product lookup
Filtered-out rows are free - the filter runs before billing	Not a per-row charge for products that failed your own price or MOQ filter
Honest diagnostics in OUTPUT for every offer that could not be extracted	Not a silent partial run that hides what it failed to fetch

🔎 Why use this 1688 scraper

• The MOQ ladder is the product. priceTiers returns every quantity break 1688 publishes, in order. A listing that shows "¥7.20" is really 20 pieces at ¥7.20, 1,000 at ¥7.00, and 10,000 at ¥6.80. Landed-cost maths on the headline price alone is wrong by the size of your order.
• English titles for a Western spreadsheet. titleEn is filled from 1688 when available and machine-translated otherwise, so the export is readable by a buyer who does not read Chinese. The Chinese title is kept, because that is what you paste back into 1688 or send to an agent.
• Filters that match how sourcing actually works. Budget ceiling (priceMax), MOQ ceiling (minOrderQuantity), supplier trust tier (merchantType), region (province, city), and candidate ranking (sortBy, including bestSelling). Every filter is applied before the row is billed.
• Supplier trust signals, parsed not guessed. merchantSigns exposes the flags 1688 sets on the offer page: factory-verified, 实力商家 (powerful merchant), 诚信通 (TrustPass), industry seller. merchantTags carries the visible badges such as 1688严选 and 深度验厂.
• Proxy is not your problem. 1688 serves an empty shell to traffic from outside China. The Actor always uses CN residential sessions and the cost is inside the per-product price, so there is no proxy control to misconfigure and no failure mode created by picking the wrong country.
• Four entry modes, one output shape. Keyword search, direct offer URL, bare offer ID, and supplier shop all produce the same row schema, so a monitoring workflow and an exploratory search can share downstream code.
• Partial success is reported, not hidden. Offers that hit verification or disappeared are listed in OUTPUT.failedOffers with a reason code and are never charged.

👥 Who it's for

Sourcing agents, importers, and marketplace sellers who need 1688 product economics in a spreadsheet, and developers building product-sourcing pipelines.

• Build a shortlist of suppliers for one product and compare real quantity-break pricing side by side.
• Check whether a target landed cost is reachable at your order size before you contact anyone.
• Filter a category down to factories in one province so a single freight consolidation covers the whole order.
• Refresh a tracked catalog of offer IDs on a schedule and watch price ladders and sold counts move.
• Feed normalized product rows into a catalog, an ERP, a pricing model, or an AI sourcing agent.

Example tasks

Ready-to-run configurations. Open one, copy the input, and adapt it:

• Find wholesale suppliers on 1688 by keyword
• Search 1688 with Chinese keywords and get English titles
• Check a 1688 product price and MOQ ladder
• Scrape all products from one supplier shop
• Find best-selling 1688 products under 50 CNY
• Scrape verified 1688 factories only
• Compare several 1688 offers by ID
• Export 1688 SKU variants for catalog import
• Source from Guangdong suppliers on 1688
• Export 1688 products for a sourcing spreadsheet

⚙️ How to scrape 1688 products

1. Enter what you want to scrape: search keywords, offer URLs, offer IDs, or supplier shop URLs. Any one of them is enough, and they can be combined in a single run.
2. Set the filters that describe your sourcing constraint: priceMax for the budget, minOrderQuantity for the largest MOQ you can accept, merchantType for the supplier tier, province or city for the region.
3. Set maxProducts. You are billed per returned product, so this is also your budget cap.
4. Click Start.
5. Open the Output tab and pick a view: 1688 products for the overview, MOQ price ladder for quantity breaks, Suppliers for the trust and region columns, SKU variants when includeSkuDetails is on.
6. Export as JSON, CSV, or Excel, or pull the dataset through the API into your own workflow.

Chinese or English keywords? Run both

Both languages work, and the folklore that Chinese keywords always return more rows did not survive measurement. Measured on 2026-07-29 through CN residential sessions, five search pages per keyword, counting unique offer IDs, in two rounds a few minutes apart:

Keyword	Unique offers, round 1	Unique offers, round 2
无线充电器	53	30
wireless charger	39	96
蓝牙耳机	20	25
bluetooth earbuds	38	38
瑜伽垫	not measured	44
yoga mat	not measured	45
手机壳	not measured	50
phone case	not measured	76

Round 1 says Chinese wins on 无线充电器 and round 2 says English wins on the same keyword by three times. The variance between sessions is larger than the difference between languages, because 1688's anonymous mobile search serves a partly randomized, ad-influenced slice of the catalog and recycles rows across pages.

The usable rule: the two languages surface different offer sets, and neither is reliably larger. For a thorough shortlist, run both and let offer-ID deduplication merge them. This is also why translateTitles defaults to true: search in whichever language you like, read the results in English.

Get a fresh list on a schedule

Save your input as a task, then attach a schedule to it. A weekly run over a offerIds list is the cheapest way to watch a tracked catalog: price ladders and soldCount move, and you can diff the dataset between runs. Because billing is per returned product and there is no start fee, a weekly 20-product refresh costs the same as running it once by hand.

📥 Input

{
    "searchQueries": ["无线充电器"],
    "sortBy": "bestSelling",
    "priceMax": 50,
    "minOrderQuantity": 100,
    "merchantType": "superFactory",
    "province": "Guangdong",
    "translateTitles": true,
    "maxProducts": 20
}

Direct lookup by URL or ID, combined with a supplier shop:

{
    "offerUrls": [{ "url": "https://detail.1688.com/offer/588600851175.html" }],
    "offerIds": ["927875250705"],
    "supplierUrls": [{ "url": "https://winport.m.1688.com/page/index.html?memberId=huanandzc" }],
    "includeSkuDetails": true,
    "maxProducts": 50
}

Entry modes

• searchQueries - product keywords, Chinese or English. Each query is paged through 1688's public mobile search, and the candidates are ranked by sortBy before any offer page is fetched.
• offerUrls - public product detail URLs, for example https://detail.1688.com/offer/588600851175.html.
• offerIds - bare numeric offer IDs. Use this to refresh a tracked catalog without storing URLs.
• supplierUrls - public winport.m.1688.com supplier URLs, taken from the supplierUrl field of any product row. The Actor follows the shop's mobile infinite-scroll pages until maxProducts is reached or the catalog is exhausted. Desktop shop*.1688.com pages redirect anonymous traffic to login and are not supported.

Filters

• sortBy - relevance (default), bestSelling, priceAsc, priceDesc. Ranking is applied by the Actor over the collected search candidates, using the transaction count and price printed on each search card, because 1688's anonymous search accepts a sort parameter and then ignores it.
• priceMin / priceMax - integer CNY bounds tested against the cheapest step of each offer's quantity ladder.
• minOrderQuantity - the largest MOQ you will accept. An offer whose minimum order quantity is above this number is dropped, and so is an offer that does not publish an MOQ at all.
• merchantType - any (default), superFactory (factory-verified sellers), verifiedMerchant (实力商家 / 诚信通 / 深度验厂 sellers).
• province / city - accepts Chinese (广东, 深圳) or English (Guangdong, Shenzhen). Administrative suffixes are normalized, so 广东 matches 广东省.

Output options

• includeSkuDetails - adds skuVariants (variant name, price, stock, image) and the raw skuMatrix. Off by default because most sourcing spreadsheets do not need the variant grid.
• includeDescriptionHtml - fetches the offer description document into descriptionHtml. One extra request per product and a large field, so it is off by default.
• translateTitles - fills titleEn with a best-effort machine translation when 1688 does not publish an English title. On by default.
• maxProducts - hard cap on returned products (1-500, default 20). This is your budget cap.

Input aliases

Input JSON written for other 1688 Actors validates here without edits:

• keywords and queries are accepted as aliases for searchQueries and merged with it.
• maxResults is accepted as an alias for maxProducts and takes precedence when both are present.

What is not on the form

• Proxy. There is no proxy control. 1688 requires CN residential sessions, that is a property of the target site rather than a user preference, and the cost is included in the per-product price.
• Login. There is no credential field on the form. Public offer pages, mobile search, and winport supplier pages are all readable anonymously. An advanced sessionCookie field exists for API callers who need a logged-in session for a restricted listing, but it is never required and is never written to logs or datasets.

📤 Output

offerId	titleEn	priceMin	MOQ	priceTiers	companyName	city
588600851175	QC3.0 charger wireless charging USB head 18W	6.8	20	20 @ 7.20, 1000 @ 7.00, 10000 @ 6.80	深圳豪诺天电子有限公司	深圳市
773524241414	35W wireless charger, 30W round desktop charging	11.5	2	2 @ 13.50, 200 @ 12.50, 1000 @ 11.50	深圳市雅菲电子有限公司	深圳市
761765041545	Portable Wi-Fi battery charger	8.4	10	10 @ 9.00, 1200 @ 8.80, 10000 @ 8.40	惠州市优仕通进出口有限公司	惠州市

One real product, in full

This is an unedited row (images and attributes trimmed for length, English title from the built-in translation), scraped on 2026-08-02:

{
    "recordType": "product",
    "offerId": "927875250705",
    "url": "https://detail.1688.com/offer/927875250705.html",
    "title": "新款苹果18promax手机壳磁吸16防摔磨砂iphone17pm跨境保护壳批发",
    "titleEn": "New Apple 18 Pro Max phone case, magnetic, 16 shockproof matte iPhone 17 PM cross-border protective case wholesale",
    "descriptionUrl": "https://itemcdn.tmall.com/1688offer/icoss2449019772014ef5539443422d",
    "descriptionHtml": null,
    "currency": "CNY",
    "priceMin": 7.49,
    "priceMax": 7.99,
    "priceText": "7.49-7.99",
    "priceTiers": [
        {
            "minQuantity": 30,
            "price": 7.99
        },
        {
            "minQuantity": 500,
            "price": 7.79
        },
        {
            "minQuantity": 3000,
            "price": 7.49
        }
    ],
    "minimumOrderQuantity": 30,
    "unit": "个",
    "companyName": "佛山市南海区三丰手机配件有限公司",
    "sellerLoginId": "fssf06",
    "supplierUrl": "https://winport.m.1688.com/page/index.html?memberId=b2b-2850655109d72ea",
    "location": "广东省佛山市",
    "province": "广东省",
    "city": "佛山市",
    "merchantSigns": {
        "powerfulMerchant": true,
        "trustPass": true,
        "factory": true,
        "industrySeller": false
    },
    "merchantTags": [
        "1688严选",
        "镇店之宝",
        "实力商家",
        "诚信通",
        "工厂"
    ],
    "serviceScore": 4,
    "goodRate": 99.9,
    "reviewCount": 7785,
    "repurchaseRate": 67.79,
    "images": [
        "https://cbu01.alicdn.com/img/ibank/O1CN01zrqVrk1nbye1GPiPy_!!2850655109-0-cib.jpg"
    ],
    "videoUrl": "https://cloud.video.taobao.com/play/u/2850655109/p/2/e/6/t/1/538822573635.mp4",
    "soldCount": 258375,
    "skuVariants": [],
    "skuMatrix": [],
    "attributes": {
        "材质": "优质TPU",
        "工艺": "注塑",
        "款式": "后盖款",
        "品牌": "Apple/苹果",
        "功能": "防磨"
    },
    "source": "1688",
    "scrapedAt": "2026-08-02T20:12:44.019Z"
}

Read the ladder as: 30 pieces is the minimum order at ¥7.99 each, the price steps to ¥7.79 at 500 pieces, and to ¥7.49 at 3,000. A scraper that reports only "¥7.49" is quoting you a price you cannot buy at until you order 3,000 units.

Field by field

Field	Type	What it is
recordType	string	Always product. Lets you mix this dataset with other Actors' rows.
offerId	string	1688 offer identifier. Stable, and the key to use for deduplication.
url	string	Canonical detail.1688.com offer URL.
title	string	Product title as published on 1688, in Chinese.
titleEn	string	English title from 1688 when present, otherwise a machine translation.
descriptionUrl	string	URL of the full description document referenced by the offer page.
descriptionHtml	string	Full description HTML. Populated only when includeDescriptionHtml is enabled.
currency	string	Always CNY. 1688 prices are RMB.
priceMin / priceMax	number	Cheapest and dearest step of this offer's own quantity ladder. Taken from priceTiers, so they are always prices you can actually order at.
priceTiers	array	The MOQ ladder: { minQuantity, price } ordered by quantity. The most important field in the row.
priceText	string	Price range as 1688 displays it for the current SKU set, for example 7.49-7.99.
minimumOrderQuantity	number	MOQ in units.
unit	string	Sale unit as 1688 states it (个, 件, 套, ...).
companyName	string	Supplier company name.
sellerLoginId	string	Supplier member/login ID, useful as a supplier key.
supplierUrl	string	Public winport shop URL. Feed it back in as supplierUrls to pull that supplier's catalog.
location	string	Raw location string from the offer page.
province / city	string	Location split into administrative parts, for grouping and freight consolidation.
merchantSigns	object	powerfulMerchant, trustPass, factory, industrySeller booleans parsed from the offer page.
merchantTags	array	Visible badges such as 1688严选 or 深度验厂.
images	array	Full-resolution cbu01.alicdn.com image URLs, up to 30 per offer.
videoUrl	string	Product video URL when the offer has one.
soldCount	number	Transactions recorded on the offer. The main buying signal.
repurchaseRate	number	Percentage of buyers who ordered from this supplier again within three months.
serviceScore	number	Supplier service score out of 5, as published on the offer page.
goodRate	number	Positive review rate, in percent.
reviewCount	number	Number of buyer reviews on the offer.
attributes	object	Buyer-facing attribute name/value pairs (材质, 工艺, 适用型号, ...).
skuVariants	array	Normalized variants: skuId, specAttrs, price, saleCount, stock, imageUrl. Requires includeSkuDetails.
skuMatrix	array	Raw variant fragments as 1688 published them. Requires includeSkuDetails.
source	string	Always 1688.
scrapedAt	string	ISO timestamp of extraction.

Fields that a given listing does not publish come back as null or an empty array. The Actor does not invent values.

Run summary

Every run also writes an OUTPUT record to the key-value store:

{
    "requested": 20,
    "candidates": 22,
    "products": 20,
    "filteredOut": 0,
    "errors": 0,
    "successRate": 1,
    "stoppedEarly": false,
    "filters": { "priceMax": 20, "merchantType": "any", "sortBy": "bestSelling" },
    "failedOffers": [],
    "failedDiscovery": []
}

filteredOut counts products that were fetched and then dropped by your filters. Those rows are not charged. failedOffers lists every offer that could not be extracted, with an error code (SECURITY_CHALLENGE, PRODUCT_NOT_FOUND, FETCH_FAILED, INVALID_OFFER_URL_OR_ID) so a failed pull is diagnosable instead of mysterious. stoppedEarly is true when the run stopped short of maxProducts because it was approaching its own run timeout - raise the run timeout, or lower maxProducts, and the rest will come back.

💵 How much does it cost to scrape 1688?

You pay per successfully returned product. Platform usage, including the CN residential proxy traffic that 1688 requires, is included in that price. There is no Actor start fee.

Apify plan	Per product	Per 1,000 products
Free	$0.003	$3.00
Bronze	$0.0025	$2.50
Silver	$0.002	$2.00
Gold and above	$0.0015	$1.50

Worked example: a 10-product lookup

You want the price ladder for ten candidate offers.

	This Actor	A competitor at $0.00499 + $0.0049 start
Start fee	$0.00	$0.0049
10 products	$0.03	$0.0499
Total	$0.03	$0.0548

The start fee is 9% of that competitor's bill on a 10-product run and it is charged before a single row is returned. On a one-product spot check the gap is starker: $0.003 here against $0.0099 there, most of which is the fee for pressing Start. Small, frequent lookups are exactly what sourcing work consists of, so a start fee is the wrong shape of charge for this niche.

At 1,000 products the comparison is $3.00 against $53.89, and on a Gold plan it is $1.50 against the same $53.89, because that competitor's discount curve bottoms out at 80% of its Free price.

What a run costs you in practice

• Products that fail your priceMax, minOrderQuantity, merchantType, or region filter are not billed: the filter runs before the row is pushed.
• Offers that hit verification or turn out to be unavailable are not billed: they go to OUTPUT.failedOffers.
• Search pages, supplier pages, and pagination are not billed: only returned products are.
• maxProducts is a hard cap, so the maximum bill for a run is maxProducts × your tier price.

🔁 Run it on the Apify platform

Schedule recurring sourcing checks, call the Actor over REST from JavaScript, Python, or curl, and push results to Google Sheets, a database, or a webhook. Datasets export as JSON, CSV, Excel, XML, or RSS, and integrations with Make, Zapier, Airbyte, and n8n are available from the Actor's Integrations tab.

curl -X POST "https://api.apify.com/v2/acts/webdata_labs~1688-scraper/runs?token=YOUR_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"searchQueries":["无线充电器"],"sortBy":"bestSelling","priceMax":50,"maxProducts":20}'

Use with AI agents via MCP

Add Apify's MCP server to Claude Code, Claude Desktop, or Cursor, then ask the agent to run webdata_labs/1688-scraper with a keyword, an offer ID, or a shop URL and to analyze the returned dataset. A sourcing agent can chain it: search in Chinese, filter by MOQ and price, translate the titles, then compare the ladder against retail prices from a marketplace Actor. Keep your Apify token in the client's secret or environment-variable settings rather than in a prompt.

Use this Actor in n8n

Use an HTTP Request node against the run endpoint above, wait for the run to finish (or use the run-sync-get-dataset-items endpoint), then map the dataset items into your workflow. Store the Apify token in n8n credentials, never inside the workflow JSON. A typical n8n flow: schedule trigger, run the Actor over a tracked offerIds list, compare priceTiers against last week's values in a database node, and send a message when a supplier changes a quantity break.

⚠️ Limits and caveats

• Search recall is capped by 1688's anonymous mobile search. It returns 20 cards per page and recycles a large share of them across pages, so a single keyword typically yields 20-55 unique offers rather than hundreds. For large pulls, use several keywords, or supplier shops, or a list of offer IDs. maxProducts allows up to 500 but a single short keyword will not reach it.
• 1688 sometimes serves browser verification. The Actor retries a challenged offer page, then falls back to a real browser. Offers that still fail are reported in OUTPUT.failedOffers and are not billed.
• sortBy ranks candidates, it does not query a sorted index. 1688's anonymous search echoes a sort parameter back without reordering results, so the Actor collects the candidate set and ranks it itself using the price and transaction count on each search card. On a small candidate pool this is a ranking of what search returned, not of the whole category.
• Supplier catalog discovery is blocked by 1688 as of 2026-08-03. Every public entry to a supplier's catalog - winport.m.1688.com/page/offerlist.html, /page/index.html, m.1688.com/winport/<memberId>.html, and the classic shop*.1688.com/page/offerlist.htm - currently answers with 1688's verification interstitial, for plain requests and for a real browser alike. Runs that pass supplierUrls get a SECURITY_CHALLENGE diagnostic in OUTPUT and no billed rows. Keyword search and offer URL/ID modes are unaffected. This is a change on 1688's side, not a configuration you can adjust; the Actor retries such pages in a browser automatically, so it will pick the mode back up when 1688 relaxes it.
• Supplier trading history is not on the offer page. 1688 publishes years active, transaction grade, and response rate on the supplier's own pages, not on the offer, so this Actor does not return them. What the offer page does publish - repurchaseRate, serviceScore, goodRate, reviewCount, merchantSigns - is returned instead. Missing values are null, never guessed.
• titleEn is machine translation when 1688 does not supply an English title. It is good enough for a shortlist and for search, not for customer-facing copy without review.
• Price ladders reflect the page, including SKU ranges. Some offers publish a per-SKU price range rather than a quantity ladder; there the tiers can share a minimum quantity and priceMin/priceMax carry the range. Struck-through list prices and prices belonging to 1688's recommendation modules are excluded.
• Desktop shop pages are not supported. shop*.1688.com redirects anonymous traffic to login. Use the winport.m.1688.com URL returned in supplierUrl.
• Supplier catalogs load in batches of eight products. The Actor follows the same cookie-bound asyncView pagination as the mobile infinite scroll, retries transient page/proxy failures, and stops when a page is empty, repeats existing offer IDs, or has enough candidates. It keeps a small reserve and backfills listings rejected by filters or exhausted retries, so one bad listing does not unnecessarily leave the dataset below maxProducts.
• Only public data. The Actor does not access private account data, order history, or messages, and does not bypass access controls.

🧩 Related Actors

Build a product-sourcing pipeline:

• Weibo Search & Comments Scraper - validate product and brand conversations in public Chinese social posts and comments.
• Xiaohongshu & Douyin Product Trend Radar - discover China social-commerce topics before researching wholesale supply.
• Google Shopping Scraper - check retail prices for the product you are about to source, so you can size the margin before contacting a supplier.
• eBay Listings Scraper - measure how crowded the resale side already is.
• Shopify Store Enricher - enrich the retailers already selling the product you found.
• AI Product Taxonomy Mapper API - map the scraped titles into your own category tree.
• FeedFix API - clean the resulting product feed before it hits a marketplace.

❓ FAQ

Do I need a 1688 account or a session cookie?

No. Public offer pages, mobile search, and winport supplier pages are readable anonymously, and there is no credential field on the input form. An advanced, hidden sessionCookie field exists for API callers who need a logged-in session for a restricted listing; it is optional, secret, and never written to logs or datasets.

Do I have to configure a proxy?

No, and you cannot. 1688 serves an empty page to traffic from outside China, so the Actor always uses CN residential sessions and the cost is included in the per-product price. This removes the most common cause of failed runs on 1688 scrapers.

Am I charged for products my filters removed?

No. priceMin, priceMax, minOrderQuantity, merchantType, province, and city are applied before a row is pushed to the dataset, and billing is per pushed row. OUTPUT.filteredOut tells you how many were dropped.

Am I charged when an offer fails?

No. Failed offers are reported in OUTPUT.failedOffers with a reason code and are not billed. There is also no start fee, so a run that returns nothing costs nothing.

Should I search in Chinese or in English?

Both work. Chinese and English keywords surface different offer sets, and Chinese often surfaces more of them, so a thorough shortlist uses both and relies on offer-ID deduplication. Set translateTitles: true and you get Chinese-grade recall with English-readable output.

How many products can one keyword return?

Typically 20-55 unique offers, because 1688's anonymous mobile search pages recycle rows. For larger pulls, combine keywords, add supplier shops, or supply a list of offer IDs.

What does merchantType actually check?

superFactory keeps offers whose supplier is flagged as a factory or carries a factory-verification badge (深度验厂). verifiedMerchant keeps 实力商家, 诚信通, and factory-verified sellers. Both read the flags 1688 publishes on the offer page; they are trust signals, not an audit.

Can I get the SKU variant grid?

Yes. Set includeSkuDetails: true and each row gains skuVariants with variant name, price, stock, and image, plus the raw skuMatrix. It is off by default because it makes the export heavier than most sourcing spreadsheets need.

Is it legal to scrape 1688?

Scraping public product data can be lawful in many situations, but legality depends on jurisdiction, purpose, contract terms, and the data collected. This Actor collects public product and supplier information only. Do not bypass access controls, collect private account data, or use results in ways that violate applicable law or 1688's terms. Obtain legal advice for high-risk or regulated use.

Is this a 1688 API?

Effectively yes. Run it through the Apify API, synchronously or asynchronously, and read structured dataset items as JSON, CSV, or Excel. The dataset schema is stable and documented in the field table above.

🛠️ Support

Found a listing that parses wrong, or a filter that behaves unexpectedly? Open an issue on the Actor's Issues tab with the run URL, the public offer URL, the input you used, and the field you expected. Redact cookies and any private input values. Parser fixes for real 1688 pages are prioritized over feature requests.

⭐ Rate this Actor

If this saved you an afternoon of copying prices out of 1688, please leave a rating on the Reviews tab. Review count is the main trust signal buyers use on Apify Store, and reviews also decide what gets built next here. If something is broken, please open an issue first so it can be fixed - a fixed bug helps you more than a one-star rating does.

Changelog

• 2026-08-03 - priceMin and priceMax now come from the offer's own quantity ladder instead of a scan of every price on the page, so they can no longer report a struck-through list price or a neighbouring recommendation. Added serviceScore, goodRate, reviewCount, and a working repurchaseRate; removed description, yearsActive, transactionLevel, and responseRate, which 1688 does not publish on the offer page and which were always null; attributes is now populated from the offer's own 商品参数 and no longer duplicated as specifications. Merchant badges are read from the offer's badge list rather than from any matching text on the page. Supplier catalogs and keyword searches are now paged one request at a time, so a large run no longer times out inside a single page handler; runs stop cleanly before their own timeout and still write OUTPUT; filtered runs discover more candidates so the requested number of products is actually reached; discovery pages that hit 1688's verification are now retried in a browser instead of ending the run empty.
• 2026-07-31 - Added supplier-catalog pagination through 1688's mobile asyncView endpoint, including cookie-bound continuation tokens, eight-product batches, deduplication, retries for transient page/proxy failures, safe stopping on empty or repeated pages, and reserve-candidate backfilling after filtered or failed offers.
• 2026-07-29 - Removed the proxy and session-cookie controls from the input form (CN residential proxy is now always used internally), added sortBy, priceMin, priceMax, minOrderQuantity, merchantType, province, city, includeSkuDetails, and includeDescriptionHtml, added keywords/queries/maxResults input aliases, added province, city, merchantSigns, merchantTags, and skuVariants output fields, switched offer fetching to a proxied HTTP path with a browser fallback, and added search pagination plus MOQ price ladder, supplier, and SKU dataset views.
• 2026-07-27 - Added search and supplier entry modes, MOQ price ladders, English titles, sourcing fields, partial-success reliability handling, and product-scraped billing support.
• 2026-07-23 - Fixed ID-only inputs, retries, deduplication, and transparent failure diagnostics.