1688.com Wholesale Scraper: Products & Suppliers avatar

1688.com Wholesale Scraper: Products & Suppliers

Pricing

from $3.99 / 1,000 products

Go to Apify Store
1688.com Wholesale Scraper: Products & Suppliers

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

TheShark

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

8 days ago

Last modified

Features

Limited permissions

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?

DataFields
Productoffer ID, link, title, category, attributes, package size and weight
Price and orderingprice range, quantity price tiers, MOQ, unit, stock, mixed wholesale, single-piece retail
Sales and popularitysold count, favorites, badges, review summary (good rate, grade, buyer impression tags)
Mediaimages, 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
Suppliercompany 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 servicesships from, shipping cost, delivery promise, services, coupons, sales channels
Same items (optional)up to 8 offers of the same item from other sellers
MonitoringNEW, CHANGED (with before and after values), UNCHANGED or GONE for every product

How to scrape 1688.com

  1. Open the actor and fill in at least one source: keywords, product IDs, search links, a category, photos, look-alike offers or suppliers.
  2. Set the number of results and, if you like, filters such as price, MOQ, region or supplier type.
  3. Choose the extra data you need: variants, reviews, supplier intelligence, same items.
  4. Click Start. Products appear in the dataset while the run goes on.
  5. 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

FieldTypeDefaultWhat it does
keywordslist of stringsemptySearch keywords, Chinese or English, for example ["手机壳", "phone case"]. Each keyword is searched separately, one after another.
offerIdslist of stringsempty1688 product IDs or product links (detail.1688.com/offer/<id>.html). These products are scraped first, always from their product pages.
searchUrlslist of stringsemptyLinks to 1688 search results. The keyword and filters of the link are used and win over the filters of the form.
categoryIdstringnone1688 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.
imageUrlslist of stringsemptyPhotos to search by (search by photo). Each photo is searched separately.
similarToOfferIdslist of stringsempty1688 product IDs or links. For each one, the products that look the same or very close are found and scraped.
maxSimilarityScorenumber0.2Only for similarToOfferIds: products with a higher similarityScore are skipped.
supplierslist of stringsemptyShop links, shop IDs (b2b-...) or exact company names. One profile row per supplier.
maxProductsPerSupplierinteger, 0 to 10000How many products to scrape for each supplier. 0 means only the profile.
maxResultsinteger, 1 to 5000100Maximum number of products per keyword, link, category, photo or look-alike offer.
scrapeProductPagesbooleantruefalse is the fast cards-only mode (see the examples).

Search filters

FieldTypeDefaultWhat it does
sortByrelevance, bestSelling, priceAsc, priceDescrelevanceOrder of search results.
priceMin, priceMaxnumber (CNY)noneOnly products priced at or above, or at or below, this value.
minOrderQuantityFrom, minOrderQuantityintegernoneOnly products whose minimum order quantity (MOQ) is at least, or at most, this value.
merchantTypeany, verifiedMerchantanyverifiedMerchant: only verified merchants (实力商家).
province, citystringnoneSupplier province and city in Chinese characters, for example 广东, 深圳. Several provinces can be separated by commas, for example 江苏,浙江.
dropshipping, freeShipping, dropshipFreeShipping, sevenDayReturn, fastInvoice, officialLogistics, verifiedFactory, bigBrandOembooleanfalseYes/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.
excludeKeywordslist of stringsemptySkip products whose title contains any of these words.

Data to include

FieldTypeDefaultWhat it does
includeSkuDetailsbooleanfalseAdd the full variant matrix: each variant with its options, price, stock and sales.
includeDescriptionHtmlbooleanfalseAdd the full product description as HTML. Description text and images are always included.
includeReviewsinteger, 0 to 1000How many latest reviews to attach to each product. Charged per review delivered.
includeSupplierIntelligencebooleanfalseAdd a supplierIntelligence block with detailed factory, certificate, customization, dropshipping and ranking data. Charged as an extra event.
includeSameItemsbooleanfalseAdd 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

FieldTypeDefaultWhat it does
monitorNamestringnoneTurns 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): reviewSummary with the product's good rate, grade, review counts by type, buyer impression tags and fulfilment metrics.
  • Media: images, mainImages, videoUrl, videoCoverUrl, description images and descriptionUrl.
  • Specs: attributes (name and value pairs), packageDetails (size and weight), unitWeightKg.
  • Supplier: supplier with 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 as tradeScores and inspection report links.
  • Photo search and look-alikes: similarityScore (smaller is closer), source (which query found the row).
  • Cards-only rows: dataLevel is card (rows with a product page have full).
  • 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), so reviews can be shorter than includeReviews and reviewSummary.counts.total. If the reviews of a product could not be collected, reviews is null, warnings says 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.

EventWhen it is charged
productOne product collected from its product page (status OK).
product-cardOne product taken from the search results in cards-only mode (status OK). Cheaper than product.
reviewsOne review attached to a product (includeReviews above 0): a product with 20 reviews is 20 events.
same-itemssameItems is not empty (includeSameItems on).
supplier-intelligenceAt least part of the supplier intelligence data was found (includeSupplierIntelligence on).
supplierOne supplier profile found (suppliers, status OK).

You pay only for what was delivered:

  • Only rows with status OK are 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 (warnings says 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:

StatusMeaningCharged?
OKThe product (or the supplier profile) was collected.Yes
NOT_FOUNDThe product is no longer on 1688 or the ID is wrong, or a search or a supplier has no results.No
BLOCKED1688 did not show this page this time. Try it again later.No
ERRORThe 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 monitorName to 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: