1688.com Wholesale Scraper: Products & Suppliers
Pricing
from $3.99 / 1,000 products
1688.com Wholesale Scraper: Products & Suppliers
Scrape 1688.com, China's largest wholesale marketplace, without a login. Search by keyword, link, category or photo, find cheaper look-alikes, look up suppliers and track price changes. Get tiered prices, MOQ, stock, sales, images, SKU variants, reviews and factory data. Pay only for results.
Pricing
from $3.99 / 1,000 products
Rating
0.0
(0)
Developer
TheShark
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
8 days ago
Last modified
Categories
Features
Share
1688 Scraper: Wholesale Products, Prices and Suppliers from 1688.com
Scrape product data from 1688.com (Alibaba 1688), China's largest wholesale marketplace. Search by keyword, search link, category or photo, find cheaper look-alikes of a product, look up suppliers, or give a list of product IDs, and get a full product card for each item: tiered prices, minimum order quantity (MOQ), stock, sales, images, attributes, supplier profile and shipping. Optional add-ons bring SKU variants, buyer reviews, detailed factory data and the same item from other sellers. A fast cards-only mode and change monitoring are built in.
No 1688 account, login, cookies or proxies of your own are needed. You pay only for products that were collected successfully.
What can you do with 1688 Scraper?
- Source products: find wholesale suppliers and compare factory prices for a product or a whole category.
- Find cheaper sellers: search by photo, or find look-alikes of a 1688 offer, sorted from the cheapest.
- Check suppliers: company registration, founding year, factory profile, shop ratings, certificates and customization services.
- Collect a supplier's products: give a shop link, shop ID or company name.
- Track prices: run the same input on a schedule and see which prices, stock levels and sales changed since the last run.
- Build catalogs: product images, videos, attributes, variants and descriptions for dropshipping and e-commerce work.
- Use it as a 1688 API: start runs and get results from your own code through the Apify API.
What data can you get from 1688.com?
| Data | Fields |
|---|---|
| Product | offer ID, link, title, category, attributes, package size and weight |
| Price and ordering | price range, quantity price tiers, MOQ, unit, stock, mixed wholesale, single-piece retail |
| Sales and popularity | sold count, favorites, badges, review summary (good rate, grade, buyer impression tags) |
| Media | images, main images, video, description images, description HTML (optional) |
| Variants (optional) | every SKU with its options, price, stock and sales |
| Reviews (optional) | review text, rating, date, variant, quantity, buyer city |
| Supplier | company name, shop link, seller chat link, location, service score, repeat buyer rate, supplier type, company registration, founding year, factory profile, shop metrics |
| Supplier intelligence (optional) | factory card (videos, rankings, equipment, production lines, OEM minimums, capacity, address), product certificates (CE, FCC, RoHS and more), customization services and prices, lead times, dropshipping metrics, product ranking |
| Shipping and services | ships from, shipping cost, delivery promise, services, coupons, sales channels |
| Same items (optional) | up to 8 offers of the same item from other sellers |
| Monitoring | NEW, CHANGED (with before and after values), UNCHANGED or GONE for every product |
How to scrape 1688.com
- Open the actor and fill in at least one source: keywords, product IDs, search links, a category, photos, look-alike offers or suppliers.
- Set the number of results and, if you like, filters such as price, MOQ, region or supplier type.
- Choose the extra data you need: variants, reviews, supplier intelligence, same items.
- Click Start. Products appear in the dataset while the run goes on.
- Download the results as JSON, CSV, Excel or HTML, or get them through the API.
If you start the actor with an empty input, it runs a small example search (20 products), so you can see what the data looks like.
Input
The input form has four sections: What to scrape, Search filters, Data to include and Monitoring. Every source you fill in is processed, in this order: offer IDs, then keywords, search links and category, then photos, then look-alikes, then suppliers.
What to scrape
| Field | Type | Default | What it does |
|---|---|---|---|
keywords | list of strings | empty | Search keywords, Chinese or English, for example ["手机壳", "phone case"]. Each keyword is searched separately, one after another. |
offerIds | list of strings | empty | 1688 product IDs or product links (detail.1688.com/offer/<id>.html). These products are scraped first, always from their product pages. |
searchUrls | list of strings | empty | Links to 1688 search results. The keyword and filters of the link are used and win over the filters of the form. |
categoryId | string | none | 1688 category ID of level 1 or 2 (for example 1813 for toys). Alone it is a search by itself; next to keywords or links it is a filter. |
imageUrls | list of strings | empty | Photos to search by (search by photo). Each photo is searched separately. |
similarToOfferIds | list of strings | empty | 1688 product IDs or links. For each one, the products that look the same or very close are found and scraped. |
maxSimilarityScore | number | 0.2 | Only for similarToOfferIds: products with a higher similarityScore are skipped. |
suppliers | list of strings | empty | Shop links, shop IDs (b2b-...) or exact company names. One profile row per supplier. |
maxProductsPerSupplier | integer, 0 to 1000 | 0 | How many products to scrape for each supplier. 0 means only the profile. |
maxResults | integer, 1 to 5000 | 100 | Maximum number of products per keyword, link, category, photo or look-alike offer. |
scrapeProductPages | boolean | true | false is the fast cards-only mode (see the examples). |
Search filters
| Field | Type | Default | What it does |
|---|---|---|---|
sortBy | relevance, bestSelling, priceAsc, priceDesc | relevance | Order of search results. |
priceMin, priceMax | number (CNY) | none | Only products priced at or above, or at or below, this value. |
minOrderQuantityFrom, minOrderQuantity | integer | none | Only products whose minimum order quantity (MOQ) is at least, or at most, this value. |
merchantType | any, verifiedMerchant | any | verifiedMerchant: only verified merchants (实力商家). |
province, city | string | none | Supplier province and city in Chinese characters, for example 广东, 深圳. Several provinces can be separated by commas, for example 江苏,浙江. |
dropshipping, freeShipping, dropshipFreeShipping, sevenDayReturn, fastInvoice, officialLogistics, verifiedFactory, bigBrandOem | boolean | false | Yes/no filters that 1688 applies on its side. Some pairs cannot be combined on 1688 (for example verifiedFactory and bigBrandOem): the first one is used and a warning says so. |
excludeKeywords | list of strings | empty | Skip products whose title contains any of these words. |
Data to include
| Field | Type | Default | What it does |
|---|---|---|---|
includeSkuDetails | boolean | false | Add the full variant matrix: each variant with its options, price, stock and sales. |
includeDescriptionHtml | boolean | false | Add the full product description as HTML. Description text and images are always included. |
includeReviews | integer, 0 to 100 | 0 | How many latest reviews to attach to each product. Charged per review delivered. |
includeSupplierIntelligence | boolean | false | Add a supplierIntelligence block with detailed factory, certificate, customization, dropshipping and ranking data. Charged as an extra event. |
includeSameItems | boolean | false | Add a sameItems list: up to 8 offers of the same item from other sellers. Charged as an extra event only when the list is not empty. Needs product pages. |
Monitoring
| Field | Type | Default | What it does |
|---|---|---|---|
monitorName | string | none | Turns on change monitoring (free), see below. |
Examples
Keyword search (full product cards):
{"keywords": ["保温杯", "thermos cup"],"maxResults": 50,"sortBy": "bestSelling","priceMax": 30,"includeReviews": 10}
Specific products:
{ "offerIds": ["735353578254", "https://detail.1688.com/offer/634155097789.html"] }
Search link and category (the filters of the link win over the form):
{"searchUrls": ["https://s.1688.com/selloffer/offer_search.htm?keywords=%CA%D6%BB%FA%BF%C7&priceStart=5"],"maxResults": 200}
{ "categoryId": "1813", "maxResults": 100, "sortBy": "bestSelling" }
Cards-only mode: products are taken straight from the search results, which is much faster and cheaper (event product-card). Rows have the search-card fields: title, price tiers, image, seller, sales and trade scores. Reviews, supplier intelligence and same items are not collected in this mode:
{ "keywords": ["手机壳"], "maxResults": 600, "scrapeProductPages": false }
Search by photo. Links on alicdn.com (1688 product images) are used directly; any other image is downloaded, resized and uploaded to 1688 (JPEG, PNG, GIF and WEBP work). Every row has similarityScore: smaller is closer (below 0.1 is almost the same photo):
{"imageUrls": ["https://cbu01.alicdn.com/img/ibank/O1CN01lAdPke1OFCTM0qUJK_!!3872131675-0-cib.jpg"],"maxResults": 100}
Look-alikes of a product: the main image of the offer is used to find the same or very close products from other sellers, cheapest first. The offer itself is not included.
{ "similarToOfferIds": ["735353578254"], "maxResults": 50, "maxSimilarityScore": 0.2 }
Suppliers, with their products:
{"suppliers": ["https://shop1388209852876.1688.com/", "b2b-2207252800234f4b31", "深圳市亿佳合兴科技有限公司"],"maxProductsPerSupplier": 50}
Monitoring: run the same input again later with the same monitorName:
{ "offerIds": ["735353578254", "634155097789"], "monitorName": "my-cases" }
How it works
Queries one by one. Keywords, search links, categories, photos, look-alike offers and suppliers are handled one after another: the actor searches the first one, scrapes its products, then moves on to the next. Products appear in the dataset from the start. A product found by two queries appears once, with the first query in source (and in sourceKeyword for keywords).
Filters and maxResults. Price, minimum order quantity, region and excludeKeywords are checked on the search results, and maxResults counts products that passed them. verifiedMerchant (and the exact price and MOQ) can only be checked on the product page, so with these filters a keyword can give fewer rows than maxResults. The yes/no filters (dropshipping and the others), minOrderQuantityFrom and categoryId are filters of the 1688 search itself: they do not apply to photo searches, look-alikes and supplier products found without a search card, and the run warns when you combine them. In cards-only mode verifiedMerchant is only 1688's own search filter, because product pages are not opened.
Suppliers. A supplier row (rowType is supplier) has the company name, registration, shop header and ratings, the factory card for factories, shop metrics and the IDs of the shop's hot offers. A shop link, a shop ID or an exact company name is accepted; a product link is not a supplier (put it in offerIds). With maxProductsPerSupplier above 0, the supplier's products are scraped as normal products (full card, billed as products) and carry the supplier in source. Products come from a search by the exact company name, the factory card list for factories and the shop's hot and new offers. In cards-only mode, the products from the company-name search come as cheaper search cards, while products from the factory card list and the hot and new offers are scraped from their product page and billed as product.
Monitoring. With monitorName the actor compares every product with the previous run and adds a monitor object to the row: status is NEW (not seen before), CHANGED (changes lists the price, stock, sold count, title or status that differ, with before and after), UNCHANGED, or GONE (a product from offerIds that was found last time is not found now), plus previousScrapedAt. The previous state of every product is kept in a named key-value store in your Apify account, china-1688-monitor-<name> (the name is lower-cased; use Latin letters and digits, other characters are dropped), in the record SNAPSHOT. The store is shared by all runs with the same name: use the same name to compare runs and different names for separate watch lists. Records older than 90 days are removed. A product with status BLOCKED or ERROR this time gets monitor: null, and its stored state is kept for the next run. Monitoring is free. The Changes dataset view shows the monitor column. Combine monitoring with an Apify schedule to watch prices every day or week.
Output
One dataset row per product, plus one row per supplier when you use suppliers (rowType is product or supplier). Rows can be downloaded as JSON, CSV, Excel and more. Text fields (titles, attributes, supplier names, reviews) are in the original Chinese, prices are in CNY. The dataset has four views: Products, Search cards (cards-only rows), Suppliers and Changes. A dataset view shows all rows, so in the Suppliers view look at the rows that have a company name, and in the Changes view at the monitor column.
Field groups
- Identity:
offerId,detailUrl,title,categoryId,categoryName,sourceKeyword,scrapedAt. - Price and ordering:
price(min, max, currency CNY),quantityPrices(price tiers),minOrderQuantity,unit,stock,mixWholesale,supportsOnePieceRetail. - Sales and popularity:
soldCount,soldDisplay,soldPeriod,favoriteCount,badges,shopReviewSummary(good rate, grade, buyer impression tags). - Review summary (always included, free):
reviewSummarywith the product's good rate, grade, review counts by type, buyer impression tags and fulfilment metrics. - Media:
images,mainImages,videoUrl,videoCoverUrl, description images anddescriptionUrl. - Specs:
attributes(name and value pairs),packageDetails(size and weight),unitWeightKg. - Supplier:
supplierwith company name, shop link, seller chat link, location, service score, repeat buyer rate and supplier type flags, plus company registration, founding year, supplier profile (staff, area, equipment, verification) and shop metrics when available. - Shipping and services:
shipping(ships from, cost, delivery text),services,coupons,distributionChannels,flags,compliance. - Search card data (products found by a search: keywords, links, categories, photos, look-alikes and the supplier's company-name search; not products from
offerIds):isPromoted,repurchaseRate, and extra supplier fields such astradeScoresand inspection report links. - Photo search and look-alikes:
similarityScore(smaller is closer),source(which query found the row). - Cards-only rows:
dataLeveliscard(rows with a product page havefull). - Same items (
includeSameItems):sameItems. - Monitoring (
monitorName):monitor. - Status:
status,statusMessage,warnings.
Optional add-ons:
skuDetails(includeSkuDetails): variant axes and every variant with price, stock and sales.descriptionHtml(includeDescriptionHtml): the full description HTML.reviews(includeReviews): latest reviews with text, rating, date, variant, quantity and buyer city. Buyer names, avatars and profiles are never collected, and phone numbers or WeChat/QQ contacts found in review text are removed. 1688 shows visitors without an account only part of a product's reviews (for example 45 of 102 in the review summary), soreviewscan be shorter thanincludeReviewsandreviewSummary.counts.total. If the reviews of a product could not be collected,reviewsisnull,warningssays so, and its reviews are not charged.supplierIntelligence(includeSupplierIntelligence): factory card for verified factories (videos, rankings, equipment list, production lines, OEM minimums, production capacity, factory address and coordinates), certificates of this product (for example CE, FCC, RoHS test reports), customization (services with prices, printing price list, lead times by quantity), dropshipping metrics and the product's ranking on 1688. Which parts are present depends on the supplier: many suppliers have no factory card or no certificates.
Example row (shortened)
Long lists are cut here for readability. Real rows contain full lists.
{"offerId": "735353578254","detailUrl": "https://detail.1688.com/offer/735353578254.html","status": "OK","statusMessage": "","warnings": [],"title": "适用iphone18PRO大视窗磁吸手机壳15磨砂漏标苹果11秒变17保护套","categoryName": "iPhone保护套","unit": "个","price": { "min": 9.0, "max": 9.0, "currency": "CNY", "basis": "quantity" },"quantityPrices": [{ "minQuantity": 2, "price": 9.0 },{ "minQuantity": 500, "price": 8.5 },{ "minQuantity": 5000, "price": 7.5 }],"minOrderQuantity": 2,"stock": 2692428,"mixWholesale": { "supported": true, "minQuantity": 2, "minAmount": 5 },"soldCount": 19793,"soldDisplay": "1.9万+","soldPeriod": "一年内","favoriteCount": 458,"images": ["https://cbu01.alicdn.com/img/ibank/O1CN01lAdPke1OFCTM0qUJK_!!3872131675-0-cib.jpg"],"videoUrl": "https://cloud.video.taobao.com/play/u/3872131675/p/2/e/6/t/1/533538773043.mp4","attributes": [{ "name": "材质", "value": "PC" },{ "name": "款式", "value": "防摔款" },{ "name": "品牌", "value": "潮虹兔" }],"unitWeightKg": 0.03,"shopReviewSummary": { "goodRate": 99.6, "grade": 5.0 },"badges": ["镇店之宝"],"supplier": {"companyName": "深圳市亿佳合兴科技有限公司","shopUrl": "https://winport.m.1688.com/page/index.html?memberId=b2b-38721316754ec7c","serviceScore": 4.0,"repeatBuyerRate3m": 56.5,"isTp": true,"location": "广东省深圳市"},"shipping": {"from": "广东省深圳市","cost": 3.0,"text": "承诺48小时发货·常发韵达快递","deliveryLimit": 2},"services": [{ "name": "晚发必赔" }],"distributionChannels": ["淘宝", "抖音", "快手", "微信", "Lazada", "Amazon", "Shopify", "Shopee"],"sourceKeyword": "手机壳","scrapedAt": "2026-11-12T15:21:54+00:00"}
How much does it cost to scrape 1688?
The actor uses pay-per-event pricing: you pay a flat price per collected product and per add-on. The current prices are on the Pricing tab. Cards-only mode is the cheapest way to collect large volumes.
| Event | When it is charged |
|---|---|
product | One product collected from its product page (status OK). |
product-card | One product taken from the search results in cards-only mode (status OK). Cheaper than product. |
reviews | One review attached to a product (includeReviews above 0): a product with 20 reviews is 20 events. |
same-items | sameItems is not empty (includeSameItems on). |
supplier-intelligence | At least part of the supplier intelligence data was found (includeSupplierIntelligence on). |
supplier | One supplier profile found (suppliers, status OK). |
You pay only for what was delivered:
- Only rows with status
OKare charged. Products skipped by your filters are free. - An add-on is charged only when its data is in the row. A product without reviews, or a supplier without factory data, costs nothing extra.
- Set a maximum charge per run in Apify and the actor stops cleanly when it is reached. An add-on that no longer fits is left out of the row (
warningssays so) and is not charged. - A product is never charged twice in one run.
Row statuses
Every row has an explicit status, so you always know what each row is:
| Status | Meaning | Charged? |
|---|---|---|
OK | The product (or the supplier profile) was collected. | Yes |
NOT_FOUND | The product is no longer on 1688 or the ID is wrong, or a search or a supplier has no results. | No |
BLOCKED | 1688 did not show this page this time. Try it again later. | No |
ERROR | The row could not be collected, for example an invalid link or a page without prices. statusMessage says why. | No |
If the run reaches its time limit or your maximum charge before everything is done, it still finishes as succeeded and keeps all collected data. Products and queries it did not get to are listed as free rows whose statusMessage starts with Not scraped:, Not searched: or Supplier products not collected:, so you can run them again.
Good to know
- Up to 5,000 products per query. One 1688 search gives up to 300 products. Deeper results come from extra searches split by price range and sort order, so they take longer and are less relevant. For the most relevant products, use more specific keywords or filters.
- About 700 products per photo. A search by photo, or look-alikes of an offer, returns up to about 700 products.
similarityScore: smaller means closer. - Supplier products. About 180 to 260 products per supplier can be found without a 1688 account; the full catalog is shown only to logged-in users.
- Cards-only rows are lighter. They have only the fields of the search card. Use full mode for variants, description, reviews and supplier intelligence.
- Data is in Chinese. Titles, attributes, supplier names and reviews come as 1688 shows them. Prices are in CNY.
- No contacts and no buyer data. The actor does not collect phone numbers, emails, WeChat or QQ, the names of company contact persons, or buyer names, avatars and profiles. The only supplier contact is the public seller chat link.
- No login. Only data visible without a 1688 account is collected. For example, the supplier company's own certificate list is not available (certificates of the product itself are).
- Run settings. Give the run a timeout of at least 5 minutes: the actor finishes saving products a few minutes before the timeout. The minimum memory is 1024 MB.
Integrations and API
- API: start runs and download results with the Apify API or the Apify clients for Python and JavaScript.
- Schedules: run the actor every day or week, for example with
monitorNameto track price changes. - Integrations: send results to Google Sheets, Slack, Make, Zapier, webhooks and other tools supported by Apify.
FAQ
Do I need a 1688 account or proxies? No. The actor uses its own proxies in China and does not log in.
Why are the results in Chinese? That is the language of 1688. Search with Chinese keywords for the best results; English keywords work too.
How many products can I get for one keyword? Up to 5,000 per query.
Can I scrape specific products?
Yes. Put product IDs or links in offerIds. They are scraped first. If you only want them, leave the other sources empty.
Can I find the same product from other sellers?
Yes: give a photo in imageUrls, or an offer in similarToOfferIds. Or turn on includeSameItems to get up to 8 offers of the same item in each row.
How do I see price changes between runs?
Set the same monitorName on every run. Each product row gets a monitor status: NEW, CHANGED, UNCHANGED or GONE.
Do I pay for products that were not collected?
No. Only rows with status OK are charged. Every other row has a status and a message, and you can run those products again with offerIds.
Do you collect supplier phone numbers or emails? No. Contact details, WeChat/QQ and contact person names are not collected. Free supplier data includes company registration, founding year, profile and shop metrics.
Why does a product have fewer reviews than I asked for? 1688 shows visitors without an account only part of a product's reviews, and some products have none. You pay only for the reviews you get.
Is it legal to scrape 1688? The actor collects only publicly visible product information and no personal data. You are responsible for how you use the data and for following the laws and terms that apply to you.
More 1688 scrapers
The same scraper is also available as focused actors with a short input form:
- 1688 Image Search Scraper: find products and suppliers by photo.
- 1688 Search Results Scraper: fast, low-cost product cards by keyword, link or category.
- 1688 Product Details Scraper: full product pages by link or offer ID.
- 1688 Supplier Scraper: supplier profiles and their products.
- 1688 Price Monitor: track prices, stock and sales of your products.