1688.com Supplier Scraper

🏭 Build a 1688 supplier shortlist from your product keywords

Sourcing teams, importers, and buyers can use this 1688.com supplier scraper to find suppliers and factories on 1688 with English or Chinese keywords, 1688 search links, or exact company names. Each supplier comes back as one structured profile. You get the company name and link, location, years on 1688, service scores, response and repeat-buyer rates, factory details, labels, and sample offers with CNY prices. You can compare many suppliers in one table and keep the direct 1688 links for your own review.

• Turn product keywords into a supplier shortlist with the 1688 supplier scraper.
• Find factories for an English or Chinese sourcing term with a 1688 factory search.
• Check main products, factory size, and processing modes with a 1688 manufacturer lookup.
• Compare location, years on 1688, response rates, and repeat-buyer rates in a 1688 supplier comparison.
• Keep labels, certifications, and source links for your checks with 1688 sourcing research.
• Send supplier profiles to a spreadsheet or database with a 1688 supplier list export.
• Find suppliers that show OEM or ODM work with a 1688 OEM supplier search.
• See prices, minimum orders, and quantity prices from representative 1688 offers of each supplier.

📦 What supplier data do you get?

Each dataset item is one supplier. Every item has these fields:

• searchMatch: the keyword, search link, or company name that found the supplier, with its place in the results
• supplierId: the 1688 supplier ID
• supplierName: the company or shop name in the language 1688 shows
• supplierUrl: the direct 1688 company page

The Actor also adds these fields when 1688 shows them:

Group	Fields
Company	logoUrl, location, companyAddress, businessRole
Scores and rates	yearsOnPlatform, qualityScore, serviceSubScores, responseRatePercent, repeatBuyerRatePercent, transactionContext
Factory	mainProducts, capabilities, processingModes, factoryTourUrl
Labels	verificationLabels, certifications
Offers	offers with title, link, image, unit, CNY price, minimum order, quantity prices, and the price text 1688 shows

Offers are some products from the supplier, not the full catalog. Labels, scores, and rates come from 1688. They are not an independent check of the supplier or advice to buy.

🚀 How to run the 1688 supplier search

1. Open the Actor in Apify Console.
2. Add one or more product, factory, or manufacturer terms under Supplier search keywords. You can also add 1688 search links or Exact company names.
3. Choose the marketplace and any sourcing criteria you need, such as supplier role, location, offer price, minimum order, or service score.
4. Set Maximum suppliers per search, or leave it empty to collect all suppliers that 1688 shows.
5. Start the run and open Supplier profiles in the default dataset.

All searches in one run use the same criteria and the same supplier limit. Use separate runs when searches need different settings. You do not need a 1688 login, cookies, or an API key.

⚙️ Input

Input fields

Add at least one keyword, search link, or company name.

Field	Type	What it does
keywords	array of strings	English or Chinese product, factory, or manufacturer keywords. Each keyword is searched as you type it. The form is prefilled with 手机壳.
startUrls	array of links	Full 1688 search links that include a search word, such as https://s.1688.com/selloffer/offer_search.htm?keywords=手机壳. Category links without a search word are not supported. A search link keeps the marketplace shown in the link.
companyNames	array of strings	1688 company names exactly as 1688 shows them. Only suppliers with that exact name are returned.
maxSuppliersPerQuery	integer	Most suppliers to save for each keyword, search link, or company name. Leave it empty or enter 0 to collect all suppliers that 1688 shows. The form is prefilled with 10. On large searches, 1688 can stop showing results before the end, so the run can save fewer.
marketplace	string	Marketplace for keyword and company name searches: consumer (Consumer goods) or industrial (Industrial goods). Default: consumer.
marketplaceProgram	string	any (default), trustpass for TrustPass (诚信通), or superFactory for Super Factory (超级工厂).
supplierQualification	string	any (default) or factory to keep only suppliers that 1688 shows as a factory or manufacturer.
verificationStatus	string	any (default), verified for verified suppliers, or factoryInspected for suppliers with a factory inspection shown.
locations	array of strings	Chinese provinces, cities, or industrial regions to match, such as Guangdong or 深圳. Leave it empty to search all locations.
minPriceCny	number	Keep suppliers with a sample offer at or above this CNY price.
maxPriceCny	number	Keep suppliers with a sample offer at or below this CNY price. It cannot be lower than minPriceCny.
maxMinimumOrder	integer	Keep suppliers with a sample offer whose minimum order is at or below this quantity. The lowest value is 1.
minServiceScore	number	Keep only suppliers whose 1688 service score is at or above this value. 1688 shows this score from 0 to 5.
sortBy	string	relevance (default), sales for top sellers first, priceAsc for low to high price, or priceDesc for high to low price. The order comes from 1688.

