# 1688 Wholesale Scraper - Products, Pricing & Suppliers (`vulnv/1688-wholesale-scraper`) Actor Scrape 1688.com wholesale products by keyword or offer ID. Get tiered pricing, MOQ, SKU variants, stock, supplier verification, dropship channels, coupons and 50+ structured fields per product. No login required. - **URL**: https://apify.com/vulnv/1688-wholesale-scraper.md - **Developed by:** [VulnV](https://apify.com/vulnv) (community) - **Categories:** E-commerce, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.50 / 1,000 products This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 1688 Wholesale Scraper: Products, Pricing, SKUs & Suppliers Scrape wholesale products from **1688.com** (Alibaba's China B2B marketplace) by **keyword** or **offer ID**. Every result is one product with 50+ structured fields: tiered wholesale pricing, minimum order quantity, the full SKU variant matrix, stock, images and video, product attributes, supplier verification, dropship/distribution channels, coupons and mixed-batch rules. > **Unofficial.** This Actor is not affiliated with, endorsed by, or sponsored by > 1688.com, Alibaba or any supplier. "1688" and supplier/brand names are > trademarks of their respective owners and are used here only to describe the > data the Actor returns. It extracts publicly visible product and supplier > listing data only - no personal data and no login. ### 🚀 How to use 1. Click **Try for free** / **Start**. 2. Type one or more **keywords** - English (`wireless earbuds`, `phone case`) or Chinese (`手机壳`, `蓝牙耳机`). Chinese keywords usually return more results. 3. (Optional) Instead of keywords, paste specific **Offer IDs** to scrape exactly those products. The ID is the number in any product URL: `offerId=735353578254`. 4. Set **Max results per keyword**, an optional price range or MOQ, and run. 5. Download the results as **JSON, CSV, Excel, HTML or via API**. ### ✨ Features - 🔎 **Keyword or offer-ID input** - search in Chinese or English, or scrape exact products by ID. Cross-keyword duplicates are removed automatically. - 💲 **Tiered wholesale pricing** - the full quantity-break ladder (`beginAmount → endAmount → price`), min/max price, currency and price display. - 📦 **Order terms** - minimum order quantity, live stock, unit, unit weight and mixed-batch (混批) rules (min pieces / min amount). - 🎨 **SKU variant matrix** *(optional)* - every color/size/model combination with its own SKU id, spec attributes, per-variant stock and sales count. - 🏷️ **Product attributes** - material, style, craft, features and the rest of the structured spec table, plus category path and brand. - 🖼️ **Media** - main image gallery, detail images, and the product video URL. - 🏭 **Supplier profile** - company name, member id, seller type, shop URL, verification/trade-assurance flags, service score, positive-feedback rate and repeat-purchase rate, plus province/city. - 🚚 **Distribution & dropship intelligence** *(optional add-on)* - the resale channels the supplier authorizes (Taobao, Douyin, Amazon, Shopify, Shopee …), recent order volume, delivery terms and buyer-protection services. - 📝 **Descriptions** - detail-image URLs and a plain-text description are always included; the full HTML description is an optional toggle. ### 🧭 Input | Field | Type | Description | |-------|------|-------------| | `keywords` | array | Product keywords (English or Chinese). Searched independently. Ignored if `offerIds` is set. | | `offerIds` | array | Specific product IDs to scrape directly (skips search). | | `maxResults` | integer | Max products per keyword. Default `50`. | | `sortBy` | string | `relevance`, `bestSelling`, `priceAsc`, `priceDesc`. | | `includeSkuDetails` | boolean | Add the full SKU variant matrix. Default `false`. | | `includeDescriptionHtml` | boolean | Add the raw HTML description. Default `false`. | | `includeSupplierIntelligence` | boolean | Add distribution/dropship intelligence. Default `false`. | | `priceMin` / `priceMax` | integer | Only include products in this unit-price range (CNY). | | `minOrderQuantity` | integer | Only include suppliers whose MOQ is ≤ this value. | | `proxyCountry` | string | Country requests are routed through. `China` recommended. | #### Example input ```json { "keywords": ["wireless earbuds", "手机壳"], "maxResults": 50, "sortBy": "bestSelling", "includeSkuDetails": true, "includeSupplierIntelligence": true, "priceMax": 50 } ```` Scrape specific products instead: ```json { "offerIds": ["735353578254"], "includeSkuDetails": true } ``` ### 📤 Output One record per product. Abbreviated example: ```json { "offerId": "735353578254", "url": "https://detail.1688.com/offer/735353578254.html", "title": "适用iphone17PRO大视窗磁吸手机壳15磨砂漏标苹果16秒变17保护套", "brandName": "潮虹兔", "categoryName": "iPhone保护套", "unit": "个", "currency": "CNY", "priceMin": 9, "priceMax": 9, "priceTiers": [ { "beginAmount": 2, "endAmount": 499, "price": 9, "discountPrice": 9 } ], "minOrderQuantity": 2, "stock": 2327560, "saleCount": "1.3万+", "unitWeight": 0.03, "mixSupported": true, "mixAmount": 5, "mixNumber": 2, "attributes": { "材质": "PC", "款式": "全包款", "工艺": "磨砂" }, "mainImage": "https://cbu01.alicdn.com/img/ibank/...jpg", "images": ["..."], "detailImages": ["..."], "videoUrl": "https://cloud.video.taobao.com/play/...mp4", "supportsDropship": true, "isCrossBorder": true, "sellerCompanyName": "深圳市亿佳合兴科技有限公司", "sellerMemberId": "b2b-38721316754ec7c", "sellerType": "slsj", "shopUrl": "https://shop764420m281617.1688.com", "isTradeAssurance": true, "sellerServiceScore": "4.5分", "goodRate": 99.6, "repeatPurchaseRate": "57.69%", "sellerProvince": "广东省", "sellerCity": "深圳市", "skus": [ { "skuId": 5994388491498, "specAttributes": "梅红>iPhone 12", "stock": 9999, "saleCount": 0 } ], "supplierIntelligence": { "distributionChannels": ["淘宝", "抖音", "Amazon", "Shopify", "Shopee"], "recentOrderVolume": "7000+", "deliveryDays": 2 }, "keyword": "手机壳" } ``` The dataset ships with three table views: **Overview**, **Pricing & variants** and **Suppliers**. ### 💰 Pricing This Actor is **pay per result** - you are charged per product returned. The optional supplier-intelligence add-on adds a small per-product charge only when you switch it on. See the **Pricing** tab for current rates. ### ⚙️ How it works Just give it keywords or offer IDs and run - no account, login or cookies needed. 1688 is a domestic Chinese marketplace that serves its most complete data to local shoppers, so the Actor collects results as a China-based buyer would see them (set **Proxy country** to change this). Each product is returned as one clean, structured record. ### ❓ FAQ - **English or Chinese keywords?** Both work. Chinese keywords typically return many more results because 1688 is a domestic Chinese marketplace. - **Where do I find an offer ID?** It's the number in any product URL, e.g. `detail.1688.com/offer/735353578254.html` → `735353578254`. - **Prices are in CNY** (Chinese yuan). Convert to your currency as needed. - **Some fields are empty for a product.** Suppliers don't fill every field; the Actor returns whatever the listing exposes. ### ⚖️ Legal Use the data responsibly and in line with applicable laws and 1688's terms. This Actor returns only publicly available listing information and no personal data. # Actor input Schema ## `keywords` (type: `array`): Products to search for. Works with English (wireless earbuds, phone case) or Chinese (手机壳, 蓝牙耳机). Each keyword is searched separately and Max results applies per keyword. Chinese keywords typically return more results since 1688 is a domestic Chinese marketplace. Ignored if Offer IDs are provided. ## `offerIds` (type: `array`): Specific product IDs to scrape directly (skips search). The ID appears in any 1688 product URL as offerId=735353578254. If filled, the keywords and filters are ignored. ## `maxResults` (type: `integer`): Maximum products to scrape per keyword. Cost scales linearly. Ignored when Offer IDs are filled. ## `sortBy` (type: `string`): How to sort search results. ## `includeSkuDetails` (type: `boolean`): Add the full SKU variant matrix (colors, sizes, models with per-variant stock and sales). Significantly increases output size per product. Leave off if you only need product-level data. ## `includeDescriptionHtml` (type: `boolean`): Add the complete product description as raw HTML. This can be large. The detail-image URLs and a plain-text description are always included regardless of this setting. ## `includeSupplierIntelligence` (type: `boolean`): Add per-product supplier and distribution intelligence: authorized dropship/resale channels, recent order volume, fulfillment/delivery terms, buyer-protection services and consolidated seller signals. Off by default. ## `priceMin` (type: `integer`): Only include products with unit price ≥ this value, in Chinese yuan. ## `priceMax` (type: `integer`): Only include products with unit price ≤ this value, in Chinese yuan. ## `minOrderQuantity` (type: `integer`): Only include suppliers whose minimum order quantity is ≤ this value. Useful for finding suppliers willing to sell small quantities. ## `proxyCountry` (type: `string`): Country the requests are routed through. 1688 is a Chinese marketplace and serves the richest data to China IPs, so China is strongly recommended. ## Actor input object example ```json { "keywords": [ "wireless earbuds" ], "offerIds": [], "maxResults": 50, "sortBy": "relevance", "includeSkuDetails": false, "includeDescriptionHtml": false, "includeSupplierIntelligence": false, "proxyCountry": "China" } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "wireless earbuds" ] }; // Run the Actor and wait for it to finish const run = await client.actor("vulnv/1688-wholesale-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keywords": ["wireless earbuds"] } # Run the Actor and wait for it to finish run = client.actor("vulnv/1688-wholesale-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keywords": [ "wireless earbuds" ] }' | apify call vulnv/1688-wholesale-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=vulnv/1688-wholesale-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "1688 Wholesale Scraper - Products, Pricing & Suppliers", "description": "Scrape 1688.com wholesale products by keyword or offer ID. Get tiered pricing, MOQ, SKU variants, stock, supplier verification, dropship channels, coupons and 50+ structured fields per product. No login required.", "version": "1.0", "x-build-id": "3yWz4R6BfPp2nrXin" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vulnv~1688-wholesale-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vulnv-1688-wholesale-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/vulnv~1688-wholesale-scraper/runs": { "post": { "operationId": "runs-sync-vulnv-1688-wholesale-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/vulnv~1688-wholesale-scraper/run-sync": { "post": { "operationId": "run-sync-vulnv-1688-wholesale-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "keywords": { "title": "🔍 Search keywords (English or Chinese)", "type": "array", "description": "Products to search for. Works with English (wireless earbuds, phone case) or Chinese (手机壳, 蓝牙耳机). Each keyword is searched separately and Max results applies per keyword. Chinese keywords typically return more results since 1688 is a domestic Chinese marketplace. Ignored if Offer IDs are provided.", "items": { "type": "string" } }, "offerIds": { "title": "Offer IDs", "type": "array", "description": "Specific product IDs to scrape directly (skips search). The ID appears in any 1688 product URL as offerId=735353578254. If filled, the keywords and filters are ignored.", "default": [], "items": { "type": "string" } }, "maxResults": { "title": "Max results per keyword", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum products to scrape per keyword. Cost scales linearly. Ignored when Offer IDs are filled.", "default": 50 }, "sortBy": { "title": "Sort order", "enum": [ "relevance", "bestSelling", "priceAsc", "priceDesc" ], "type": "string", "description": "How to sort search results.", "default": "relevance" }, "includeSkuDetails": { "title": "Include SKU variants", "type": "boolean", "description": "Add the full SKU variant matrix (colors, sizes, models with per-variant stock and sales). Significantly increases output size per product. Leave off if you only need product-level data.", "default": false }, "includeDescriptionHtml": { "title": "Include full description HTML", "type": "boolean", "description": "Add the complete product description as raw HTML. This can be large. The detail-image URLs and a plain-text description are always included regardless of this setting.", "default": false }, "includeSupplierIntelligence": { "title": "Supplier & distribution intelligence", "type": "boolean", "description": "Add per-product supplier and distribution intelligence: authorized dropship/resale channels, recent order volume, fulfillment/delivery terms, buyer-protection services and consolidated seller signals. Off by default.", "default": false }, "priceMin": { "title": "Minimum price (CNY)", "minimum": 0, "type": "integer", "description": "Only include products with unit price ≥ this value, in Chinese yuan." }, "priceMax": { "title": "Maximum price (CNY)", "minimum": 0, "type": "integer", "description": "Only include products with unit price ≤ this value, in Chinese yuan." }, "minOrderQuantity": { "title": "Maximum acceptable minimum order quantity", "minimum": 1, "type": "integer", "description": "Only include suppliers whose minimum order quantity is ≤ this value. Useful for finding suppliers willing to sell small quantities." }, "proxyCountry": { "title": "Proxy country", "enum": [ "China", "Hong Kong", "Singapore", "United States" ], "type": "string", "description": "Country the requests are routed through. 1688 is a Chinese marketplace and serves the richest data to China IPs, so China is strongly recommended.", "default": "China" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```