E-commerce
1688 Scraper
1688.com
1688.com is Alibaba Group's wholesale marketplace for the Chinese market, where factories and wholesalers sell in yuan and by quantity. It is served through two dedicated plugin endpoints rather than the generic page fetch. Give the search endpoint a keyword, in Chinese for the most offers or in English, and it returns the offers already parsed: offer id, title, URL and images, the price in yuan with the quantity price ladder, units sold, the repurchase rate, service and promotion tags, a sponsored flag and the supplier: company name, shop URL, years on 1688, province and city, factory and business inspection, the super factory flag and trade-service scores. Sort by relevance, sales over the last 30 days or price, filter by a yuan price range or a supplier province, and collect up to 300 offers per call at 60 per page, continuing from nextPage. The offer endpoint takes an offer id or link and returns one offer in full: the quantity price ladder or per-SKU prices with the prices before any promotion, the minimum order and unit, stock, units sold, the SKU matrix with option names, values and images and every SKU with its price and stock, attributes, images and video, where it ships from and the dispatch promise, service guarantees, the buyer rating summary and the supplier. Text comes back in Chinese, as 1688 publishes it. No 1688 account, login or API key is involved.
What you can extract
- Offer id, title, URL, images and video
- Price in yuan (CNY) with the quantity price ladder (price per quantity range)
- Units sold, repurchase rate, service and promotion tags and a sponsored flag
- Supplier: company name, shop URL, years on 1688, province and city, factory and business inspection, super factory flag and trade-service scores
- Search by keyword in Chinese or English, sorted by relevance, sales or price, filtered by a yuan price range or a supplier province; up to 300 offers per call
- Offer detail: per-SKU prices, prices before a promotion, minimum order (MOQ) and unit, stock and units sold
- Offer detail: the SKU matrix with option names, values and images, every SKU with its price and stock, and attributes
- Offer detail: ship-from location, dispatch promise, service guarantees, buyer rating summary and supplier service scores
Dedicated endpoints
/marketplace/1688-search A wholesale search on 1688.com
1688 offers for a keyword (q, in Chinese or English): a products array with offerId, title, url, image, images, price, currency (CNY), priceTiers (quantityText, minQuantity, maxQuantity, price), soldText, sold, repurchaseRatePercent, serviceTags, promotionTags, tags, brand, sponsored and supplier (name, loginId, memberId, shopUrl, yearsOnPlatform, province, city, factoryInspected, businessInspected, superFactory, tradeScores), plus totalResults, pagesFetched, lastPageFetched, droppedFromLastPage, hasMore and nextPage. sort is relevance, sales, price_asc or price_desc; price_min and price_max (yuan) and province filter the results; max_results 1-300 at 60 per page, and page (1-34) sets where to start.
/marketplace/1688-product One 1688.com offer in full
One offer by offer_id or url: title, status, brand, category, priceText with priceMin and priceMax in yuan, pricing (tiers or sku), priceTiers, originalPriceTiers, unit, moq, available, sold, soldText and soldPeriod, variantOptions (option names and values with images), variants (skuId, options, price, available), attributes, images, video, descriptionUrl, shipping (from, dispatch, unitWeightKg, freeShipping), services, labels, rating (goodRatePercent, score, reviewCount, reviewsWithPhotos, tags), favorites and supplier (name, loginId, memberId, userId, shopUrl, serviceScore, repeatPurchaseRate3m, factory, tpMember, location). A removed or unknown offer answers 404.
How to scrape it
curl -X POST \
-H "X-ScrapeUnblocker-Key: $SU_API_KEY" \
"https://api.scrapeunblocker.com/marketplace/1688-search?q=%E6%89%8B%E6%9C%BA%E5%A3%B3"import requests
resp = requests.post(
"https://api.scrapeunblocker.com/marketplace/1688-search",
headers={"X-ScrapeUnblocker-Key": SU_API_KEY},
params={"q": "手机壳"},
)
print(resp.text)import { ScrapeUnblockerClient } from 'scrapeunblocker';
const su = new ScrapeUnblockerClient({ apiKey: process.env.SU_API_KEY });
const results = await su.alibaba1688Search('手机壳', {
sort: 'sales',
maxResults: 120,
});
const offer = await su.alibaba1688Product('735353578254');
console.log(results);
console.log(offer);Requests are POST and take their parameters in the query string. Browser rendering always happens - there is no flag to enable.
Example response
{
"query": "手机壳",
"filters": { "sort": "relevance", "price_min": null, "price_max": null, "province": null },
"page": 1,
"products": [
{
"offerId": "1042303890832",
"title": "适用iPhone17promax渐变磁吸手机壳磨砂苹果16高级感15防摔保护套",
"url": "https://detail.1688.com/offer/1042303890832.html",
"image": "https://cbu01.alicdn.com/img/ibank/O1CN01yp9iTc1gezw62LhMZ_!!2212690464168-0-cib.jpg",
"images": [ "https://cbu01.alicdn.com/img/ibank/O1CN01yp9iTc1gezw62LhMZ_!!2212690464168-0-cib.jpg" ],
"price": 14.5,
"currency": "CNY",
"priceTiers": [
{ "quantityText": "1~199个", "minQuantity": 1, "maxQuantity": 199, "price": 14.5 },
{ "quantityText": "200~7999个", "minQuantity": 200, "maxQuantity": 7999, "price": 14.0 },
{ "quantityText": "≥8000个", "minQuantity": 8000, "maxQuantity": null, "price": 13.0 }
],
"soldText": "已售100+件",
"sold": 100,
"repurchaseRatePercent": 55.0,
"serviceTags": [ "深度验商" ],
"promotionTags": [],
"tags": [ "退货包运费", "先采后付", "回头率55%" ],
"brand": null,
"sponsored": false,
"supplier": {
"name": "深圳市罗湖区洪星电子商行",
"loginId": "深圳洪星生产",
"memberId": "b2b-22126904641686ef2e",
"shopUrl": "https://shop306x909028029.1688.com",
"yearsOnPlatform": 5,
"province": "广东",
"city": "深圳市",
"factoryInspected": false,
"businessInspected": true,
"superFactory": false,
"tradeScores": {
"composite": 4.0,
"consultation": 1.5,
"logistics": 4.0,
"disputes": 4.0,
"returns": 4.0,
"goods": 3.0
}
}
},
{
"offerId": "735353578254",
"title": "适用iphone18PRO大视窗磁吸手机壳15磨砂漏标苹果11秒变17保护套",
"url": "https://detail.1688.com/offer/735353578254.html",
"image": "https://cbu01.alicdn.com/img/ibank/O1CN01lAdPke1OFCTM0qUJK_!!3872131675-0-cib.jpg",
"images": [ "https://cbu01.alicdn.com/img/ibank/O1CN01lAdPke1OFCTM0qUJK_!!3872131675-0-cib.jpg" ],
"price": 9.0,
"currency": "CNY",
"priceTiers": [
{ "quantityText": "2~499个", "minQuantity": 2, "maxQuantity": 499, "price": 9.0 },
{ "quantityText": "500~4999个", "minQuantity": 500, "maxQuantity": 4999, "price": 8.5 },
{ "quantityText": "≥5000个", "minQuantity": 5000, "maxQuantity": null, "price": 7.5 }
],
"soldText": "已售1.7万+件",
"sold": 17000,
"repurchaseRatePercent": 57.0,
"serviceTags": [ "深度验商" ],
"promotionTags": [],
"tags": [ "退货包运费", "先采后付", "回头率57%" ],
"brand": null,
"sponsored": false,
"supplier": {
"name": "深圳市亿佳合兴科技有限公司",
"loginId": "深圳亿佳合兴科技有限公司",
"memberId": "b2b-38721316754ec7c",
"shopUrl": "https://shop764420m281617.1688.com",
"yearsOnPlatform": 9,
"province": "广东",
"city": "深圳市",
"factoryInspected": false,
"businessInspected": true,
"superFactory": false,
"tradeScores": {
"composite": 4.0,
"consultation": 3.5,
"logistics": 3.14,
"disputes": 4.0,
"returns": 4.0,
"goods": 3.67
}
}
}
],
"resultsCollected": 60,
"totalResults": 2000,
"currency": "CNY",
"pagesFetched": 1,
"lastPageFetched": 1,
"droppedFromLastPage": 0,
"hasMore": true,
"nextPage": 2
}Frequently asked questions
Is it legal to scrape 1688?
Collecting publicly available 1688.com data such as offer titles, wholesale prices, minimum orders and supplier details is lawful in many jurisdictions, but the rules depend on your country, the data you collect and how you use it. ScrapeUnblocker returns the public listings; what you collect and how you use it is your responsibility.
How do I scrape 1688 without getting blocked?
1688 answers an address it does not trust with its slider page, or with a validation error from its search service, and both come back as a normal 200, so a plain scraper stores the slider as if it were data. The search endpoint calls the same JSON search service the 1688 search page uses, a signed two-request exchange held on one session, from ISP exits; when 1688 answers with the slider, it moves to a fresh exit a bounded number of times and then answers 502 rather than returning the slider. The offer endpoint reads the server-rendered offer page through the browser-free legs of the chain behind /getPageSource. No browser is involved. In ScrapeUnblocker's benchmark it returned data on 90.1% of 1,200 calls (750 searches with a different query each and 450 offers), about 2.9s per call; most misses were searches made while 1688 was refusing search for a while after a long run of them.
What 1688 data can I get?
The search endpoint returns, for each offer, its id, title, URL and images, the price in yuan with the quantity price ladder, units sold, the repurchase rate, service and promotion tags, a sponsored flag and the supplier: company name, login id, shop URL, years on 1688, province and city, factory and business inspection, the super factory flag and trade-service scores for consultation, logistics, disputes, returns and goods. The offer endpoint adds the full listing: per-SKU prices or the quantity ladder, prices before a promotion, the minimum order and unit, stock, units sold, the SKU matrix with every SKU's price and stock, attributes, images and video, ship-from and dispatch promise, service guarantees, the buyer rating summary and the supplier's service score and repeat purchase rate.
How many 1688 offers can I get per search?
1688 serves 60 offers per results page and reports at most 2,000 results for a query, which is 34 pages. One call collects up to 300 offers (max_results 1-300, five pages); to go further, call again with page set to the nextPage of the previous response. nextPage is always the next page none of whose offers were returned, so when max_results ends inside a page the rest of that page is skipped (droppedFromLastPage counts it); ask in multiples of 60 to get every offer. Sort by relevance, sales (most sold in the last 30 days first), price_asc or price_desc, and filter with price_min and price_max in yuan, or with province, a Chinese province name such as 广东 (Guangdong) or 浙江 (Zhejiang).
What language and currency is 1688 data in?
1688 is a Chinese-language marketplace: titles, attributes, tags and supplier names come back in Chinese as 1688 publishes them, so translate them on your side if you need English. Prices are in yuan (CNY), and priceTiers lists the wholesale steps, for example 2-499 pieces at one price and 500-4,999 at a lower one; moq with its unit is the smallest order the supplier accepts. Keywords work in Chinese and in English, but Chinese keywords match the most offers.
How much does it cost to scrape 1688?
A search is billed one request per results page served: up to 60 offers is 1 request, 300 offers up to 5, and pagesFetched shows the exact number. An offer is one request. 1 request = 1 credit, EUR 1.00 per 1,000 on pay as you go, down to about EUR 0.55 per 1,000 on the Ultimate plan. Blocks and timeouts are not billed, and the free trial includes 500 requests with no card.
Related scrapers
1688 and other names and marks of 1688.com belong to their owner and are used here only to identify the website this API works with. ScrapeUnblocker is an independent service, not affiliated with, endorsed by or sponsored by the owner of 1688.com.
Start scraping this site today
Free tier included. No credit card required to test it.