1688 Wholesale Scraper — Tier Pricing, MOQ & Supplier Data

Extract structured wholesale offers from 1688.com (Alibaba's China B2B marketplace) at scale — quantity-break tier pricing, minimum order quantity (MOQ), supplier company, location, SKU attributes and image galleries — by keyword or URL. No login, no cookies, no browser. Clean JSON or CSV out.

Why use this 1688 Wholesale Scraper?

• Search by keyword or paste any offer URL — keyword searches, desktop detail.1688.com and mobile m.1688.com offer pages, and bare numeric offer IDs are all handled.
• Sourcing-grade data — the full tier-pricing ladder (buy N+ → price each), MOQ, unit, supplier company, trading years, location and product attributes, not just a single price.
• Rich data straight from search — title, price, sold count, repurchase rate, supplier trading years and location on every row, no detail fetch required.
• Built for scale — pagination (~20 offers/page), residential-proxy rotation, and automatic retry through 1688's x5sec anti-bot.
• Filter before you pay — narrow by unit price, MOQ and supplier province or city. Excluded offers never reach your dataset, so you are not billed for them, and price and location are read straight off the search card, which also saves a detail request per skipped offer.
• One clean row per offer — you pay per result, never for padding.

Overview

1688.com is Alibaba's domestic Chinese wholesale marketplace — the source behind a huge share of what's resold on AliExpress, Amazon, eBay and independent stores. This scraper turns any 1688 search or offer URL into structured data you can use for wholesale sourcing, dropshipping product research, price and MOQ comparison, supplier discovery, and cross-border arbitrage.

It runs on a pure HTTP stack (no headless browser), reads the offer data 1688 embeds in its own mobile pages, and returns it as tidy JSON/CSV — fast and cheap. Chinese text (titles, attributes, supplier names) is preserved exactly as published.

Filtering, and what it costs you

Sourcing runs are mostly about throwing away offers: wrong price band, MOQ too high, supplier on the other side of the country. Doing that after the fact means paying for rows you delete.

Four filter inputs run inside the scraper instead:

Filter	Applied from	Effect
priceMin / priceMax	search listing	Skipped before the detail page is fetched
locations	search listing	Same — matches province or city as a substring
maxMoq	detail page	Applied after the fetch, still before the row is pushed

Two details worth knowing. An offer whose card carries no price is kept, not dropped, because silently discarding it would shrink a filtered run in a way you cannot account for. And if five pages in a row match none of your filters, the run stops that query and says so, rather than paging through the whole catalogue burning requests for nothing.

maxMoq needs Scrape offer detail pages switched on, since 1688 does not put MOQ on the search card. Asking for it without that fails the run with a message saying so, instead of returning an unfiltered dataset that looks fine.

Supported inputs

Input type	Example
Keyword search	手机壳 (phone cases), 蓝牙耳机 (bluetooth earphones), or any keyword
Offer / detail URL	https://detail.1688.com/offer/629791812713.html
Mobile offer URL	https://m.1688.com/offer/629791812713.html
Bare offer ID	629791812713
Keyword-search URL	https://s.1688.com/selloffer/offer_search.htm?keywords=手机壳

All URL formats are auto-normalized to the canonical mobile URL the scraper fetches.

Use cases

• Wholesale sourcing — find suppliers by keyword, compare tier pricing and MOQ side by side.
• Dropshipping & reselling research — trace which 1688 offers back AliExpress/Amazon listings and at what wholesale cost.
• Price & margin analysis — pull the full quantity-break ladder to model landed cost at different order sizes.
• Supplier discovery — collect supplier company names, trading years and locations for outreach.
• Catalog building — pull titles, attributes, images and prices for thousands of offers by keyword.

How it works

1. You provide keyword searches and/or 1688 offer URLs (or bare offer IDs).
2. The scraper builds canonical mobile search URLs and normalizes any pasted links/IDs to the mobile offer form.
3. It fetches each page through a residential proxy with a warmed session, and reads the offer cards (search) or the window.__INIT_DATA blob (detail) that 1688 embeds in the page.
4. Results are paginated (~20 offers per page) up to your Max items limit.
5. Optionally, each offer's detail page is fetched for tier pricing, MOQ, supplier, SKU attributes and the full image gallery.
6. Every offer is written to the dataset as one clean row.

Input configuration

Field	Type	Description
searchQueries	array	Keywords to search on 1688. Chinese keywords match best. Each is paginated up to maxItems.
startUrls	array	Direct offer / search URLs, or bare offer IDs.
scrapeDetails	boolean	Fetch each offer's detail page for tier pricing, MOQ, supplier, attributes and gallery (slower, one request per offer). Default false.
priceMin / priceMax	integer	Unit-price band in CNY. Read from the search card, so excluded offers cost no detail request.
maxMoq	integer	Keep offers with MOQ at or below this. Requires scrapeDetails.
locations	array	Supplier province/city substrings to keep, e.g. ["广东", "浙江"].
maxItems	integer	Hard cap on offers returned. Default 100.
maxConcurrency	integer	Parallel detail fetches (only when scrapeDetails is on). Default 8.
proxy	object	Proxy config. Residential is the default and the most reliable; Apify datacenter proxy also works, though 1688 blocks it more often.

Output overview

Each offer is one dataset row. Search-level runs populate the core commerce fields (title, price, sold count, repurchase rate, supplier years, location); enable scrapeDetails to add the tier-pricing ladder, MOQ, unit, supplier company/URL, SKU attributes and image gallery.

Output sample

{
  "offerId": "990321853701",
  "title": "跨境适用于三星Z FOLD6磁吸二合一肤感折叠屏手机壳Z FOLD7手机壳",
  "offerUrl": "https://m.1688.com/offer/990321853701.html",
  "image": "https://cbu01.alicdn.com/img/ibank/O1CN01CeSxdk1lOZmSVEQau_!!2208146624809-0-cib.jpg",
  "price": "¥45.00 ~ ¥50.00",
  "priceValue": 45,
  "currency": "CNY",
  "tierPricing": [
    { "minQuantity": 10, "unitPrice": 50 },
    { "minQuantity": 500, "unitPrice": 48 },
    { "minQuantity": 10000, "unitPrice": 45 }
  ],
  "moq": 10,
  "unit": "个",
  "soldCount": "100+",
  "repurchaseRate": "0%",
  "supplierName": "丰美(东莞)科技有限公司",
  "supplierUrl": "https://winport.m.1688.com/page/index.html?memberId=b2b-2208146624809e0973",
  "supplierId": "2208146624809",
  "supplierLoginId": "fmhzh2588",
  "supplierYears": "7年",
  "location": "广东东莞",
  "categoryId": "1042207",
  "attributes": { "材质": "PC", "工艺": "磨砂", "适用机型": "三星ZFold6" },
  "images": ["https://cbu01.alicdn.com/img/ibank/O1CN01CeSxdk1lOZmSVEQau_!!2208146624809-0-cib.jpg"],
  "delivery": "承诺48小时发货",
  "sourceQuery": "手机壳",
  "scrapedAt": "2026-07-22T20:14:18.574Z"
}

Key output fields

Field	Description
offerId	1688 offer ID
title	Offer title (original Chinese)
offerUrl	Canonical offer URL
price / priceValue	Price or price range (formatted) + lowest numeric unit price
currency	Currency code (CNY)
tierPricing	Quantity-break ladder: { minQuantity, unitPrice }[] (with scrapeDetails)
moq	Minimum order quantity (with scrapeDetails)
unit	Pricing unit, e.g. 个, pcs (with scrapeDetails)
soldCount	Units sold
repurchaseRate	Buyer repurchase rate (search results)
supplierName / supplierUrl	Supplier company + storefront (with scrapeDetails)
supplierYears	Years trading on 1688 (search results)
location	Supplier location
attributes	SKU attribute map (material, style, model, …) (with scrapeDetails)
images	Full image gallery (with scrapeDetails)

FAQ

Do I need cookies or a login? No. The scraper is fully no-login, no-cookies.

Are the results in Chinese? Yes — titles, attributes and supplier names are returned exactly as 1688 publishes them (Chinese). This keeps the data faithful; translate downstream if needed.

Why are tierPricing, moq and attributes empty on some rows? Those fields live on the offer detail page. Search-level runs return them empty; enable scrapeDetails (or pass offer URLs directly) to populate them.

Do I need residential proxies? Yes. 1688's x5sec anti-bot blocks datacenter IPs; the actor ships with a working residential pool by default and rotates IPs automatically on a block.

Which currency do I get? Prices are in Chinese Yuan (CNY / ¥), as shown on 1688.

How many offers per search? About 20 per page; it paginates automatically up to your maxItems.

Support

Found a bug or need a field added? Open an issue on the actor's Issues tab and it'll be looked at quickly.

Additional services

Need this data enriched, on a schedule, or pushed to your warehouse/webhook? Reach out via the Issues tab — custom fields, monitoring runs and integrations are available.

Explore more scrapers

Check the publisher profile for more e-commerce and marketplace scrapers, including AliExpress, Taobao/Tmall and other product catalogs.

🤖 For AI Agents & LLM Apps

This actor returns clean, flat JSON ideal for RAG pipelines and agent tool-calling: one offer per row, stable field names, numeric fields (priceValue, moq, and the tierPricing ladder) ready for margin modelling and filtering without post-processing. Point your agent at a keyword or an offer URL and get structured wholesale-sourcing data back.

⚠️ Disclaimer

This scraper collects only publicly available data from 1688.com. It does not log in, bypass authentication, or access private data. You are responsible for using the scraped data in compliance with 1688's terms, applicable laws (including copyright and data-protection regulations), and for any downstream use. Use responsibly.

SEO Keywords

1688 scraper, 1688 API, 1688.com scraper, 1688 wholesale scraper, Alibaba 1688 scraper, scrape 1688, 1688 product scraper, 1688 price scraper, 1688 supplier scraper, 1688 MOQ scraper, tier pricing scraper, China wholesale scraper, wholesale sourcing data, dropshipping sourcing scraper, 1688 data extraction, 1688 offer scraper, B2B marketplace scraper, 1688 crawler, 1688 JSON, 1688 CSV export, Alibaba wholesale data.