1688 Supplier Scraper

🏭 Build a source-backed 1688 supplier shortlist

Sourcing teams, importers, and procurement researchers can search public 1688 supplier and factory results with English or Chinese keywords and export structured supplier profiles. Compare company identity, location, marketplace tenure and labels, manufacturing capabilities, activity signals, and representative offers while keeping direct 1688 links for review.

• 1688 supplier scraper — turn product keywords into structured supplier profiles.
• 1688 factory search — find factories shown for an English or Chinese sourcing term.
• 1688 manufacturer lookup — review source-visible manufacturing roles, main products, and capabilities.
• 1688 supplier comparison — compare location, platform tenure, response rates, repeat-buyer rates, and offers.
• 1688 sourcing research — preserve marketplace labels, certifications, inspection evidence, and source links for due diligence.
• 1688 supplier list export — send supplier profiles to a spreadsheet, database, or internal workflow.
• 1688 OEM supplier search — identify profiles that show OEM, ODM, or processing capabilities.

📦 What data is returned?

Each dataset item is one supplier with four required fields:

• searchMatches: the submitted keyword and one-based source result position that produced the saved profile
• supplierId: source-native supplier identifier
• supplierName: company or shop name in the language shown by 1688
• supplierUrl: direct public 1688 company page

The Actor also returns fields when the source exposes them:

Group	Fields
Company	location, companyAddress, businessRole, factoryStatus
Marketplace evidence	platformLevel, yearsOnPlatform, qualityScore, verificationLabels, certifications, inspectionEvidence
Activity	responseRatePercent, repeatBuyerRatePercent, responseBehavior, transactionContext, recentActivity
Manufacturing	mainProducts, capabilities, processingModes
Offers	offers with title, URL, image, CNY price range, sales unit, minimum order, quantity pricing, and sourcing context when available

Offers are representative supplier-comparison evidence, not a complete catalog. Marketplace labels and metrics retain the source's meaning; they are not independent supplier verification or a recommendation to transact.

🚀 Running the Actor

1. Open the Actor in Apify Console.
2. Add one or more focused product, factory, or manufacturer terms under Supplier search keywords.
3. Choose the marketplace and any supplier, location, offer-price, MOQ, or ordering criteria you need.
4. Set Maximum suppliers per keyword from 1 to 500.
5. Start the run and open Supplier profiles in the default dataset.

The maximum is a ceiling, not a guaranteed count. All keywords in one run share the same criteria and per-keyword limit. Use separate runs when searches need different settings.

⚙️ Input

Field	Type	Required	Description
keywords	String array	Yes	One or more non-empty English or Chinese product, factory, or manufacturer keywords.
maxSuppliersPerQuery	Integer	No	Maximum profiles accepted per keyword. Defaults to 20; accepts 1–500.
marketplace	String	No	Search the consumer-goods or industrial-goods marketplace.
marketplaceProgram	String	No	Filter for TrustPass or Super Factory membership, or accept any program.
supplierQualification	String	No	Require a source-visible factory or manufacturer role, or accept any role.
verificationStatus	String	No	Require source-visible verification or factory-inspection evidence, or accept any status.
locations	String array	No	Match Chinese provinces, cities, or industrial regions.
minPriceCny / maxPriceCny	Number	No	Apply representative-offer price criteria in CNY.
maxMinimumOrder	Integer	No	Set the highest acceptable minimum-order quantity shown for a representative offer.
sortBy	String	No	Use relevance, sales, ascending price, or descending price order.

{
  "keywords": ["蓝牙耳机", "phone case manufacturer"],
  "maxSuppliersPerQuery": 20,
  "marketplace": "consumer",
  "supplierQualification": "factory",
  "locations": ["广东"],
  "maxPriceCny": 50,
  "sortBy": "sales"
}

No buyer-provided 1688 login, cookies, credentials, or external API key are required.

🧾 Output example

{
  "searchMatches": [
    {
      "query": "蓝牙耳机",
      "position": 1
    }
  ],
  "supplierId": "b2b-2200717149444ca6b9",
  "supplierName": "深圳市示例科技有限公司",
  "supplierUrl": "https://example.1688.com",
  "location": "广东, 深圳",
  "businessRole": "Factory / manufacturer",
  "factoryStatus": "Factory",
  "yearsOnPlatform": 8,
  "mainProducts": ["蓝牙耳机"],
  "capabilities": ["OEM", "ODM"],
  "responseRatePercent": 95,
  "offers": [
    {
      "offerId": "123456789",
      "title": "无线蓝牙耳机",
      "url": "https://detail.1688.com/offer/123456789.html",
      "priceCny": {
        "min": 38,
        "max": 42
      }
    }
  ]
}

Optional fields are omitted when unavailable. Keep supplier and offer URLs with exports so reviewers can inspect the public source evidence.

💳 Pricing

This Actor uses pay-per-event pricing. You are charged for each successfully saved, visible, source-backed supplier profile. Available company, marketplace, manufacturing, and representative-offer data are bundled with that profile. Empty searches, failed work, retries, internal steps, and work that does not produce a supplier profile are not charged as supplier profiles. Check the pricing panel for the current per-profile price.

🔌 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 requested maximum?

The limit is a ceiling. A query may expose fewer public profiles, and a profile is saved only when usable supplier identity and a source link are available. Filters can reduce the count further.

How do price and MOQ filters handle missing offer data?

These criteria use representative public offers when 1688 exposes the relevant value. Optional values are omitted rather than inferred, so review the exported offers and source links before making sourcing decisions.

What happens when the same supplier appears in multiple searches?

A supplier is emitted at most once per run. Later occurrences of the same source supplier are skipped, so run separate keyword searches when you need a complete result-position trail for each term.

Does a verification label mean a supplier is safe?

No. Factory status, marketplace labels, certifications, inspection evidence, and quality or activity metrics are source-visible evidence, not independent due diligence. Review the linked pages and conduct your own checks.

Does the Actor translate Chinese text or convert CNY prices?

No. Supplier names and source-visible text may remain in Chinese, and prices remain in CNY. The Actor does not perform automatic translation or exchange-rate conversion.

Does it collect complete catalogs, buyer reviews, or hidden contacts?

No. It returns supplier profiles and bounded representative offers, not complete catalogs, SKU inventory, buyer reviews, order histories, or authenticated contact data.

How is this different from a 1688 product scraper?

This Actor starts with supplier and factory sourcing criteria and emits one profile per accepted supplier. Choose a product-focused Actor when you need broad product search, full offer details, SKU data, or product reviews.

🔗 Related actors

• 1688 Products Wholesale Scraper - 50+ Fields, 250+ Products/Min — collect broader product data, tiered pricing, supplier facts, and specifications from 1688.
• 1688 Wholesale Scraper — Tier Pricing · MOQ · Supplier Data — research 1688 product offers with quantity breaks, MOQ, supplier details, and SKU attributes.
• 1688.com Products Scraper — find 1688 products with bulk pricing tiers, specifications, supplier badges, and demand metrics.
• 1688.com Search Scraper — export product search listings with prices, images, sellers, sales, and locations.

📝 Changelog

• 0.1 — Initial release with source-backed supplier profiles, manufacturing and marketplace evidence, and representative offers.

🆘 Support

For issues, questions, or feature requests, file a ticket.

Made with ❤️ by Maxime Dupré