Example input

{
  "keywords": [
    "手机壳"
  ],
  "maxSuppliersPerQuery": 10,
  "marketplace": "consumer",
  "marketplaceProgram": "any",
  "supplierQualification": "any",
  "verificationStatus": "any",
  "sortBy": "relevance"
}

🧾 Output

Output fields

Field	Type	What it does
searchMatch.query	string	The keyword, 1688 search link, or company name that found this supplier first.
searchMatch.position	integer	The supplier's place in the keyword or search link results, starting at 1. Empty for a company name lookup.
supplierId	string	1688 supplier ID. Use it to match the same supplier across runs and files.
supplierName	string	Company or shop name shown by 1688 in its original language.
supplierUrl	string	Direct 1688 company page.
logoUrl	string	Supplier logo image, when 1688 shows one.
location	string	Supplier province and city, in the language 1688 shows.
companyAddress	string	Public company or factory address shown by 1688.
businessRole	string	The business role 1688 shows, such as manufacturer, trader, or wholesaler, in its original language.
yearsOnPlatform	integer	Number of years on 1688, when 1688 shows it.
qualityScore	number	The 1688 service score, on the scale 1688 uses (0 to 5).
serviceSubScores	array of objects	Parts of the 1688 service score.
serviceSubScores.name	string	Name of the sub-score, as 1688 shows it.
serviceSubScores.score	number	Value of the sub-score.
responseRatePercent	number	Response rate shown by 1688, from 0 to 100.
repeatBuyerRatePercent	number	Repeat-buyer rate shown by 1688, from 0 to 100.
transactionContext	string	Number sold for one of the supplier's offers, as 1688 shows it, with units when shown, such as 已售30+件. 1688 does not show a time period for this number.
mainProducts	array of strings	The supplier's main products or categories.
capabilities	array of strings	Factory size and capacity facts, such as staff count and factory area.
processingModes	array of strings	OEM, ODM, contract manufacturing, or other processing modes shown by 1688.
factoryTourUrl	string	Link to the supplier's virtual factory tour, when 1688 shows one.
verificationLabels	array of strings	Membership and factory program levels, factory audit or inspection status, and verification labels shown by 1688.
certifications	array of strings	Certifications and quality or trust labels shown by 1688. The Actor does not check them.
offers	array of objects	Some product offers from the supplier. This is not the full catalog.
offers.title	string	Offer title in its original language.
offers.url	string	Direct 1688 offer page.
offers.imageUrl	string	Offer image.
offers.unit	string	Sales unit shown for the offer.
offers.priceCny.min	number	Lowest offer price in CNY. When 1688 shows one price, this is that price.
offers.priceCny.max	number	Highest offer price in CNY, when 1688 shows a price range.
offers.minimumOrder.quantity	number	Smallest number of units you can order.
offers.minimumOrder.unit	string	Unit for the minimum order.
offers.quantityPricing	array of strings	Price for each order quantity in CNY, written as 1688 shows it.
offers.priceText	string	Offer price text exactly as 1688 shows it.

Fields that 1688 does not show are left out of the item.

Example supplier profile

