1688.com Supplier Scraper avatar

1688.com Supplier Scraper

Pricing

from $3.99 / 1,000 results

Go to Apify Store
1688.com Supplier Scraper

1688.com Supplier Scraper

Read public 1688 factory-search pages for supplier identity, public factory signals, locations, representative offers, and truthful access diagnostics. No login or challenge bypass.

Pricing

from $3.99 / 1,000 results

Rating

0.0

(0)

Developer

Coding Frontned

Coding Frontned

Maintained by Community

Actor stats

0

Bookmarked

3

Total users

2

Monthly active users

a month ago

Last modified

Categories

Features

Limited permissions

Share

What does 1688.com Supplier Scraper do?

This Actor collects public supplier and factory information from 1688.com. It can search supplier keywords or start from supported 1688 factory and search pages. Supplier details can include published company registration, factory scale, production lines, equipment, factory media, ratings, labels, and the offers embedded in a factory profile.

Each dataset item is a supplier business record. The Actor keeps public supplier and offer links so you can return to the source. Public claims and commercial terms come from supplier pages and are not independently verified.

Why use it?

Use the results to build supplier shortlists, compare published factory capabilities, and review embedded offer terms before contacting a business. Apify can schedule runs, provide API access, connect the dataset to other tools, and show run monitoring in one place.

How to scrape 1688.com suppliers

  1. Open the Actor's Input tab.
  2. Enter supplier keywords, supported 1688 URLs, or both.
  3. Choose result limits and whether to request supplier details and media.
  4. Click Start.
  5. Open the run's Output tab and view or download the dataset.

If both source fields are empty, the Actor starts from its default public category page.

Quick start:

{
"sourceUrls": [
{ "url": "https://sale.1688.com/factory/category.html?mainId=7" }
],
"maxSuppliers": 5,
"maxPages": 1
}

Input options

All fields are optional. Source URLs take priority over keyword searches. When neither is supplied, the Actor uses the public category page shown above.

FieldTypeRequired?DefaultWhat it does
queriesArray of stringsOptionalNoneSupplier keywords to search. Each keyword can be 1–300 characters; up to 20 keywords.
sourceUrlsArray of URL objectsOptionalNone; default category page is used when no source is suppliedSupported 1688 pages to search or browse. Up to 20 entries; each object contains a url. A nonempty list takes priority over queries.
maxSuppliersIntegerOptional20Maximum suppliers per source URL or keyword; range 1–100. Multiple sources can return more than this many records in total.
maxPagesIntegerOptional1Maximum sequential pages per source URL or keyword; range 1–10.
deduplicateBooleanOptionaltrueRemoves repeated suppliers across pages and sources using the supplier ID or profile URL.
includeSupplierDetailsBooleanOptionaltrueRequests discovered public factory-card pages for additional supplier details. Embedded listing information can still be returned when disabled.
includeMediaBooleanOptionaltrueIncludes available public media links for factories, production lines, equipment, patents, and offers.
timeoutMsIntegerOptional60000Per-request timeout in milliseconds; range 5000–120000. Supplier detail requests are capped at 10000 milliseconds.
requestDelayMsIntegerOptional500Delay between sequential requests in milliseconds; range 0–10000.
maxRequestRetriesIntegerOptional1Retries transient request errors on the same URL; range 0–3.
maxResponseBytesIntegerOptional2000000Maximum response size accepted for parsing; range 10000–5000000 bytes.
localeStringOptionalzh-CN,zh;q=0.9,en;q=0.6Optional Accept-Language override, up to 40 characters. When omitted, the built-in language header is used.
proxyConfigurationObjectOptional{"useApifyProxy":true,"apifyProxyGroups":["RESIDENTIAL"],"apifyProxyCountry":"CN"}Uses Apify Residential Proxy in China for cloud runs. Turn it off with useApifyProxy:false, choose another available group or country, or provide up to 20 proxyUrls. Residential traffic adds charges.

Optional proxy setup

The default uses Apify Residential Proxy in China. The example below shows the supported proxy input names. Availability and charges depend on the account and selected group.

{
"queries": [
"蓝牙耳机"
],
"maxSuppliers": 5,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyCountry": "CN"
}
}

Keywords and URLs

