# Alibaba Product Listings Scraper (`codenest/alibaba-product-listings-scraper`) Actor Input keywords, country filters, and max items to scrape unlimited Alibaba product listings. Outputs comprehensive bulk product data(100+ fields): titles, prices, specs, images, supplier details, customization options, payment methods & delivery rates. - **URL**: https://apify.com/codenest/alibaba-product-listings-scraper.md - **Developed by:** [CodeNest](https://apify.com/codenest) (community) - **Categories:** - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 scraped products 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/actors/running/actors-in-store.md#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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 ## 🏭 Alibaba Product Listings Scraper - Ultimate B2B Product Data Extractor **Effortlessly scrape comprehensive product listings based on product keywords from Alibaba with our powerful **Alibaba Product Listings Scraper**! This Apify actor enables bulk extraction of product details, specifications, supplier information, and pricing data.** *** ### 📋 Overview Need to analyze B2B markets, find suppliers, or build product databases? This **Alibaba Product Listings Scraper** delivers: - 🏷️ **Comprehensive Product Data** - Titles, prices, specifications, and images - 🏢 **Supplier Intelligence** - Company details, verification, and performance metrics - 💰 **Pricing & Order Info** - Price ranges, minimum order quantities, and sold counts - 🔍 **Advanced Search** - Keywords, country filtering, and URL-based scraping - 📦 **Customization & Logistics** - Customization options and packaging details Perfect for B2B buyers 🛒, procurement professionals 📊, market researchers 🔬, and e-commerce analysts 📈! *** ### ⭐ Core Capabilities of Alibaba Product Listings Scraper #### 🏷️ Product Data Extraction - **Multi-Keyword Search** - Scrape products across multiple search terms - **Complete Product Details** - Titles, prices, specs, and images - **Image Collection** - All product images with count tracking - **Video Detection** - Identify products with video content - **Category Recognition** - Product categorization #### 🏢 Supplier Intelligence - **Company Profiles** - Supplier name, location, and business type - **Verification Status** - Identify verified suppliers - **Performance Metrics** - Order volume, on-time delivery rate - **Response Time** - Supplier responsiveness tracking - **Contact Information** - Key contact person details #### 💰 Pricing & Order Analytics - **Price Ranges** - Minimum and maximum pricing - **Minimum Order Quantities** - MOQ requirements - **Sales Volume** - Products sold count tracking - **Payment Methods** - Accepted payment options - **Trade Assurance** - Buyer protection indicators #### 🔍 Advanced Search Capabilities - **Keyword Search** - Product-based search with multiple keywords - **Country Filtering** - Filter suppliers by country - **URL-Based Scraping** - Direct product URL support - **Pagination Control** - Configurable max items per search - **Proxy Support** - Built-in Apify proxy integration *** ### ⚙️ Input Configuration Simply configure your search parameters and click "Start". Input looks like this: ```json { "country": "india", "keywords": [ "laptop", "battery" ], "maxItems": 10, "urls": [ "https://www.alibaba.com/countrysearch/CN/eve-lifepo4-100ah.html" ], "maxConcurrency": 3, "minDelayMs": 1000, "maxDelayMs": 3000, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` #### 📝 Input Specifications | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `keywords` | Array | ✅ Yes | - | Product keywords to search for | | `maxItems` | Integer | ❌ No | 10 | Maximum products to scrape | | `urls` | Array | ❌ No | \[] | Direct product/URLs to scrape | | `country` | String | ❌ No | "" | Country code to filter suppliers | | `maxConcurrency` | Integer | ❌ No | 3 | Parallel scraping threads (1-10) | | `minDelayMs` | Integer | ❌ No | 1000 | Minimum delay between requests | | `maxDelayMs` | Integer | ❌ No | 3000 | Maximum delay between requests | | `proxyConfiguration.useApifyProxy` | Boolean | ❌ No | true | Enable Apify proxy rotation | | `proxyConfiguration.apifyProxyGroups` | Array | ❌ No | \[] | Proxy group selection | *** ### 📤 Output Structure Your **Alibaba Product Listings Scraper** produces comprehensive product data with supplier details and specifications: ```json [ { "productNo": 1, "title": "Latest Design 15.9 Inch Laptop AMD R7 6800HS 2.5K IPS Win 11 Pro", "price": "$287.00 - $405.00", "minOrder": "1 pieces", "productSoldCount": "900 sold", "productUrl": "https://www.alibaba.com/product-detail/...", "imgSrc": "https://sc04.alicdn.com/kf/...", "images": ["https://sc04.alicdn.com/kf/...", "..."], "imageCount": 6, "hasImages": true, "hasVideo": false, "specifications": { "processor type": "AMD-Ryzen 7", "operating system": "Windows 11", "display resolution": "2560*1600", "hard drive type": "SSD", "RAM": "DDR5 0GB/16/32GB", "LCD": "IPS Screen 2560*1600", "Battery": "15.4V 3800MAH", "color": "Gray" }, "packagingAndDelivery": { "logisticInfo": { "unitVolume": "0", "unitWeight": "0.0" } }, "customizationAbility": [ "Drawing-based customization", "Sample-based customization", "Full customization" ], "paymentInformation": { "tradeAssurance": true, "paymentMethods": [ "Trade Assurance", "Visa", "PayPal", "T/T (Wire Transfer)" ] }, "supplierDetails": { "supplier": "Zhongshan South Intelligent Manufacturing Co., Ltd.", "supplierLocation": "CN", "companyYears": "1 yrs", "businessType": "Manufacturer,Trading Company", "verificationLevel": "Verified Supplier", "storeOrders6Months": 2, "storeVolume6Months": "1,000+", "responseTime": "≤3h", "onTimeDeliveryRate": "100.0%" }, "category": "Consumer Electronics > Computer Hardware & Software > Gaming Laptops" } ] ``` #### 📖 Output Field Documentation **🔹 Product Information** | Field | Description | |-------|-------------| | `productNo` | Sequential product number | | `title` | Full product title/name | | `price` | Price range in USD | | `minOrder` | Minimum order quantity | | `productSoldCount` | Units sold (formatted) | | `productUrl` | Direct product page URL | | `category` | Product category hierarchy | **🔹 Media Assets** | Field | Description | |-------|-------------| | `imgSrc` | Primary product image URL | | `images` | All product image URLs | | `imageCount` | Total number of images | | `hasImages` | Flag indicating image availability | | `hasVideo` | Flag indicating video availability | **🔹 Specifications** | Field | Description | |-------|-------------| | `specifications` | Key-value product specifications | | Various dynamic fields | Processor, RAM, OS, display, battery, etc. | **🔹 Supplier Details** | Field | Description | |-------|-------------| | `supplier` | Company/Supplier name | | `supplierLocation` | Country code | | `companyYears` | Years in business | | `businessType` | Manufacturer, Trading Company, etc. | | `verificationLevel` | Verified Supplier status | | `storeOrders6Months` | Orders count (6 months) | | `storeVolume6Months` | Sales volume (6 months) | | `responseTime` | Average response time | | `onTimeDeliveryRate` | Delivery reliability percentage | **🔹 Payment & Customization** | Field | Description | |-------|-------------| | `tradeAssurance` | Buyer protection indicator | | `paymentMethods` | Accepted payment options | | `customizationAbility` | Customization service types | | `packagingAndDelivery` | Logistics and packaging details | *** ### 🎨 Key Features of This Alibaba Product Listings Scraper #### 🏗️ Advanced Product Discovery - **Multi-Keyword Search** - Search across multiple product terms simultaneously - **Pagination Support** - Configurable max items per search - **Direct URL Scraping** - Target specific product listings - **Country Filtering** - Filter suppliers by manufacturing country #### 📊 Supplier Analytics - **Verification Intelligence** - Identify verified and trusted suppliers - **Performance Metrics** - Track delivery rates and response times - **Order Volume Analysis** - Understand supplier popularity - **Business Type Classification** - Manufacturer vs. Trading Company #### 💎 Rich Product Specifications - **Dynamic Spec Extraction** - Handles diverse product attributes - **Specification Categories** - Processor, memory, display, battery, etc. - **Configuration Options** - Multiple variants and options #### 🛡️ Secure & Reliable - **Proxy Support** - Built-in Apify proxy rotation - **Rate Limiting** - Configurable delays to avoid blocking - **Error Resilience** - Individual failures handled gracefully - **Session Management** - Consistent scraping sessions *** ### 💡 Use Cases for Alibaba Product Listings Scraper - **🛒 B2B Buyers** - Find suppliers and compare products - **📊 Procurement Professionals** - Build supplier databases - **🔬 Market Researchers** - Analyze B2B market trends - **📈 E-commerce Analysts** - Track competitor pricing - **🏭 Manufacturers** - Identify product trends and opportunities - **💼 Import/Export Specialists** - Discover new products and suppliers - **📱 App Developers** - Power B2B product search applications - **🎯 Marketing Teams** - Analyze product positioning strategies *** ### ✨ Why Choose Our Alibaba Product Listings Scraper? - **⚡ Blazing Fast** - Concurrent scraping with optimized request handling - **🎯 100% Accurate** - Preserves all product data without alteration - **🔄 Regular Updates** - Adapts to Alibaba platform changes automatically - **📦 Complete Data** - Everything from specs to supplier details - **🛡️ Production Ready** - Battle-tested with thousands of products - **💰 Cost Efficient** - Optimized to minimize compute time - **🔒 Privacy Focused** - No personal data stored or shared *** ### ⚠️ Limitations - Only works with publicly accessible Alibaba listings - Some products may have limited specification data - Extremely high concurrency may trigger rate limiting - Search results limited to Alibaba's available inventory - Some supplier details may require additional verification *** ### 🔗🛠 Complete B2B Sourcing Scraper Suite Explore our professional data extraction collection: #### 🏭 Supplier Scrapers: - [Made In China Supplier/Company Scraper](https://apify.com/codenest/made-in-china-supplier-company-scraper) - YOU ARE HERE - [Zillow Agent Profile Scraper](https://apify.com/codenest/zillow-agent-profile-scraper) #### 📊 Product Scrapers: - [Made in China Product Scraper](https://apify.com/codenest/made-in-china-product-scraper) - [Made In China Top Ranking Product Scraper](https://apify.com/codenest/made-in-china-top-ranking-product-scraper) - [Zillow Property Scraper](https://apify.com/codenest/zillow-property-scraper) - [Alibaba Product Scraper](https://apify.com/codenest/alibaba-product-scraper) - [Amazon Product Scraper](https://apify.com/codenest/amazon-product-scraper) - [Amazon Deals Scraper](https://apify.com/codenest/amazon-deals-scraper) - [Zillow Property & Apartment Scraper](https://apify.com/codenest/zillow-property-apartment-scraper) - [Made In China Product & Company Details Scraper](https://apify.com/codenest/made-in-china-product-company-details-scraper) *** ### 📧 Need Custom Features for Your Alibaba Product Listings Scraper? Want **additional product fields**, **specific supplier metrics**, **custom output formats**, **advanced filtering**, or **automated alerts**? ✉️ Email **** for tailored enterprise solutions! *** # Actor input Schema ## `keywords` (type: `array`): Enter one or more search keywords (each line is one independent product search). The scraper automatically constructs the exact Alibaba Countrysearch URL: 'EVE lifepo4 100ah' ➡️ 'https://www.alibaba.com/countrysearch/CN/eve-lifepo4-100ah.html' And crawls the product listings to scrape full product details, tiered wholesale prices, MOQ, specifications, images, and supplier information. Example: • EVE lifepo4 100ah • solar panel • lithium battery 12v 100ah ## `urls` (type: `array`): Optionally enter direct Alibaba.com URLs to scrape (each line is one URL). Supported URL types: • Countrysearch listing pages (e.g. 'https://www.alibaba.com/countrysearch/CN/eve-lifepo4-100ah.html') • Trade search listing pages (e.g. 'https://www.alibaba.com/trade/search?SearchText=...') • Direct product detail pages (e.g. 'https://www.alibaba.com/product-detail/...html') ## `country` (type: `string`): Enter the country name or 2-letter ISO country code for countrysearch URL generation: • India or IN • Vietnam or VN • Pakistan or PK • Turkey or TR • Bangladesh or BD • United States or US • China or CN (Default) • Germany or DE, Italy or IT, Japan or JP, etc. ## `maxItems` (type: `integer`): Maximum number of products to scrape per keyword search or listing URL. Default is 20. ## `maxConcurrency` (type: `integer`): Maximum number of product pages to scrape in parallel. Lower values are safer against rate-limiting. Default is 3. ## `minDelayMs` (type: `integer`): Minimum random delay in milliseconds between requests. Default is 1000ms. ## `maxDelayMs` (type: `integer`): Maximum random delay in milliseconds between requests. Default is 3000ms. ## `proxyConfiguration` (type: `object`): Select Apify Proxy (Residential recommended) or provide custom proxy URLs for reliable scraping. ## Actor input object example ```json { "keywords": [ "EVE lifepo4 100ah" ], "urls": [], "country": "CN", "maxItems": 20, "maxConcurrency": 3, "minDelayMs": 1000, "maxDelayMs": 3000, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `products` (type: `string`): Dataset containing all scraped Alibaba products with full specifications, tiered prices, MOQ, image gallery, videos, and supplier profile. ## `outputRecord` (type: `string`): Complete structured JSON dataset output stored in default Key-Value Store # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("codenest/alibaba-product-listings-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 = {} # Run the Actor and wait for it to finish run = client.actor("codenest/alibaba-product-listings-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call codenest/alibaba-product-listings-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,codenest/alibaba-product-listings-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/zBdh4Efbffthn9Uy0/builds/fSfAVSotGGvmy9uIu/openapi.json