{
  "searchMatch": {
    "query": "手机壳",
    "position": 2
  },
  "supplierId": "b2b-38721316754ec7c",
  "supplierName": "深圳市亿佳合兴科技有限公司",
  "supplierUrl": "https://m.1688.com/winport/b2b-38721316754ec7c.html?__existtitle__=1",
  "logoUrl": "https://cbu01.alicdn.com/img/ibank/O1CN019WL7Cp1OFC9lUZrKF_!!3872131675-0-cib.jpg",
  "location": "广东, 深圳市",
  "companyAddress": "广东笋岗街道宝岗路",
  "businessRole": "生产加工",
  "yearsOnPlatform": 9,
  "qualityScore": 4,
  "serviceSubScores": [
    {
      "name": "咨询体验",
      "score": 3
    },
    {
      "name": "物流体验",
      "score": 3
    },
    {
      "name": "纠纷解决",
      "score": 4
    },
    {
      "name": "商品体验",
      "score": 3.7
    },
    {
      "name": "售后体验",
      "score": 4
    }
  ],
  "responseRatePercent": 87.3,
  "repeatBuyerRatePercent": 56.7,
  "mainProducts": [
    "钢化膜",
    "AirPods保护套",
    "硅胶手机壳",
    "玻璃手机壳",
    "个性手机壳"
  ],
  "capabilities": [
    "员工人数 11 - 50 人",
    "厂房面积 500 m²",
    "年产能 1000000",
    "研发人数 11 - 20 人"
  ],
  "processingModes": [
    "OEM加工"
  ],
  "factoryTourUrl": "https://air.1688.com/pages/vr_viewer/vr_hall/dq193oei7/index.html?__pageId__=1247378&wh_pid=1247378&wvUseWKWebView=true&__existtitle__=1&xrBizCode=pmAuthentication&previewToken=acea2a6319eb470cb84408b664f54d26&sellerLoginId=%E6%B7%B1%E5%9C%B3%E4%BA%BF%E4%BD%B3%E5%90%88%E5%85%B4%E7%A7%91%E6%8A%80%E6%9C%89%E9%99%90%E5%85%AC%E5%8F%B8",
  "verificationLabels": [
    "诚信通",
    "质量保障",
    "发货保障",
    "换货保障",
    "企业身份认证"
  ],
  "certifications": [
    "ISO 9001",
    "CCC"
  ],
  "offers": [
    {
      "title": "适用iphone18PRO大视窗磁吸手机壳15磨砂漏标苹果11秒变17保护套",
      "url": "https://detail.1688.com/offer/735353578254.html",
      "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01lAdPke1OFCTM0qUJK_!!3872131675-0-cib.jpg",
      "unit": "个",
      "priceCny": {
        "min": 7.5,
        "max": 9
      },
      "minimumOrder": {
        "quantity": 2,
        "unit": "个"
      },
      "quantityPricing": [
        "2~499个: ¥9.00",
        "500~4999个: ¥8.50",
        "≥5000个: ¥7.50"
      ],
      "priceText": "¥9"
    },
    {
      "title": "大视窗散热磁吸支架适用苹果18pro手机壳17透气苹果16手腕绳防摔",
      "url": "https://detail.1688.com/offer/1062195124662.html",
      "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN017pecLK1OFCYhtdkyK_!!3872131675-0-cib.jpg",
      "priceCny": {
        "min": 14
      },
      "priceText": "¥14"
    },
    {
      "title": "高级感金属镜头支架适用iPhone18PROMAX手机壳闪粉磁吸苹果17/16",
      "url": "https://detail.1688.com/offer/1069989295758.html",
      "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01k3sMDzuxgqE2vH2e_!!3872131675-0-cib.jpg",
      "unit": "个",
      "priceCny": {
        "min": 10,
        "max": 11.5
      },
      "minimumOrder": {
        "quantity": 1,
        "unit": "个"
      },
      "quantityPricing": [
        "1~299个: ¥11.50",
        "300~2999个: ¥11.00",
        "≥3000个: ¥10.00"
      ],
      "priceText": "¥11.5"
    },
    {
      "title": "流光磁吸大视窗适用苹果18promax手机壳iPhone17高级感防摔保护套",
      "url": "https://detail.1688.com/offer/1046932411868.html",
      "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01gNu7Kf1OFCY2Eestd_!!3872131675-0-cib.jpg",
      "unit": "个",
      "priceCny": {
        "min": 13.5,
        "max": 15
      },
      "minimumOrder": {
        "quantity": 1,
        "unit": "个"
      },
      "quantityPricing": [
        "1~499个: ¥15.00",
        "500~2999个: ¥14.50",
        "≥3000个: ¥13.50"
      ],
      "priceText": "¥15"
    },
    {
      "title": "四角气囊防摔适用苹果17手机壳16iPhone18优盾磁吸支架闪粉保护套",
      "url": "https://detail.1688.com/offer/768952156088.html",
      "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01LTvPYZ1OFCVPUGDru_!!3872131675-0-cib.jpg",
      "priceCny": {
        "min": 8.5
      },
      "priceText": "¥8.5"
    }
  ]
}

Keep supplier and offer links with your exports so reviewers can check the 1688 pages.

💳 Pricing

