1688 Wholesale Scraper

1688 Wholesale Scraper: unit prices, MOQ, the quantity ladder and the supplier behind each offer

Search 1688.com and every offer comes back as a row: offer id, Chinese title, unit price in CNY, minimum order quantity, the quantity price ladder, sales count, repeat-purchase rate, the supplier's name, province, city, years on 1688, whether they are a factory, their rating broken into five scores, and the buyer protections they offer. No account, no cookies, nothing to install.

Two things worth knowing before you run it. Search in Chinese if you can. 手机壳 matches millions of offers where "phone case" matches a few thousand, and both go through unchanged. And the quantity ladder is not on every offer. Plenty of suppliers list one flat price at their MOQ, in which case priceTiers comes back as an empty array and priceMin equals priceMax. The real row below is exactly that case.

📦 What 1688 Wholesale Scraper does

Give it search terms, or paste 1688 search pages and the keyword is read out of each link. Both inputs work in the same run, and the same offer found under two terms is returned once and billed once.

The price ladder is the part most people come for. Where a supplier prices by volume, priceTiers carries each band as {minQuantity, maxQuantity, quantityLabel, price}, so you can see what 500 units costs against 50 without opening anything.

Everything about the supplier rides on the offer row: their winport link, supplierYears on 1688, isFactory worked out from the business type 1688 publishes, and ratingBreakdown split into goods, logistics, consultation, dispute and after-sales rather than one number.

1688 mixes promoted offers into its results. They are not removed, they are labelled: isAd is true on them, so you can drop or keep them as you like.

📥 What you give it

{
  "searchTerms": ["手机壳", "phone case"],
  "maxItems": 40,
  "sortBy": "priceAsc",
  "minPrice": "5",
  "maxPrice": "20"
}

There is no best-selling sort. 1688 offers one, but it returns a sales count of zero on every row, so it was left out rather than shipped broken.

📤 What you get back

A real row from a recent run:

{
  "offerId": "1050877556974",
  "productId": "1050877556974",
  "title": "新品适用苹果18Duo磁吸手机壳肤感iphone duo折叠防摔保护套批发",
  "productUrl": "https://detail.1688.com/offer/1050877556974.html",
  "price": 11.49,
  "priceMin": 11.49,
  "priceMax": 11.49,
  "currency": "CNY",
  "priceTiers": [],
  "minOrderQuantity": 50,
  "unit": "个",
  "salesCount": 12534,
  "repeatPurchaseRate": "37%",
  "rating": 5,
  "ratingBreakdown": {
    "goods": 5, "logistics": 4.71, "consultation": 3.5, "dispute": 4, "afterSales": 4.67
  },
  "supplierName": "佛山市南海区三丰手机配件有限公司",
  "supplierUrl": "https://m.1688.com/winport/b2b-2850655109d72ea.html?__existtitle__=1",
  "supplierProvince": "广东",
  "supplierCity": "佛山市",
  "supplierYears": 11,
  "supplierId": "b2b-2850655109d72ea",
  "businessType": "生产加工",
  "isFactory": true,
  "buyerProtections": ["材质保障", "7天包换", "48小时发货"],
  "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01NC1wKd1nbye30dTY1_!!2850655109-0-cib.jpg",
  "isAd": true,
  "searchKeyword": "手机壳",
  "page": 1,
  "position": 1,
  "scrapedAt": "2026-09-20T07:01:30.586Z"
}

🧾 Reading the output

There is no charged field on these rows. Filter on offerId being present. One thing to know: the labelled sample row carries a few extra fields that real rows do not, so take a real row as the shape rather than the sample.

▶️ How to run it

1. Open 1688 Wholesale Scraper and click Try for free. 2. Put your terms into Search terms, one per line, in Chinese where you can. 3. Set Maximum products. Start at 20 to see what the rows look like. 4. Open Filters if you want a unit-price band, and set Sort results by if price order matters more than 1688's relevance ranking. 5. Click Start, then download the dataset as JSON, CSV or Excel, or read it from the Apify API.

💰 How much does it cost?

$0.35 per 1,000 products. Flat on every Apify plan, with no volume tiers.

One billed row per offer delivered. The sample row is not billed, diagnostic rows are not billed, a term that returns nothing produces no billed rows, and the same offer found under two terms is billed once.

💡 What people use it for

• Sourcing. Pull 200 offers for a product, sort by price, then read minOrderQuantity and

priceTiers to see what the real cost is at the volume you want.

• Screening suppliers before contacting any of them, using supplierYears, isFactory,

salesCount and the five-part ratingBreakdown.

• Building a landed-cost model, since priceTiers gives you the whole ladder rather than one

headline figure.

• Mapping where a product category is made, by grouping on supplierProvince and supplierCity.
• Watching a term over time and diffing on offerId to see who is new.

🚧 What it does not do

• No product-page detail. No description, no full image gallery, no specs, no stock. The offer

link is in every row if you need to open one.

• No reviews. The reviews scraper below covers those, and takes the offerId from here.
• priceTiers is often empty. Many suppliers publish one flat price at the MOQ. That is their

listing, not a gap here.

• 1,000 rows per run, and 1688 stops paginating a term well before its full inventory is

reachable. Split a broad term into narrower ones.

• No best-selling sort, because 1688's own returns zero sales on every row.
• Promoted offers are in the results. They are labelled with isAd, not removed.
• Nothing is translated. Titles, business type, buyer protections and units all stay in Chinese.
• CNY only. No currency conversion.
• A big run can come back short. 1688 rate-limits hard, and a refusal becomes an uncharged

diagnostic row rather than a gap passed off as complete. Only delivered offer rows are billed.

🧭 Which 1688 scraper do you need?

❓ Questions people ask

Do I have to search in Chinese? No, but you will get far more. English terms work and return a much smaller slice of 1688's inventory.

Why is priceTiers empty? Because that supplier publishes one price at their minimum order. priceMin and priceMax will equal price when that happens.

Why is a promoted offer in my results? Because 1688 placed it there. isAd marks it so you can filter it out.

Can I get more than 1,000 rows? Not in one run. Run again with narrower terms, or a price band, to reach different offers.

My run stopped with BLOCKED. 1688 was rate-limiting. Raise Delay between requests under Advanced and run the remaining terms again. What was already delivered stays in the dataset.

Can I schedule it? Yes. offerId is stable, so diffing runs shows new suppliers and price moves.

Is this legal? These are public wholesale listings with no account behind them. Apify's write-up on scraping and the law is a good starting point, and we are not lawyers.

🆘 If something breaks

Open the Issues tab on the actor page. Send the search term or the URL you used and the run ID. The errorCode on the diagnostic row usually names the problem on its own.