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, trade-service scores, SKU attributes and image galleries — by keyword or from any offer URL or offer ID. No login, no cookies, no browser. Clean JSON or CSV out.

Why use this 1688 Wholesale Scraper?

• Search by keyword — hand it 手机壳 or 蓝牙音箱 and get up to 2,000 offers per keyword, each with tier pricing, MOQ, supplier, location and trade-service scores read straight off the search card.
• Or paste any 1688 link or ID — desktop detail.1688.com pages, mobile m.1688.com pages and bare numeric offer IDs, in any mix, normalized for you.
• Sourcing-grade data — the full tier-pricing ladder (buy N+ → price each), MOQ, unit, supplier company, storefront, location, repurchase rate and factory inspection status, not just a single price.
• Sort the way you source — by 1688's default relevance, by most orders, or by unit price low-to-high or high-to-low.
• Built for scale — residential-proxy rotation, a fresh session per block of requests, 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.
• 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 1688 keyword searches, offer links and IDs 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). Keyword search reads the same JSON listing API that 1688's own search results page loads its offers from, and offer pages are read off the window.__INIT_DATA blob 1688 embeds in its mobile pages. Everything comes back 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.

Three filter inputs run inside the scraper instead:

Filter	Read from	Effect
priceMin / priceMax	unit price on the card	Offer is dropped before it is pushed
locations	supplier location	Same — matches province or city as a substring
maxMoq	MOQ from the card's quantity ladder	Same, before the offer is pushed

Two details worth knowing. An offer with no price on it is kept, not dropped, because silently discarding it would shrink a filtered run in a way you cannot account for. And on a keyword search, five pages in a row matching none of your filters stop that query and say so, rather than paging through the whole catalogue burning requests for nothing.

When you give a single province or city in locations, 1688 narrows the search itself, so a page is not even spent fetching offers the filter would drop. priceMin / priceMax are also handed to 1688, then re-checked on our side, because 1688 applies a price band loosely.

Supported inputs

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

Chinese keywords return more and better matches than English ones, since 1688 is a domestic Chinese marketplace. A pasted search URL has its keyword read out first, including the GBK-encoded keywords that s.1688.com links carry, and its page number is kept, so the run picks up where you were looking.

Use cases

• Wholesale sourcing — search a keyword and compare tier pricing and MOQ side by side across hundreds of offers.
• 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, locations and trade-service scores for outreach.
• Catalog building — pull titles, attributes, images and prices for thousands of offers.
• Price monitoring — re-run the same keywords or offer IDs on a schedule and watch tier pricing and MOQ move.

How it works

1. You provide keywords, 1688 offer URLs, or bare offer IDs — in any mix.
2. Keywords are searched through 1688's own listing API (the one its results page calls), 100 offers a page, up to 2,000 per keyword. Each card already carries tier pricing, MOQ, supplier, location and trade-service scores.
3. Offer URLs and IDs are normalized to the canonical mobile offer URL and fetched on a fresh residential session; the window.__INIT_DATA blob 1688 embeds in the page is read for tier pricing, MOQ, supplier, SKU attributes and the image gallery.
4. Your filters drop the offers you excluded, before anything reaches the dataset.
5. Every offer that survives is written as one clean row, up to your Max items limit.

Input configuration

Field	Type	Description
searchQueries	array	Keywords to search on 1688. Each is searched separately; results carry a sourceQuery field.
startUrls	array	Offer / detail URLs, search URLs, or bare offer IDs — an alternative or addition to keywords.
sortBy	string	Order of a keyword search: default, sales (most orders), priceAsc, priceDesc. Ignored for offer URLs.
scrapeDetails	boolean	Also fetch each search offer's detail page for product attributes, the full image gallery and delivery terms. Offer URLs/IDs already come from the detail page. Default false.
priceMin / priceMax	integer	Unit-price band in CNY. Excluded offers are never pushed, so you are not billed for them.
maxMoq	integer	Keep offers with MOQ at or below this. Read from the search card, so it needs nothing switched on.
locations	array	Supplier province/city substrings to keep, e.g. ["广东", "浙江"]. A single value also narrows the search on 1688.
maxItems	integer	Hard cap on offers returned across all keywords and URLs. Default 100.
proxy	object	Proxy config. Residential is the default and required; 1688 blocks datacenter IPs.

Output overview

Each offer is one dataset row. A keyword-search row carries everything on the card — tier-pricing ladder, MOQ, unit, supplier company and storefront, location, repurchase rate, trade-service scores and whether the placement was an ad. An offer URL or ID row is read off that offer's own detail page, which adds the full SKU attribute map, the complete image gallery and delivery terms. Turn on Scrape offer detail pages to add those detail-page fields to search results too.

Output samples

