# Alibaba Product Scraper (`e-commerce/alibaba-product-scraper`) Actor Scrape Alibaba product data: title, price, supplier, images, rating, and description. Provide product URLs, a search-results URL, or a search keyword. Export to JSON, CSV, or Excel, run via API, schedule runs, or integrate with other tools. - **URL**: https://apify.com/e-commerce/alibaba-product-scraper.md - **Developed by:** [E Commerce](https://apify.com/e-commerce) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 product details This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 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/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 **Powered by [E-commerce Scraping Tool](https://apify.com/apify/e-commerce-scraping-tool).** Need data from other stores too? The E-commerce Scraping Tool gets you data from Alibaba, Amazon, eBay, and any other e-commerce site. ## Alibaba Product Scraper Extract Alibaba.com product data at scale: title, price, supplier, images, rating, and description, from any Alibaba product URL, search-results page, or search keyword. Built for B2B sourcing, wholesale price monitoring, and competitor and supplier research. Alibaba is the world's largest B2B marketplace, where the same product is offered by many suppliers at different prices and minimum order quantities. This Actor turns any Alibaba product, search, or keyword into clean, structured data you can compare and track. ### What does Alibaba Product Scraper do? Alibaba Product Scraper collects structured product data from Alibaba.com and returns it as JSON, CSV, or Excel. Give it product URLs, a search-results URL, or a search keyword, and it returns full product details for every item it finds. - 🛒 Scrape any Alibaba product page by URL - 🔎 Expand a search-results page into every product it contains - 🧭 Search Alibaba by keyword and scrape the matching products - 🏭 Capture supplier, price, rating, and review count for each product - 📦 Export to JSON, CSV, Excel, XML, or HTML, or pull results via API ### What data can you extract from Alibaba? The Alibaba Product Scraper returns the following fields for each product: | Product data | Commercial info | Additional details | | ---------------- | ---------------------- | ---------------------------------- | | 📝 Product title | 💰 Price | 🖼️ Image URL | | 🔗 Product URL | 💱 Currency | ⭐ Rating | | 🏭 Supplier | 🏷️ Input URL | 🗳️ Review count | | 📄 Description | 🔎 Keyword | 📊 Extra attributes (optional) | Enable **Include additional properties** to capture extra Alibaba-specific attributes (such as minimum order quantity and product attributes) under `additionalProperties`. ### Can I scrape Alibaba products, search results, and keywords? Yes. Alibaba Product Scraper accepts three kinds of input and resolves all of them to product pages: - **Product URLs**: direct links to Alibaba product (`/product-detail/`) pages. - **Search-results / listing URLs**: any Alibaba `/trade/search` or showroom page. The Actor collects the product links it finds and follows pagination. - **Search keyword**: a search term run against Alibaba.com. ### How does Alibaba Product Scraper work? 1. You provide product URLs, search-results URLs, or a keyword. 2. The Actor expands search-results URLs and keyword searches into individual product URLs. 3. It requests each product page and extracts the structured data. 4. Each product is saved to your dataset as it completes, so first results appear within a minute. 5. Anything that cannot be scraped is written to a separate errors dataset with a clear reason. ### Why use Alibaba Product Scraper? | Feature | Manual / generic tools | Alibaba Product Scraper | | ---------------- | ------------------------- | ------------------------------ | | Setup | Custom code and selectors | Just paste a URL or keyword | | Input types | One URL at a time | Product, search, and keyword | | Supplier & price | Manual copy-paste | Structured for every product | | Output | Unstructured HTML | Clean JSON, CSV, Excel | | Failures | Silent, break the run | Logged to an errors dataset | | Cost model | Fixed subscriptions | Pay only per product returned | ### What can you do with Alibaba data after scraping? - **Wholesale price monitoring**: track how the same product's price moves across suppliers and over time. - **Supplier research**: compare suppliers by price, rating, and review count to shortlist sourcing partners. - **Product and catalog enrichment**: pull titles, images, and descriptions to populate a sourcing catalog or an AI product tool. - **Competitor benchmarking**: compare Alibaba wholesale pricing against retail prices on other marketplaces. ### How to use Alibaba Product Scraper? 1. Create a free Apify account. 2. Open the Alibaba Product Scraper. 3. Paste Alibaba product URLs, a search-results URL, or type a keyword. 4. Set **Total maximum products** to cap the run (start with 50 to preview). 5. Click **Start**, then export your results or fetch them from the API. ### How much does Alibaba Product Scraper cost? It uses a **pay-per-event** model: a tiny fee per run start, plus a fee per product returned, dropping on higher plans. You are never charged for failed pages, and search or keyword runs stay predictable because you control the product cap. See the Pricing tab for current rates. ### Input Provide at least one of: product URLs, search-results URLs, or a keyword. | Field | Type | Description | | ---------------------- | ------- | ------------------------------------------------- | | `detailsUrls` | array | Direct Alibaba product (`/product-detail/`) URLs | | `listingUrls` | array | Alibaba search-results or showroom URLs | | `keyword` | string | Search term run against Alibaba.com | | `additionalProperties` | boolean | Include minimum order quantity and extra attributes | | `maxProductResults` | integer | Total products to scrape across the run | Example input: ```json { "detailsUrls": [{ "url": "https://www.alibaba.com/product-detail/Wholesale-750ml-Stainless-Steel-Bottle_1600569797644.html" }], "keyword": "stainless steel water bottle", "additionalProperties": true, "maxProductResults": 50 } ```` ### Output Each product is saved as one dataset item. Failed inputs go to a separate errors dataset. ```json { "url": "https://www.alibaba.com/product-detail/Wholesale-750ml-Stainless-Steel-Bottle_1600569797644.html", "name": "Wholesale 750ml 304 Stainless Steel Sports Water Bottle", "offers": { "price": 1.85, "currency": "USD" }, "brand": { "slogan": "Shenzhen Shengbaoli Technology Co., Ltd." }, "rating": 4.8, "reviewCount": 12, "description": "Insulated stainless steel sports water bottle, BPA-free, wholesale.", "image": "https://s.alicdn.com/@sc04/kf/example.jpg", "inputUrl": "https://www.alibaba.com/product-detail/Wholesale-750ml-Stainless-Steel-Bottle_1600569797644.html" } ``` ### How to run Alibaba Product Scraper via the API ```bash curl -X POST "https://api.apify.com/v2/acts/YOUR_USERNAME~alibaba-product-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "detailsUrls": [{ "url": "https://www.alibaba.com/product-detail/Wholesale-750ml-Stainless-Steel-Bottle_1600569797644.html" }], "maxProductResults": 10 }' ``` You can also run it via the Apify MCP server, schedule runs, or integrate the dataset with Make, Zapier, Google Sheets, and other tools. ### Troubleshooting - **A run returns 0 products.** Alibaba occasionally blocks automated requests. Re-run in a few minutes; the Actor records each blocked URL in the errors dataset with the reason, so a zero-result run is never silent. - **"Not a valid Alibaba product URL".** Product input must be an `alibaba.com` product page (its path contains `/product-detail/`). Put search or showroom pages in **Search-results / listing URLs** instead. - **Keyword search returns too many products.** Set **Total maximum products** to cap the run; broad B2B keywords can match thousands of listings. - **Missing rating or reviews.** Many Alibaba products have no reviews yet, so `rating` and `reviewCount` can be empty even on a successful scrape. ### FAQ **Is it legal to scrape Alibaba?** Scraping publicly available product data is generally legal. You are responsible for how you use the data and for complying with Alibaba's terms and applicable laws. Do not collect personal data. **Do I need an Alibaba account or API key?** No. You only need an Apify account and this Actor. **Can I get the data via API or MCP?** Yes. Every run exposes its dataset through the Apify API, and the Actor works with the Apify MCP server for AI assistants. **Does it support minimum order quantity (MOQ)?** Enable **Include additional properties** to capture MOQ and other supplier attributes under `additionalProperties` when Alibaba exposes them. **How many products can it scrape?** As many as you want. Use **Total maximum products** to control run size and cost. ### Are there other tools in Apify Store? Yes. If you need data from more than one store, use the [E-commerce Scraping Tool](https://apify.com/apify/e-commerce-scraping-tool) to scrape Alibaba, Amazon, eBay, and any other e-commerce site from a single Actor. # Actor input Schema ## `detailsUrls` (type: `array`): Direct URLs to individual Alibaba product pages. The Alibaba Product Scraper fetches each URL and returns that product's full data: title, price, supplier, images, rating, and description. Example: https://www.alibaba.com/product-detail/Wholesale-750ml-Stainless-Steel-Bottle\_1600569797644.html. Accepts Alibaba product (/product-detail/) URLs, with or without https://; put search-results URLs in the field below instead. Use this when you already know exactly which products you want, as it is the fastest and most reliable input. ## `listingUrls` (type: `array`): URLs to Alibaba search-results or listing pages that contain many products. The scraper opens each listing, collects the product URLs it finds (following pagination), then scrapes each product's details. Example: https://www.alibaba.com/trade/search?SearchText=water+bottle. Accepts Alibaba search-results and showroom URLs. Use this to scrape a whole search or category without listing every product URL yourself; pair it with 'Total maximum products' to cap the run. ## `keyword` (type: `string`): A search term used to find Alibaba products. The scraper runs the search on Alibaba.com, collects the matching product URLs, then scrapes each product's details. Example: stainless steel water bottle. Enter a single search phrase. Use 'Total maximum products' to limit how many results are scraped, since broad B2B searches can return thousands of matches. ## `additionalProperties` (type: `boolean`): Whether to include extra, source-specific product attributes in the output. When enabled, the scraper asks Alibaba for additional details (such as minimum order quantity, attributes, and supplier metadata) and adds them under 'additionalProperties'. Example: enable this to capture minimum order quantity for sourcing research. This adds more data per product at a small extra time cost. Recommended: on for supplier and sourcing analysis, off for the fastest price-and-title-only runs. ## `maxProductResults` (type: `integer`): The maximum total number of products to scrape in one run, across all URLs and keywords combined. The scraper stops once this many products have been saved, so search and listing inputs never run away. Example: 100. Accepts any positive whole number. Lower values cost less and finish faster; leave empty to scrape everything found. Recommended: start with 50 to 100 to preview results before a full run. ## Actor input object example ```json { "detailsUrls": [ { "url": "https://www.alibaba.com/product-detail/Wholesale-750ml-Stainless-Steel-Bottle_1600569797644.html" } ], "listingUrls": [ { "url": "https://www.alibaba.com/trade/search?SearchText=water+bottle" } ], "keyword": "stainless steel water bottle", "additionalProperties": true, "maxProductResults": 50 } ``` # Actor output Schema ## `results` (type: `string`): Scraped Alibaba product details. ## `errors` (type: `string`): URLs or keywords that could not be scraped, with an error code and description. # 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 = { "detailsUrls": [ { "url": "https://www.alibaba.com/product-detail/Wholesale-750ml-Stainless-Steel-Bottle_1600569797644.html" } ], "additionalProperties": true, "maxProductResults": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("e-commerce/alibaba-product-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 = { "detailsUrls": [{ "url": "https://www.alibaba.com/product-detail/Wholesale-750ml-Stainless-Steel-Bottle_1600569797644.html" }], "additionalProperties": True, "maxProductResults": 50, } # Run the Actor and wait for it to finish run = client.actor("e-commerce/alibaba-product-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 '{ "detailsUrls": [ { "url": "https://www.alibaba.com/product-detail/Wholesale-750ml-Stainless-Steel-Bottle_1600569797644.html" } ], "additionalProperties": true, "maxProductResults": 50 }' | apify call e-commerce/alibaba-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=e-commerce/alibaba-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Alibaba Product Scraper", "description": "Scrape Alibaba product data: title, price, supplier, images, rating, and description. Provide product URLs, a search-results URL, or a search keyword. Export to JSON, CSV, or Excel, run via API, schedule runs, or integrate with other tools.", "version": "0.0", "x-build-id": "fd8mcAhPbKZYdTT8Z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/e-commerce~alibaba-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-e-commerce-alibaba-product-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/e-commerce~alibaba-product-scraper/runs": { "post": { "operationId": "runs-sync-e-commerce-alibaba-product-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/e-commerce~alibaba-product-scraper/run-sync": { "post": { "operationId": "run-sync-e-commerce-alibaba-product-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": { "detailsUrls": { "title": "Product detail URLs", "type": "array", "description": "Direct URLs to individual Alibaba product pages. The Alibaba Product Scraper fetches each URL and returns that product's full data: title, price, supplier, images, rating, and description. Example: https://www.alibaba.com/product-detail/Wholesale-750ml-Stainless-Steel-Bottle_1600569797644.html. Accepts Alibaba product (/product-detail/) URLs, with or without https://; put search-results URLs in the field below instead. Use this when you already know exactly which products you want, as it is the fastest and most reliable input.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "listingUrls": { "title": "Search-results / listing URLs", "type": "array", "description": "URLs to Alibaba search-results or listing pages that contain many products. The scraper opens each listing, collects the product URLs it finds (following pagination), then scrapes each product's details. Example: https://www.alibaba.com/trade/search?SearchText=water+bottle. Accepts Alibaba search-results and showroom URLs. Use this to scrape a whole search or category without listing every product URL yourself; pair it with 'Total maximum products' to cap the run.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "keyword": { "title": "Search keyword", "type": "string", "description": "A search term used to find Alibaba products. The scraper runs the search on Alibaba.com, collects the matching product URLs, then scrapes each product's details. Example: stainless steel water bottle. Enter a single search phrase. Use 'Total maximum products' to limit how many results are scraped, since broad B2B searches can return thousands of matches." }, "additionalProperties": { "title": "Include additional properties", "type": "boolean", "description": "Whether to include extra, source-specific product attributes in the output. When enabled, the scraper asks Alibaba for additional details (such as minimum order quantity, attributes, and supplier metadata) and adds them under 'additionalProperties'. Example: enable this to capture minimum order quantity for sourcing research. This adds more data per product at a small extra time cost. Recommended: on for supplier and sourcing analysis, off for the fastest price-and-title-only runs.", "default": false }, "maxProductResults": { "title": "Total maximum products", "minimum": 1, "type": "integer", "description": "The maximum total number of products to scrape in one run, across all URLs and keywords combined. The scraper stops once this many products have been saved, so search and listing inputs never run away. Example: 100. Accepts any positive whole number. Lower values cost less and finish faster; leave empty to scrape everything found. Recommended: start with 50 to 100 to preview results before a full run." } } }, "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 } } } } } } } } } } ```