Generated keyword searches use the public 1688 supplier search page. URLs must use HTTPS and one of these hosts: sale.1688.com, factory.1688.com, or s.1688.com. Factory URLs must use /factory/home.html, /factory/category.html, or /factory/card.html. Search URLs use /youyuan/index.htm; if tab is present, its value must be mFactory. Do not include sign-in credentials or custom ports.

Keyword example:

{
"queries": ["手机保护套", "蓝牙耳机"],
"maxSuppliers": 5,
"maxPages": 1
}

Pagination example

Set maxPages to request additional sequential result pages:

{
"queries": [
"不锈钢水杯"
],
"maxSuppliers": 8,
"maxPages": 3,
"deduplicate": true
}

You can combine keyword and URL inputs; a nonempty sourceUrls list takes priority:

{
"queries": ["手机保护套"],
"sourceUrls": [
{ "url": "https://sale.1688.com/factory/category.html?mainId=7" }
],
"maxSuppliers": 5,
"deduplicate": true
}

Turn off supplier details and media

Use these switches when you only need information from the listing page:

{
"queries": [
"帆布袋"
],
"maxSuppliers": 5,
"includeSupplierDetails": false,
"includeMedia": false
}

Detail requests read supplier and offer information embedded in public factory-card pages. They do not open individual offer pages or expand the supplier's entire catalog. The offers array contains items embedded in the response; the source may return only part of a supplier's catalog. If detail requests are disabled, a listing that exposes only profile links may not provide enough information to create a supplier record.

1688 search pages can require a security check even when public category and profile pages are accessible. The Actor stops when it encounters that restriction.

What data does it return?

Each dataset item represents one supplier. company_name and company_url are required. Other fields appear only when a public page supplies them and the relevant detail or media option is enabled. Dataset records contain supplier and offer business information. You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

FieldTypeRequired?Meaning
company_idStringOptionalPublic 1688 member or company identifier.
company_nameStringRequiredSupplier or factory display name.
company_urlStringRequiredPublic supplier or factory profile URL.
shop_urlStringOptionalPublic supplier storefront URL.
descriptionStringOptionalCompany description published on the supplier profile.
legal_company_nameStringOptionalPublished legal company name.
established_dateStringOptionalPublished company establishment date or date text.
factory_levelStringOptionalPublished factory level or certification label.
is_factoryBooleanOptionalPublic indication that the supplier is a factory.
composite_scoreNumberOptionalPublished overall supplier score. It is separate from service_rating.
service_ratingNumberOptionalPublished supplier service star rating, not the overall composite score.
repeat_rateNumber or stringOptionalPublished repeat-purchase value, retaining source labels such as a percent sign.
ww_response_rateNumber or stringOptionalPublished response-rate value, retaining source labels when present.
on_time_fulfillment_rateNumber or stringOptionalPublished on-time fulfillment value, retaining a percent sign or source label when present.
sale_quantity_3mNumber or stringOptionalPublished three-month sales value, retaining source units when present.
years_on_platformNumber or stringOptionalPublished supplier tenure on the platform.
buyer_will_countNumber or stringOptionalPublished buyer-interest count or label.
total_employeesStringOptionalPublished total employee count or range, retaining its source unit.
production_staffStringOptionalPublished production-staff count or range. This is separate from total employees.
factory_areaStringOptionalPublished factory floor area, retaining its source unit.
quality_tagsArray of stringsOptionalPublic quality, verification, production, or service labels.
ai_capabilitiesArray of stringsOptionalAI-related capability labels only when the source explicitly identifies them as AI capabilities. Manufacturing labels are not treated as AI capabilities.
business_labelsArray of stringsOptionalOther public business, supplier, or factory labels.
patentsArray of objectsOptionalPublic patent records. Each can contain name, registration_number, and image_urls.
brandsArray of stringsOptionalPublic self-owned brand labels published by the supplier.
foreign_trade_qualificationsArray of stringsOptionalForeign-trade qualification labels published on the supplier profile.
product_categoriesArray of stringsOptionalPublic product categories.
oem_modeStringOptionalPublished OEM, ODM, or other manufacturing-service text.
manufacture_typeStringOptionalPublished manufacturing-service or factory-type text from the source.
custom_contract_tradeStringOptionalPublished custom-contract trade amount or range, retaining the source unit.
provinceStringOptionalPublished province or administrative region.
cityStringOptionalPublished city.
full_addressStringOptionalPublic business address.
latitudeNumberOptionalPublic supplier location latitude.
longitudeNumberOptionalPublic supplier location longitude.
company_registrationObjectOptionalPublic registration details. It can contain registration_number, company_type, registered_capital, established_date, registration_authority, business_scope, business_address, valid_until, verification_provider, verified_date, and legal_representative.
factory_scaleObjectOptionalPublished monthly_production_value, annual_trade_volume, minimum_order_quantity, minimum_oem_order_quantity, material_purchase_lead_time, vat_invoice, invoice_tax_rate, and special_processes. Values remain strings to preserve source units and wording.
production_linesObjectOptionalPublished line count and unit, with image_urls when available.
manufacturing_equipmentArray of objectsOptionalPublished manufacturing equipment. Each object can contain name, model, brand, count, and image_urls.
testing_equipmentArray of objectsOptionalPublished testing equipment. Each object can contain name, model, brand, count, and image_urls.
factory_imagesArray of objectsOptionalFactory images with title and public URL.
factory_videosArray of objectsOptionalFactory videos with title, public URL, cover_url, and duration_seconds.
current_offer_titleStringOptionalTitle of the representative embedded offer.
current_offer_price_cnyNumberOptionalRepresentative offer price in CNY when the source publishes it in CNY.
current_offer_price_usdNumberOptionalRepresentative offer price in USD only when the source publishes a USD value. The Actor does not convert currencies.
current_offer_moqStringOptionalPublished representative-offer minimum order quantity.
current_offer_moq_unitStringOptionalUnit used for the representative-offer MOQ.
offersArray of objectsOptionalOffers embedded in the supplier response. Each object can contain subject, price, price_usd, detail_url, pic_url, unit, brief, currency, id, moq, moq_unit, price_tiers, image_urls, free_shipping, lead_time_days, sales_count, and supports_online_customization.
offer_countNumber or stringOptionalSource-reported offer total when available; otherwise the count of embedded offers returned. It may be larger than the offers array.
All nested fields are optional and limited to the fields documented above. Missing source values are left out. Price and quantity details preserve source values; when a source price tier has no upper limit, max_quantity is omitted. The Actor does not estimate missing values or calculate currency conversions.