A keyword-search row, from a search for 手机壳:

{
  "offerId": "1055568943029",
  "title": "跨境新款DIY实木木纹墨水屏手机壳NFC投屏高清适用于苹果13-17",
  "offerUrl": "https://m.1688.com/offer/1055568943029.html",
  "image": "https://cbu01.alicdn.com/img/ibank/O1CN01kYNu0V2E44xNplV5D_!!3972768690-0-cib.jpg",
  "price": "¥175",
  "priceValue": 175,
  "currency": "CNY",
  "tierPricing": [{ "minQuantity": 5, "unitPrice": 175 }],
  "moq": 5,
  "unit": "个",
  "soldCount": "已售40+件",
  "bookedCount": 1,
  "repurchaseRate": "68%",
  "supplierName": "深圳市龙岗区毅晨工艺品商行",
  "supplierId": "b2b-39727686906d310",
  "supplierLoginId": "毅晨工艺品商行",
  "supplierYears": "9",
  "location": "广东深圳市",
  "province": "广东",
  "city": "深圳市",
  "bizType": "生产加工",
  "serviceScores": { "composite": 4.5, "goods": 3, "logistics": 4.14, "consultation": 4, "dispute": 5, "returns": 4.33 },
  "serviceTags": ["退货包运费", "先采后付"],
  "isAd": false,
  "sourceQuery": "手机壳",
  "scrapedAt": "2026-09-15T11:12:00.000Z"
}

An offer-URL row, from https://detail.1688.com/offer/629791812713.html. attributes and images are cut short here; the run returns 20 attributes and 15 images.

{
  "offerId": "629791812713",
  "title": "适用苹果17promax液态硅胶手机壳魔方直边16全包边IP 17AIR保护套",
  "offerUrl": "https://m.1688.com/offer/629791812713.html",
  "price": "¥2.00 ~ ¥3.50",
  "priceValue": 2,
  "currency": "CNY",
  "tierPricing": [
    { "minQuantity": 2, "unitPrice": 3.5 },
    { "minQuantity": 1000, "unitPrice": 3 },
    { "minQuantity": 55555, "unitPrice": 2 }
  ],
  "moq": 2,
  "unit": "pcs",
  "supplierName": "深圳市龙岗区维特欣通讯电子工厂店(个体工商户)",
  "supplierUrl": "https://winport.m.1688.com/page/index.html?memberId=b2b-336466488825790",
  "location": "广东深圳",
  "categoryId": "1042207",
  "attributes": { "材质": "硅胶", "工艺": "植绒", "款式": "后盖式", "适用机型": "苹果" },
  "images": ["https://cbu01.alicdn.com/img/ibank/O1CN016ZIDPw1lykjFCKyeK_!!3364664888-0-cib.jpg"],
  "delivery": "承诺48小时发货·常发圆通快递",
  "sourceQuery": null,
  "scrapedAt": "2026-09-13T11:30:46.266Z"
}

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 }[]
moq	Minimum order quantity
unit	Pricing unit, e.g. 个, pcs
soldCount	Units sold, e.g. 已售40+件
bookedCount	Orders booked (search card)
repurchaseRate	Shop repurchase rate 回头率 (search card)
supplierName / supplierUrl	Supplier company + storefront
supplierYears	Years of 1688 TrustPass membership (search card)
location / province / city	Supplier location
bizType	生产加工 (manufacturer) or 经销批发 (trader) (search card)
serviceScores	Trade-service scores out of 5 (search card)
serviceTags	Service pills: 退货包运费, 先采后付, 一件代发, … (search card)
isAd	Paid placement rather than an organic result (search card)
attributes	SKU attribute map (material, style, model, …) (detail page)
images	Full image gallery (detail page)

FAQ

Can I search by keyword? Yes. Put keywords in Search queries — each is searched separately over 1688's own listing API, no login, and every result carries a sourceQuery field telling you which keyword produced it. Chinese keywords (手机壳 rather than "phone case") return the most.

How many offers per keyword? Up to 2,000 — 1688's own cap on a search — at 100 per page. Your maxItems sets the ceiling across all keywords and URLs.

Do I need cookies or a login? No. Neither keyword search nor offer pages need an account, and the scraper never sends cookies or credentials.

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

Why are attributes and images empty on some rows? Those two live on the detail page. They are filled on every offer-URL / offer-ID row, and on keyword-search rows only when Scrape offer detail pages is on. Tier pricing, MOQ, supplier and location come back on every row either way.

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.

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. Hand your agent a keyword, an offer URL or an offer ID and get structured wholesale-sourcing data back — search results and detail rows share the same schema, so an agent can go from a keyword to a shortlist to full offer detail in one tool.

⚠️ 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, 1688 keyword search, 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.