This Actor uses pay-per-event pricing. You pay for each supplier profile saved to your dataset. The company, score, factory, and offer data in that profile are included in the same charge. Empty searches, failed requests, retries, and suppliers that are not saved are not charged. Check the pricing panel for the current price per profile.

🔌 Integrations

Run the Actor in Apify Console or through the Apify API. Schedule repeat runs, trigger workflows with webhooks, or export the default dataset in JSON, CSV, Excel, XML, RSS, or HTML for spreadsheets, databases, and BI tools.

❓ FAQ

Why did I receive fewer suppliers than the maximum I set?

The limit is a ceiling. A search may show fewer suppliers, and on large searches 1688 can stop showing results before the end. Sourcing criteria can lower the count more.

How do price and minimum order criteria use offer data?

These criteria use the sample offers that 1688 shows for each supplier. Values that 1688 does not show are left out, not guessed. Review the exported offers and links before you make sourcing decisions.

What happens when the same supplier appears in several searches?

A supplier is saved at most once per run. The searchMatch field shows the search that found it first.

Does the sales quantity cover a set time period?

No. transactionContext is the number sold for one of the supplier's offers, as 1688 shows it. 1688 does not show a time period for this number.

Does a verification label mean a supplier is safe?

No. Business roles, labels, certifications, scores, and rates come from 1688. They are not an independent check. Review the linked pages and do your own checks.

Does the Actor translate Chinese text or convert CNY prices?

No. Supplier names and other text stay in the language 1688 shows, and prices stay in CNY.

Does it collect complete catalogs, buyer reviews, or contact details?

No. It returns supplier profiles and some sample offers. It does not return full catalogs, SKU stock, buyer reviews, order history, or contact details that need a login.

How is this different from a 1688 product scraper?

This Actor saves one profile per supplier, with company, score, and factory details. Choose a product scraper when you need full offer details, SKU data, or product reviews.

📝 Changelog

v1.0 (31-10-2026)

• Runs with the default input now save suppliers again.
• New inputs: startUrls for 1688 search links, companyNames for exact supplier names, and minServiceScore to keep only suppliers with a high enough 1688 service score. keywords is no longer required when you use one of these.
• New output fields: logoUrl, serviceSubScores, factoryTourUrl, and offers[].priceText.
• Breaking: searchMatches (a list) is replaced by searchMatch (one object). It shows the keyword, 1688 link, or company name that found the supplier first, and the supplier's place in those results. Read searchMatch.query and searchMatch.position instead.
• Breaking: removed factoryStatus, platformLevel, and inspectionEvidence. The 1688 membership, factory program, and factory inspection labels are now in verificationLabels. The business role is in businessRole.
• Breaking: removed recentSales and recentActivity. Use transactionContext for the number sold, as 1688 shows it, and repeatBuyerRatePercent for the repeat buyer rate. 1688 does not show a time period for the number sold.
• Breaking: removed responseBehavior. Use responseRatePercent for the response rate.
• Breaking: removed offers[].offerId and offers[].sourcingContext. The offer ID is still part of the link in offers[].url. offers[].sourcingContext has no replacement.
• Breaking: keywords no longer has a default value. Before, a run with no keywords searched for 手机壳. Now a run with no keywords, links, or company names stops with an input error. Set keywords yourself, for example to ["手机壳"], to keep the old result.
• Breaking: if you leave out maxSuppliersPerQuery, the run now has no supplier limit. Before, the limit was 20. Set maxSuppliersPerQuery to 20 to keep the old limit. You can also enter 0 to collect all suppliers.
• Sales and price sorting now work as chosen, and price ranges include tier prices.
• Reliability improvements.

v0.1

• Initial release with supplier profiles, factory and marketplace details, and sample offers.

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

🔗 Related Actors

• GlobalSources Supplier Scraper: find Global Sources suppliers and manufacturers by product keyword to compare with 1688 suppliers.
• 1688.com Supplier Scraper: get 1688 factory profiles, quality scores, and product offers.
• 1688 Supplier Scraper: get one row per 1688 supplier with English names, service scores, and sample products.
• Alibaba 1688 Supplier Ratings Scraper: check 1688 supplier ratings and sub-scores by keyword or company name.
• 1688.com Wholesale Scraper - Prices, MOQ, Suppliers & SKUs: collect 1688 wholesale offers with quantity price tiers, MOQ, and SKU data.

Made with ❤️ by Maxime Dupré