Nested fields

The nested objects below contain only the listed fields. A field is omitted when the source does not provide it.

Patents

FieldTypeMeaning
nameStringPublished patent name.
registration_numberStringPublished patent registration number.
image_urlsArray of URLsPublic images attached to the patent record.

Company registration

FieldTypeMeaning
registration_numberStringPublished company registration number.
company_typeStringPublished registered company type.
registered_capitalStringPublished registered capital, retaining its unit.
established_dateStringRegistered establishment date as published.
registration_authorityStringPublished registration authority.
business_scopeStringPublished registered business scope.
business_addressStringPublished registered business address.
valid_untilStringRegistration validity date or source text.
verification_providerStringProvider named for the public verification record.
verified_dateStringVerification date or source-published date text.
legal_representativeStringPublished legal representative name.

Factory scale and production lines

ObjectFieldTypeMeaning
factory_scalemonthly_production_valueStringPublished monthly production value or capacity.
factory_scaleannual_trade_volumeStringPublished annual trade volume, retaining its unit.
factory_scaleminimum_order_quantityStringPublished minimum order quantity, retaining its unit.
factory_scaleminimum_oem_order_quantityStringPublished minimum OEM order quantity, retaining its unit.
factory_scalematerial_purchase_lead_timeStringPublished material purchasing lead time.
factory_scalevat_invoiceStringPublished VAT invoice availability or wording.
factory_scaleinvoice_tax_rateStringPublished invoice tax rate, retaining the percent sign when shown.
factory_scalespecial_processesStringPublished special production processes.
production_linescountNumberPublished production-line count.
production_linesunitStringSource unit or label for the line count.
production_linesimage_urlsArray of URLsPublic images of production lines.

Equipment and factory media

