1688.com Supplier Scraper
Pricing
from $3.99 / 1,000 results
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
Maintained by CommunityActor stats
0
Bookmarked
3
Total users
2
Monthly active users
a month ago
Last modified
Categories
Features
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
- Open the Actor's Input tab.
- Enter supplier keywords, supported 1688 URLs, or both.
- Choose result limits and whether to request supplier details and media.
- Click Start.
- 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.
| Field | Type | Required? | Default | What it does |
|---|---|---|---|---|
queries | Array of strings | Optional | None | Supplier keywords to search. Each keyword can be 1–300 characters; up to 20 keywords. |
sourceUrls | Array of URL objects | Optional | None; default category page is used when no source is supplied | Supported 1688 pages to search or browse. Up to 20 entries; each object contains a url. A nonempty list takes priority over queries. |
maxSuppliers | Integer | Optional | 20 | Maximum suppliers per source URL or keyword; range 1–100. Multiple sources can return more than this many records in total. |
maxPages | Integer | Optional | 1 | Maximum sequential pages per source URL or keyword; range 1–10. |
deduplicate | Boolean | Optional | true | Removes repeated suppliers across pages and sources using the supplier ID or profile URL. |
includeSupplierDetails | Boolean | Optional | true | Requests discovered public factory-card pages for additional supplier details. Embedded listing information can still be returned when disabled. |
includeMedia | Boolean | Optional | true | Includes available public media links for factories, production lines, equipment, patents, and offers. |
timeoutMs | Integer | Optional | 60000 | Per-request timeout in milliseconds; range 5000–120000. Supplier detail requests are capped at 10000 milliseconds. |
requestDelayMs | Integer | Optional | 500 | Delay between sequential requests in milliseconds; range 0–10000. |
maxRequestRetries | Integer | Optional | 1 | Retries transient request errors on the same URL; range 0–3. |
maxResponseBytes | Integer | Optional | 2000000 | Maximum response size accepted for parsing; range 10000–5000000 bytes. |
locale | String | Optional | zh-CN,zh;q=0.9,en;q=0.6 | Optional Accept-Language override, up to 40 characters. When omitted, the built-in language header is used. |
proxyConfiguration | Object | Optional | {"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.
| Field | Type | Required? | Meaning |
|---|---|---|---|
company_id | String | Optional | Public 1688 member or company identifier. |
company_name | String | Required | Supplier or factory display name. |
company_url | String | Required | Public supplier or factory profile URL. |
shop_url | String | Optional | Public supplier storefront URL. |
description | String | Optional | Company description published on the supplier profile. |
legal_company_name | String | Optional | Published legal company name. |
established_date | String | Optional | Published company establishment date or date text. |
factory_level | String | Optional | Published factory level or certification label. |
is_factory | Boolean | Optional | Public indication that the supplier is a factory. |
composite_score | Number | Optional | Published overall supplier score. It is separate from service_rating. |
service_rating | Number | Optional | Published supplier service star rating, not the overall composite score. |
repeat_rate | Number or string | Optional | Published repeat-purchase value, retaining source labels such as a percent sign. |
ww_response_rate | Number or string | Optional | Published response-rate value, retaining source labels when present. |
on_time_fulfillment_rate | Number or string | Optional | Published on-time fulfillment value, retaining a percent sign or source label when present. |
sale_quantity_3m | Number or string | Optional | Published three-month sales value, retaining source units when present. |
years_on_platform | Number or string | Optional | Published supplier tenure on the platform. |
buyer_will_count | Number or string | Optional | Published buyer-interest count or label. |
total_employees | String | Optional | Published total employee count or range, retaining its source unit. |
production_staff | String | Optional | Published production-staff count or range. This is separate from total employees. |
factory_area | String | Optional | Published factory floor area, retaining its source unit. |
quality_tags | Array of strings | Optional | Public quality, verification, production, or service labels. |
ai_capabilities | Array of strings | Optional | AI-related capability labels only when the source explicitly identifies them as AI capabilities. Manufacturing labels are not treated as AI capabilities. |
business_labels | Array of strings | Optional | Other public business, supplier, or factory labels. |
patents | Array of objects | Optional | Public patent records. Each can contain name, registration_number, and image_urls. |
brands | Array of strings | Optional | Public self-owned brand labels published by the supplier. |
foreign_trade_qualifications | Array of strings | Optional | Foreign-trade qualification labels published on the supplier profile. |
product_categories | Array of strings | Optional | Public product categories. |
oem_mode | String | Optional | Published OEM, ODM, or other manufacturing-service text. |
manufacture_type | String | Optional | Published manufacturing-service or factory-type text from the source. |
custom_contract_trade | String | Optional | Published custom-contract trade amount or range, retaining the source unit. |
province | String | Optional | Published province or administrative region. |
city | String | Optional | Published city. |
full_address | String | Optional | Public business address. |
latitude | Number | Optional | Public supplier location latitude. |
longitude | Number | Optional | Public supplier location longitude. |
company_registration | Object | Optional | Public 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_scale | Object | Optional | Published 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_lines | Object | Optional | Published line count and unit, with image_urls when available. |
manufacturing_equipment | Array of objects | Optional | Published manufacturing equipment. Each object can contain name, model, brand, count, and image_urls. |
testing_equipment | Array of objects | Optional | Published testing equipment. Each object can contain name, model, brand, count, and image_urls. |
factory_images | Array of objects | Optional | Factory images with title and public URL. |
factory_videos | Array of objects | Optional | Factory videos with title, public URL, cover_url, and duration_seconds. |
current_offer_title | String | Optional | Title of the representative embedded offer. |
current_offer_price_cny | Number | Optional | Representative offer price in CNY when the source publishes it in CNY. |
current_offer_price_usd | Number | Optional | Representative offer price in USD only when the source publishes a USD value. The Actor does not convert currencies. |
current_offer_moq | String | Optional | Published representative-offer minimum order quantity. |
current_offer_moq_unit | String | Optional | Unit used for the representative-offer MOQ. |
offers | Array of objects | Optional | Offers 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_count | Number or string | Optional | Source-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
| Field | Type | Meaning |
|---|---|---|
name | String | Published patent name. |
registration_number | String | Published patent registration number. |
image_urls | Array of URLs | Public images attached to the patent record. |
Company registration
| Field | Type | Meaning |
|---|---|---|
registration_number | String | Published company registration number. |
company_type | String | Published registered company type. |
registered_capital | String | Published registered capital, retaining its unit. |
established_date | String | Registered establishment date as published. |
registration_authority | String | Published registration authority. |
business_scope | String | Published registered business scope. |
business_address | String | Published registered business address. |
valid_until | String | Registration validity date or source text. |
verification_provider | String | Provider named for the public verification record. |
verified_date | String | Verification date or source-published date text. |
legal_representative | String | Published legal representative name. |
Factory scale and production lines
| Object | Field | Type | Meaning |
|---|---|---|---|
factory_scale | monthly_production_value | String | Published monthly production value or capacity. |
factory_scale | annual_trade_volume | String | Published annual trade volume, retaining its unit. |
factory_scale | minimum_order_quantity | String | Published minimum order quantity, retaining its unit. |
factory_scale | minimum_oem_order_quantity | String | Published minimum OEM order quantity, retaining its unit. |
factory_scale | material_purchase_lead_time | String | Published material purchasing lead time. |
factory_scale | vat_invoice | String | Published VAT invoice availability or wording. |
factory_scale | invoice_tax_rate | String | Published invoice tax rate, retaining the percent sign when shown. |
factory_scale | special_processes | String | Published special production processes. |
production_lines | count | Number | Published production-line count. |
production_lines | unit | String | Source unit or label for the line count. |
production_lines | image_urls | Array of URLs | Public images of production lines. |
Equipment and factory media
| Object | Field | Type | Meaning |
|---|---|---|---|
manufacturing_equipment and testing_equipment | name | String | Published equipment name. |
manufacturing_equipment and testing_equipment | model | String | Published equipment model. |
manufacturing_equipment and testing_equipment | brand | String | Published equipment brand. |
manufacturing_equipment and testing_equipment | count | Number | Published equipment count. |
manufacturing_equipment and testing_equipment | image_urls | Array of URLs | Public images of the equipment. |
factory_images | title | String | Source image title or caption. |
factory_images | url | URL | Public factory image URL. |
factory_videos | title | String | Source video title or caption. |
factory_videos | url | URL | Public factory video URL. |
factory_videos | cover_url | URL | Public video cover image URL. |
factory_videos | duration_seconds | Number | Published video duration in seconds. |
Offer fields and price tiers
| Field | Type | Meaning |
|---|---|---|
subject | String | Offer title. |
price | Number | Published offer price in its source currency. |
price_usd | Number | USD offer price only when published by the source. |
detail_url | URL | Public offer detail URL. |
pic_url | URL | Primary public offer image URL. |
unit | String | Offer sale unit. |
brief | String | Short source title or description. |
currency | String | Source-published offer currency. |
id | String | Public offer identifier. |
moq | String | Published minimum order quantity text. |
moq_unit | String | Unit used for the published minimum order quantity. |
price_tiers | Array of objects | Published quantity-based price breaks. |
image_urls | Array of URLs | Public images attached to the offer. |
free_shipping | Boolean | Whether the source marks the offer as eligible for free shipping. |
lead_time_days | Number | Published lead time in days. |
sales_count | Number | Published offer sales count. |
supports_online_customization | Boolean | Whether 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.
| Field | Type | Required? | Meaning |
|---|---|---|---|
status | String | Required | SUCCEEDED when at least one valid supplier record was saved; otherwise FAILED. |
itemsStored | Integer | Required | Number of supplier records successfully saved. |
isPartial | Boolean | Required | true 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.