# 1688 Seller Detail Scraper (`burbn/1688-seller-detail-scraper`) Actor Scrape comprehensive seller data from 1688.com by Vendor ID. Extract store names, DSR ratings, positive feedbacks, years on platform, gold supplier status, direct shop links, and raw attributes. Fast, reliable & exportable to CSV/JSON. - **URL**: https://apify.com/burbn/1688-seller-detail-scraper.md - **Developed by:** [Kevin](https://apify.com/burbn) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Seller Detail Scraper – China Wholesale Vendor Data Extractor **Get detailed seller/vendor information from 1688.com (Alibaba China) by vendor ID. Extract shop name, credit scores, delivery & service ratings, features (factory, gold supplier), shop URL, sales volume, and more. Supports bulk vendor lookups and 35+ languages. Built with Apify best practices for reliability and speed.** --- ### Table of Contents - [Features](#features) - [Use Cases](#use-cases) - [Quick Start](#quick-start) - [Input Parameters](#input-parameters) - [Output Format](#output-format) - [Language Support](#language-support) - [Performance & Limits](#performance--limits) - [FAQ](#faq) - [Troubleshooting](#troubleshooting) - [Tags](#tags) --- ### Features - **Vendor Lookup by ID** – Fetch detailed seller information from 1688.com using vendor IDs. - **Bulk Lookup** – Scrape multiple vendor/seller profiles in a single run. - **Credit & Trust Scores** – Extract credit level, total feedbacks, and positive feedbacks. - **Performance Ratings** – Get delivery score, item score, and service score for each seller. - **Seller Features** – Identify factory sellers, gold suppliers, and other certified vendor types. - **Shop Details** – Extract shop name, shop URL, shop logo, and years on platform. - **Sales Volume** – Get 30-day sales volume, DSR score, trade level, and grade code. - **Multi-Language Support** – Get seller names and descriptions in 35+ languages including English, Chinese, Spanish, French, Japanese, Korean, Arabic, and more. --- ### Use Cases | Use Case | Description | Key Benefits | |----------|-------------|--------------| | Supplier Verification | Verify 1688 supplier credibility before placing orders. | Check credit level, years on platform, and performance scores. | | Vendor Comparison | Compare multiple vendors side-by-side for the same product category. | Benchmark delivery, item, and service scores across suppliers. | | Supply Chain Due Diligence | Enrich your vendor database with detailed seller profiles. | Automate supplier data collection with factory/gold status flags. | | Competitor Monitoring | Track competitor seller profiles and sales volumes over time. | Monitor 30-day sales volume and rating changes. | | Dropshipping Research | Evaluate potential 1688 suppliers for dropshipping partnerships. | Identify gold suppliers and factory-direct sellers. | | Market Intelligence | Analyze seller distribution and vendor quality across categories. | Score and rank vendors by ratings, credit, and sales data. | --- ### Quick Start #### 1. Basic – Single Vendor Lookup ```json { "vendorIds": ["abb-b2b-221850414746747d22"] } ```` #### 2. Bulk – Multiple Vendors ```json { "vendorIds": [ "abb-b2b-221850414746747d22", "abb-b2b-3288147562505f58", "abb-b2b-4450112849372a91" ] } ``` #### 3. Multi-Language – Chinese Output ```json { "vendorIds": ["abb-b2b-221850414746747d22"], "language": "zh-chs" } ``` *** ### Input Parameters | Parameter | Type | Required | Description | Default | Example | |-----------|------|----------|-------------|---------|---------| | `vendorIds` | Array of Strings | Yes | One or more 1688 vendor IDs to look up. Find vendor IDs using [1688 Product Search](https://apify.com/burbn/1688-product-search). | - | `["abb-b2b-221850414746747d22"]` | | `language` | String | No | Language for seller names and descriptions (see [Language Support](#language-support)) | `"en"` | `"zh-chs"`, `"ja"`, `"ko"` | *** ### Output Format #### Seller Result Data Structure ```json { "source": "1688_seller_detail", "position": 1, "id": "abb-b2b-221850414746747d22", "provider_type": "Alibaba1688", "name": "天豪电动车厂", "display_name": "天豪电动车厂", "shop_name": "临沂沂河新区天豪电动车厂", "email": "", "picture_url": "https://cbu01.alicdn.com/img/ibank/...", "display_picture_url": "https://cbu01.alicdn.com/img/ibank/...", "shop_logo": "https://cbu01.alicdn.com/img/ibank/...", "location": null, "credit_level": 4, "credit_score": 0, "total_feedbacks": 0, "positive_feedbacks": 0, "delivery_score": 3, "item_score": 3.6, "service_score": 3.3, "is_factory": true, "is_gold_supplier": true, "features": ["isFactory", "isGold"], "user_id": "2218504147467", "shop_id": "2542007", "years_on_platform": 1, "stars": 3.5, "shop_url": "https://shop5m7824x522285.1688.com/", "vendor_type_image_url": "https://img.alicdn.com/imgextra/...", "trade_level": 2, "encrypted_vendor_id": "BBB9eSevm_FL6Ckft7N4_QCZA", "dsr_score": 4.0, "sales_volume_30d": 19805, "fw_score": 4.68, "grade_code": "MEMBER_TRADE_LEVEL_AA", "level_ratio": 0.55, "featured_values_raw": { "userId": "2218504147467", "shopId": "2542007", "years": "1", "stars": "3.5", "shopLogo": "https://...", "shopUrl": "https://shop5m7824x522285.1688.com/", "vendorTypeImageUrl": "https://...", "tradeLevel": "2", "encrypted_vendor_id": "BBB9eSevm_FL6Ckft7N4_QCZA", "dsrScore": "4.0", "salesVolume30d": "19805", "fwScore": "4.68", "gradeCode": "MEMBER_TRADE_LEVEL_AA", "levelRatio": "0.55" }, "updated_time": "2026-07-11T08:26:48.311Z", "scraped_at": "2026-07-25T12:30:00.000Z" } ``` #### Output Fields Explained | Field | Type | Description | |-------|------|-------------| | `source` | String | Source indicator, always `1688_seller_detail` | | `position` | Integer | Position of the vendor in the scraper batch (1-based) | | `id` | String | 1688 internal vendor ID | | `provider_type` | String | Data provider type (always `Alibaba1688`) | | `name` | String | Vendor/seller name | | `display_name` | String | Vendor display name | | `shop_name` | String | Full shop/store name on 1688 | | `email` | String | Vendor email (if available) | | `picture_url` | String | Vendor profile picture URL | | `display_picture_url` | String | Vendor display picture URL | | `shop_logo` | String | Shop logo image URL | | `location` | Object | Vendor location details (if available) | | `credit_level` | Number | Vendor credit level (1-5+) | | `credit_score` | Number | Vendor credit score | | `total_feedbacks` | Number | Total number of feedbacks received | | `positive_feedbacks` | Number | Number of positive feedbacks | | `delivery_score` | Number | Delivery performance score (1-5) | | `item_score` | Number | Item quality score (1-5) | | `service_score` | Number | Customer service score (1-5) | | `is_factory` | Boolean | Whether the seller is a factory/manufacturer | | `is_gold_supplier` | Boolean | Whether the seller is a gold-certified supplier | | `features` | Array | Raw feature tags (e.g., `isFactory`, `isGold`) | | `user_id` | String | Internal 1688 user ID | | `shop_id` | String | Internal 1688 shop ID | | `years_on_platform` | Number | Years the vendor has been on 1688 | | `stars` | Number | Vendor star rating | | `shop_url` | String | Direct link to the vendor's 1688 shop | | `vendor_type_image_url` | String | Badge/certification image URL | | `trade_level` | Number | Trade level indicator | | `encrypted_vendor_id` | String | Encrypted vendor identifier | | `dsr_score` | Number | DSR (Detail Seller Rating) score | | `sales_volume_30d` | Number | Sales volume in the last 30 days | | `fw_score` | Number | FW (comprehensive) score | | `grade_code` | String | Vendor grade code (e.g., `MEMBER_TRADE_LEVEL_AA`) | | `level_ratio` | Number | Vendor level ratio | | `featured_values_raw` | Object | All featured values as raw key-value pairs | | `updated_time` | String | ISO timestamp when the vendor info was last updated | | `scraped_at` | String | ISO timestamp of when the data was extracted | *** ### Language Support The API supports 35+ languages for seller names and descriptions: | Code | Language | Code | Language | |------|----------|------|----------| | `en` | English | `ja` | Japanese | | `zh-chs` | Chinese (Simplified) | `ko` | Korean | | `ru` | Russian | `ar` | Arabic | | `es` | Spanish | `vi` | Vietnamese | | `de` | German | `tr` | Turkish | | `pt` | Portuguese | `th` | Thai | | `fr` | French | `pl` | Polish | And many more: `ro`, `uk`, `fi`, `bg`, `he`, `hy`, `ka`, `az`, `ky`, `kk`, `ms`, `uz`, `no`, `km`, `ku`, `el`, `am`, `my`, `cz`, `khk`, `sah`. *** ### Performance & Limits - **Bulk Lookups** – Scrape hundreds of vendor profiles in a single run. - **Batching** – Data is saved in batches of 10 items to prevent loss during unexpected errors. - **Rate Limiting** – Built-in 1.5-second delay between vendor requests for optimal throughput. - **Key Rotation** – Automatic key rotation and retry logic for smooth, uninterrupted performance. - **Deduplication** – Duplicate vendor IDs are automatically removed before processing. *** ### FAQ - **Q: Where do I find vendor IDs?** - You can get vendor IDs using our [1688 Product Search](https://apify.com/burbn/1688-product-search) actor results. Every product result includes a `vendor_id` field (e.g., `abb-b2b-221850414746747d22`). - **Q: Can I look up multiple vendors at once?** - Yes! Simply add multiple vendor IDs to the `vendorIds` array. Each one will be queried individually with automatic rate limiting. - **Q: What if a vendor ID is invalid?** - Invalid vendor IDs will return an error record with details. The scraper will continue processing remaining vendor IDs. - **Q: What does "is\_factory" mean?** - The `is_factory` flag indicates the seller is a direct manufacturer/factory, meaning you can potentially get lower prices by sourcing directly. - **Q: What is the DSR score?** - DSR (Detail Seller Rating) is a comprehensive rating based on item quality, delivery speed, and customer service. Higher scores indicate better seller performance. - **Q: What data formats can I export?** - Apify supports exporting results as JSON, CSV, Excel (XLSX), XML, HTML, and RSS. *** ### Troubleshooting | Issue | Cause | Solution | |-------|-------|----------| | "No vendor IDs provided" | Empty or missing `vendorIds` array | Enter at least one valid vendor ID in the input | | Vendor not found | Invalid or outdated vendor ID | Verify the vendor ID using [1688 Product Search](https://apify.com/burbn/1688-product-search) results | | API returned error | Unexpected API response or invalid parameters | Check the error message and retry. Verify vendor ID format | | Rate limit exceeded | Too many concurrent requests | Wait a few minutes and try again | | Partial results | Some vendors failed while others succeeded | Check error records in the output for details on failed lookups | *** ### Why Choose This Actor? - Detailed 1688.com seller/vendor profiles - Credit level and trust scores - Delivery, item, and service performance ratings - Factory and gold supplier identification - Shop URL, logo, and years on platform - 30-day sales volume and DSR scores - Bulk vendor lookup support - Multi-language support (35+ languages) - Downloadable as CSV, Excel, JSON, XML, or HTML *** ### Tags `1688 scraper`, `1688 seller data`, `1688 vendor info`, `alibaba china scraper`, `china supplier data`, `1688 vendor scraper`, `supplier verification`, `vendor rating`, `wholesale supplier data`, `b2b vendor data`, `1688 shop details`, `apify actor` *** ### Get Started Now 1. Enter one or more **Vendor IDs** (e.g., `abb-b2b-221850414746747d22`) 2. Choose the **Language** (e.g., English) 3. Click **Start** to run the scraper 4. Export your data in JSON, CSV, or Excel format 5. Click ["Try for free"](https://apify.com?fpr=free-credits) to test the actor *** *Built using Apify Platform | Optimized for Performance & Reliability* # Actor input Schema ## `vendorIds` (type: `array`): 📋 Enter one or more 1688 vendor IDs to look up. You can find vendor IDs using [1688 Product Search](https://apify.com/burbn/1688-product-search) (e.g., 'abb-b2b-221850414746747d22'). Each vendor ID will be queried individually. ## `language` (type: `string`): 🗣️ Choose the language for seller names and descriptions in the response. ## Actor input object example ```json { "vendorIds": [ "abb-b2b-221850414746747d22" ], "language": "en" } ``` # Actor output Schema ## `sellers_overview` (type: `string`): Open the dataset view with an overview of all sellers including name, shop, scores, features, and sales volume. # 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 = { "vendorIds": [ "abb-b2b-221850414746747d22" ], "language": "en" }; // Run the Actor and wait for it to finish const run = await client.actor("burbn/1688-seller-detail-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 = { "vendorIds": ["abb-b2b-221850414746747d22"], "language": "en", } # Run the Actor and wait for it to finish run = client.actor("burbn/1688-seller-detail-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 '{ "vendorIds": [ "abb-b2b-221850414746747d22" ], "language": "en" }' | apify call burbn/1688-seller-detail-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=burbn/1688-seller-detail-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "1688 Seller Detail Scraper", "description": "Scrape comprehensive seller data from 1688.com by Vendor ID. Extract store names, DSR ratings, positive feedbacks, years on platform, gold supplier status, direct shop links, and raw attributes. Fast, reliable & exportable to CSV/JSON.", "version": "1.0", "x-build-id": "QQcMo5whMfojBeRo2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/burbn~1688-seller-detail-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-burbn-1688-seller-detail-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/burbn~1688-seller-detail-scraper/runs": { "post": { "operationId": "runs-sync-burbn-1688-seller-detail-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/burbn~1688-seller-detail-scraper/run-sync": { "post": { "operationId": "run-sync-burbn-1688-seller-detail-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", "required": [ "vendorIds" ], "properties": { "vendorIds": { "title": "🏷️ Vendor IDs", "minItems": 1, "type": "array", "description": "📋 Enter one or more 1688 vendor IDs to look up. You can find vendor IDs using [1688 Product Search](https://apify.com/burbn/1688-product-search) (e.g., 'abb-b2b-221850414746747d22'). Each vendor ID will be queried individually.", "default": [ "abb-b2b-221850414746747d22" ], "items": { "type": "string" } }, "language": { "title": "🌐 Language", "enum": [ "en", "zh-chs", "ru", "es", "de", "pt", "fr", "ja", "ko", "ar", "vi", "tr", "th", "pl", "ro", "uk", "fi", "bg", "he", "hy", "ka", "az", "ky", "kk", "ms", "uz", "no", "km", "ku", "el", "am", "my", "cz", "khk", "sah" ], "type": "string", "description": "🗣️ Choose the language for seller names and descriptions in the response.", "default": "en" } } }, "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 } } } } } } } } } } ```