ObjectFieldTypeMeaning
manufacturing_equipment and testing_equipmentnameStringPublished equipment name.
manufacturing_equipment and testing_equipmentmodelStringPublished equipment model.
manufacturing_equipment and testing_equipmentbrandStringPublished equipment brand.
manufacturing_equipment and testing_equipmentcountNumberPublished equipment count.
manufacturing_equipment and testing_equipmentimage_urlsArray of URLsPublic images of the equipment.
factory_imagestitleStringSource image title or caption.
factory_imagesurlURLPublic factory image URL.
factory_videostitleStringSource video title or caption.
factory_videosurlURLPublic factory video URL.
factory_videoscover_urlURLPublic video cover image URL.
factory_videosduration_secondsNumberPublished video duration in seconds.

Offer fields and price tiers

FieldTypeMeaning
subjectStringOffer title.
priceNumberPublished offer price in its source currency.
price_usdNumberUSD offer price only when published by the source.
detail_urlURLPublic offer detail URL.
pic_urlURLPrimary public offer image URL.
unitStringOffer sale unit.
briefStringShort source title or description.
currencyStringSource-published offer currency.
idStringPublic offer identifier.
moqStringPublished minimum order quantity text.
moq_unitStringUnit used for the published minimum order quantity.
price_tiersArray of objectsPublished quantity-based price breaks.
image_urlsArray of URLsPublic images attached to the offer.
free_shippingBooleanWhether the source marks the offer as eligible for free shipping.
lead_time_daysNumberPublished lead time in days.
sales_countNumberPublished offer sales count.
supports_online_customizationBooleanWhether the source marks the offer as supporting online customization.

Each price_tiers object can contain min_quantity (Number), max_quantity (Number), price (Number), and currency (String). max_quantity is left out when the source marks a price tier as open-ended.

Example supplier record

This illustrative JSON shows every supported supplier field and every offer field. The values are examples, not verified live supplier data. Real records include only the values available from the public source.

{
"company_id": "example-member-1001",
"company_name": "Example Audio Manufacturing Co.",
"company_url": "https://sale.1688.com/factory/card.html?memberId=example-member-1001",
"shop_url": "https://shop1001.1688.com/",
"description": "Illustrative public description of an audio product manufacturer.",
"legal_company_name": "Example Audio Manufacturing Co., Ltd.",
"established_date": "2015-06-18",
"factory_level": "Verified Factory",
"is_factory": true,
"composite_score": 4.6,
"service_rating": 4.7,
"repeat_rate": "87.5%",
"ww_response_rate": "98%",
"on_time_fulfillment_rate": "98.5%",
"sale_quantity_3m": "1,560 pieces",
"years_on_platform": 8,
"buyer_will_count": 42,
"total_employees": "80-100 people",
"production_staff": "45-60 people",
"factory_area": "2,800 m²",
"quality_tags": ["ISO9001", "On-site verification"],
"ai_capabilities": ["AI-enabled visual inspection"],
"business_labels": ["Verified manufacturer", "OEM / ODM"],
"patents": [
{
"name": "Audio driver assembly structure",
"registration_number": "CN 123456789",
"image_urls": ["https://img.alicdn.com/imgextra/i1/example-patent.jpg"]
}
],
"brands": ["Auris"],
"foreign_trade_qualifications": ["Customs registration"],
"product_categories": ["Wireless earbuds", "Bluetooth speakers"],
"oem_mode": "Custom assembly and branding",
"manufacture_type": "OEM and ODM",
"custom_contract_trade": "RMB 500,000",
"province": "Guangdong",
"city": "Shenzhen",
"full_address": "Example District, Shenzhen, Guangdong",
"latitude": 22.5431,
"longitude": 114.0579,
"company_registration": {
"registration_number": "91440300EXAMPLE001",
"company_type": "Limited liability company",
"registered_capital": "RMB 1,000,000",
"established_date": "2015-06-18",
"registration_authority": "Shenzhen Market Supervision Administration",
"business_scope": "Manufacture and sale of audio products",
"business_address": "Example District, Shenzhen, Guangdong",
"valid_until": "2035-06-17",
"verification_provider": "1688 business verification",
"verified_date": "2025-02-01",
"legal_representative": "Example Representative"
},
"factory_scale": {
"monthly_production_value": "20,000 pieces/month",
"annual_trade_volume": "RMB 8 million/year",
"minimum_order_quantity": "100 pieces",
"minimum_oem_order_quantity": "100 pieces",
"material_purchase_lead_time": "15 days",
"vat_invoice": "Available",
"invoice_tax_rate": "13%",
"special_processes": "SMT assembly; injection molding"
},
"production_lines": {
"count": 4,
"unit": "lines",
"image_urls": ["https://img.alicdn.com/imgextra/i1/example-line.jpg"]
},
"manufacturing_equipment": [
{
"name": "Automatic SMT placement machine",
"model": "SMT-X100",
"brand": "ExampleTech",
"count": 3,
"image_urls": ["https://img.alicdn.com/imgextra/i1/example-smt.jpg"]
}
],
"testing_equipment": [
{
"name": "Audio frequency analyzer",
"model": "AF-200",
"brand": "Example Instruments",
"count": 2,
"image_urls": ["https://img.alicdn.com/imgextra/i1/example-analyzer.jpg"]
}
],
"factory_images": [
{
"title": "Assembly workshop",
"url": "https://img.alicdn.com/imgextra/i1/example-factory.jpg"
}
],
"factory_videos": [
{
"title": "Factory production tour",
"url": "https://cloud.video.taobao.com/play/u/123456/p/2/e/6/t/1/123456.mp4",
"cover_url": "https://img.alicdn.com/imgextra/i1/example-video-cover.jpg",
"duration_seconds": 92
}
],
"current_offer_title": "Wireless earbuds with custom logo",
"current_offer_price_cny": 39.9,
"current_offer_price_usd": 5.5,
"current_offer_moq": "100",
"current_offer_moq_unit": "piece",
"offers": [
{
"subject": "Wireless earbuds with custom logo",
"price": 39.9,
"price_usd": 5.5,
"detail_url": "https://detail.1688.com/offer/123456789012.html",
"pic_url": "https://img.alicdn.com/imgextra/i1/example-earbuds.jpg",
"unit": "piece",
"brief": "OEM wholesale earbuds",
"currency": "CNY",
"id": "123456789012",
"moq": "100 pieces",
"moq_unit": "piece",
"price_tiers": [
{
"min_quantity": 100,
"max_quantity": 999,
"price": 39.9,
"currency": "CNY"
},
{
"min_quantity": 1000,
"price": 35.5,
"currency": "CNY"
}
],
"image_urls": [
"https://img.alicdn.com/imgextra/i1/example-earbuds.jpg",
"https://img.alicdn.com/imgextra/i2/example-earbuds.jpg"
],
"free_shipping": false,
"lead_time_days": 18,
"sales_count": 1200,
"supports_online_customization": true
}
],
"offer_count": 1
}

The supplier page may publish only a subset of these fields. Factory-card pages can expose additional business information and embedded offers, but this Actor does not expand every individual product page or claim to collect the full catalog.

Run results

Open Results in the run's Output tab for supplier records. Output summary opens the OUTPUT_SUMMARY JSON record in the run's default Key-value store. This summary is stored separately from supplier records.

FieldTypeRequired?Meaning
statusStringRequiredSUCCEEDED when at least one valid supplier record was saved; otherwise FAILED.
itemsStoredIntegerRequiredNumber of supplier records successfully saved.
isPartialBooleanRequiredtrue when some suppliers were saved but a later request, write or interruption limited the results.

A complete run shows Finished. A run that saves usable suppliers before a later failure shows Finished with limited results and retains those records. A run that saves no suppliers shows Failed. Reaching your requested supplier limit is normal completion.

Example run summary:

{
"status": "SUCCEEDED",
"itemsStored": 25,
"isPartial": false
}

How much does it cost?

Check current Apify platform and proxy pricing in the Console; this README does not quote a fixed price. More sources, pages, supplier detail requests, retries, and larger responses can increase runtime and resource use.

Support and responsible use

1688 may restrict automated requests or make some profile information unavailable. Published information can be incomplete, outdated, or translated differently. Check important supplier claims and terms with the source and supplier before making a purchasing decision. This Actor is independent of 1688 and Alibaba; follow source permissions and applicable rules when using public business information.

For help, open the Actor's Issues tab and include the run ID and public source page. The API tab explains programmatic access.