# Alibaba.com Scraper - Wholesale Products & Supplier Leads (`scrapesage/alibaba-scraper`) Actor Scrape Alibaba.com B2B products by keyword, URL or ID: tiered wholesale (FOB) prices, MOQ, specs, SKU variants, certifications, images, Trade Assurance & supplier/manufacturer leads with firmographics & lead score. Filter, set currency & monitor price drops. - **URL**: https://apify.com/scrapesage/alibaba-scraper.md - **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community) - **Categories:** E-commerce, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 product scrapeds 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/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 ## Alibaba.com Scraper — Products, Wholesale Prices, MOQ, Specs & Supplier Leads Extract **complete Alibaba.com B2B data** — the fields most scrapers leave empty: **tiered wholesale (FOB) ladder prices, minimum order quantity (MOQ), the full SKU/variant matrix, every product spec, certifications, Trade Assurance, packaging & lead times**, and the **complete supplier company profile** (business type, years on Alibaba, employee count, response time, on-time-delivery rate, ratings). Optionally turn every supplier into a **deduplicated sourcing / vetting lead** with a 0–100 lead score. No login, no API key, no browser — fast SSR JSON extraction. ### Why this Alibaba scraper? Most Alibaba scrapers only read the listing cards and return `null` for the data that actually drives a sourcing decision. This actor pulls the full server-side data layer and ships the **richest dataset in the category**: | Data | Typical scrapers | This actor | |---|---|---| | Title, image, product URL | ✅ | ✅ | | Price **range** on the card | partial | ✅ | | **Tiered FOB ladder prices** (qty → unit price) | ❌ | ✅ | | **MOQ** (minimum order quantity) + unit | ❌ | ✅ | | Sold count / sales volume | ❌ | ✅ | | Full **SKU / variant matrix** (color, model…) | ❌ | ✅ | | Every **product attribute / spec** | ❌ | ✅ | | **Certifications** (CE, RoHS, FCC, BQB…) w/ number & validity | ❌ | ✅ | | All images **+ product video** | partial | ✅ | | **Trade Assurance**, packaging, lead times | ❌ | ✅ | | Supplier business type, years, employees | ❌ | ✅ | | Supplier **response time & on-time-delivery rate** | ❌ | ✅ | | Supplier lead score (0–100) | ❌ | ✅ | | Price-drop / MOQ-change **monitor mode** | ❌ | ✅ | ### Use cases - **Product sourcing & dropshipping** — find products by keyword, compare tiered wholesale prices and MOQs across suppliers, and pull every spec, image and certification you need to list a product. - **Supplier discovery & vetting** — score suppliers by tenure, business type (manufacturer vs trading company), on-time-delivery rate, response time, Trade Assurance and ratings before you reach out (`outputSupplierLeads`). - **Pricing & market intelligence** — track FOB price ladders, MOQs and new products by category; benchmark a niche. - **Repricing & monitoring** — schedule recurring runs with **monitor mode** to catch price drops and MOQ changes on the products you care about. - **Lead generation for B2B services** — manufacturers and trading companies on Alibaba are active buyers of logistics, inspection, financing, packaging and marketing services. Score and shortlist them. ### How to use 1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor. 2. Open the **Alibaba.com Scraper**, enter search keywords (or paste Alibaba URLs / product IDs), and click **Start**. 3. Watch results stream into the dataset table. 4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results programmatically via the [Apify API](https://docs.apify.com/api/v2). ### Input ```json { "searchTerms": ["wireless earbuds", "solar panel"], "country": "US", "maxProducts": 100, "includeProductDetails": true, "outputSupplierLeads": true, "maxMoq": 100, "supplierType": "manufacturer", "minRating": "4", "monitorMode": false } ```` - **searchTerms** — keywords, each scraped as its own product feed. - **startUrls** — paste Alibaba.com product pages (`/product-detail/…`), search/category pages (`/trade/search?SearchText=…`) or supplier minisites (`https://.en.alibaba.com/`). - **productIds** — Alibaba product IDs to fetch full detail directly (e.g. `1601295664563`). - **country** *(default `US`)* — localizes prices & currency (US ⇒ USD) and pins the proxy exit country. - **includeProductDetails** *(default false)* — open each product for tiered FOB ladder prices, the full SKU/variant matrix, every spec, certifications, media, packaging, lead times, Trade Assurance and the supplier profile. - **outputSupplierLeads** *(default false)* — also push one deduplicated lead per unique supplier (`type: "supplier"`) with full firmographics and a 0–100 lead score (implies product detail). - **minPrice / maxPrice / maxMoq / supplierType / supplierCountry / minRating / tradeAssuranceOnly** — filters. - **monitorMode** *(default false)* — emit only new or changed products across runs (`changeType`: new / price\_drop / price\_rise / moq\_change). ### Output One record per product (`type: "product"`), plus optional supplier lead records (`type: "supplier"`): ```json { "type": "product", "productId": "1601295664563", "title": "Wholesale Noise Cancelling Bluetooth Earbuds ENC Wireless In-ear Headphones", "url": "https://www.alibaba.com/product-detail/_1601295664563.html", "mainImage": "https://s.alicdn.com/@sc04/kf/H0da009d8...jpg", "priceMin": 5.67, "priceMax": 5.87, "currency": "USD", "priceUnit": "piece", "ladderPrices": [ { "minQty": 10, "maxQty": 99, "price": 5.87, "priceText": "$5.87" }, { "minQty": 100, "maxQty": 999, "price": 5.75, "priceText": "$5.75" }, { "minQty": 1000, "maxQty": null, "price": 5.67, "priceText": "$5.67" } ], "moq": 10, "moqUnit": "pieces", "soldCount": 4612, "rating": 4.8, "reviewCount": 450, "attributes": [ { "name": "BT Wireless", "value": "Bluetooth v5.4" }, { "name": "battery capacity(mah)", "value": "300mAh" }, { "name": "place of origin", "value": "Guangdong, China" } ], "variants": [ { "name": "color", "type": "IMAGE", "options": ["Black", "White"] } ], "certifications": [ { "name": "CE", "number": "LCSA03064052E", "issuedBy": "Other", "validPeriod": "03/17/2024 - 03/17/2029" }, { "name": "RoHS", "number": "LCSA03044055R", "issuedBy": "Other", "validPeriod": "03/06/2024 - 03/06/2029" } ], "mediaImages": ["https://sc04.alicdn.com/kf/H0da009d8...jpg"], "video": { "videoId": "6000289844477", "cover": "https://sc04.alicdn.com/kf/..." }, "tradeAssurance": true, "deliverPlace": "CN", "supplierName": "Guangzhou Langston Electronic Technology Co., Ltd.", "supplierId": "232103615", "supplierUrl": "https://langstoncn.en.alibaba.com/", "supplierCountry": "CN", "supplier": { "businessType": "Manufacturer,Trading Company", "yearsOnAlibaba": 12, "employees": "101-200", "responseTime": "≤4h", "onTimeDeliveryRate": "98.7%", "goldSupplier": true, "verifiedSupplier": true, "tradeAssurance": true, "contactName": "Ms. Zhong", "ratingAvg": 4.8 }, "searchTerm": "wireless earbuds", "scrapedAt": "2026-06-17T12:00:00.000Z" } ``` A supplier lead record (`type: "supplier"`) adds `productsInRun`, `sampleProducts`, `avgProductPrice`, `tradeAssuranceAmount` and a 0–100 `leadScore`. ### Automate & schedule Run this actor on autopilot and pull results into your own stack: - **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, and manage schedules over REST. - **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs. - **[Schedules](https://docs.apify.com/platform/schedules)** — run it hourly/daily/weekly to monitor price drops, MOQ changes or new products in a category; ideal with monitor mode. - **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions (CRM import, Slack alert, repricing job) the moment a run finishes. ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' }); const run = await client.actor('scrapesage/alibaba-scraper').call({ searchTerms: ['stainless steel water bottle'], country: 'US', maxProducts: 100, includeProductDetails: true, outputSupplierLeads: true, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`Got ${items.length} products & supplier leads`); ``` ### Integrate with any app Connect the dataset to 5,000+ apps — no code required: - **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios. - **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new supplier leads straight into your CRM. - **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored product drops in price. - **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet. - **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse. - **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases. ### Use with AI assistants (MCP) The output is clean, LLM-ready JSON. You can call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find low-MOQ stainless steel bottle suppliers on Alibaba with Trade Assurance and list their lead scores" and let it run this scraper for you. ### More scrapers from scrapesage Build a complete **e-commerce sourcing & supplier stack**: - **[AliExpress Scraper](https://apify.com/scrapesage/aliexpress-scraper)** — consumer / dropship products, live prices, orders sold & supplier leads. - **[Made-in-China Scraper](https://apify.com/scrapesage/made-in-china-scraper)** — B2B manufacturers, products & supplier leads. - **[TradeIndia Scraper](https://apify.com/scrapesage/tradeindia-scraper)** — Indian B2B suppliers, products & contact leads. - **[Banggood Scraper](https://apify.com/scrapesage/banggood-scraper)** — cross-border dropship products, prices & reviews. - **[Amazon Scraper](https://apify.com/scrapesage/amazon-scraper)** — products, Buy Box prices, reviews & seller leads. - **[eBay Scraper](https://apify.com/scrapesage/ebay-scraper)** — listings, sold comps & seller leads. - **[ImportYeti Scraper](https://apify.com/scrapesage/importyeti-scraper)** — supplier & shipment / bill-of-lading intelligence. - **[Website Contact Scraper](https://apify.com/scrapesage/website-contact-scraper)** — enrich any supplier minisite with emails, phones & socials. ### Tips - **USD prices**: keep `country` = `US` for prices in USD. Other countries localize to that market's currency; product detail always also exposes USD ladder prices. - **Low-MOQ sourcing**: set `maxMoq` (e.g. 100) to surface suppliers that accept small / sample orders. - **Manufacturers only**: set `supplierType` = `manufacturer` and turn on `includeProductDetails` for accurate business-type firmographics. - **Recurring monitoring**: combine [Schedules](https://docs.apify.com/platform/schedules) with `monitorMode` to track only new or price-changed products. - **Proxies**: keep the default residential proxy group — Alibaba.com challenges datacenter IPs. ### FAQ **How do I scrape Alibaba products for a keyword?** Put the keyword(s) in `searchTerms`. Add `includeProductDetails` for ladder prices, specs, certifications and the supplier profile, and `outputSupplierLeads` to also get one scored lead per supplier. **Does it get tiered wholesale (FOB) prices and MOQ?** Yes — with `includeProductDetails` on, every product carries its full `ladderPrices` array (quantity tier → unit price) and `moq`. **Can I get supplier contact emails?** Alibaba does not publish supplier emails or phones — contact happens through the platform and the supplier's minisite. This actor returns the supplier's minisite URL, contact name, business type and full firmographics; pair it with the [Website Contact Scraper](https://apify.com/scrapesage/website-contact-scraper) to enrich minisites for public contact details. **Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically on every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive). **How do I monitor price drops automatically?** Turn on `monitorMode`, then create a [Schedule](https://docs.apify.com/platform/schedules) (e.g. daily). Each run emits only new or changed products, each tagged with a `changeType` (price\_drop, price\_rise, moq\_change, new). **Is scraping Alibaba.com legal?** This actor collects publicly available data only. You are responsible for using the data in compliance with applicable laws and Alibaba's terms. **A field is null — why?** Some products genuinely don't publish a sold count, video, or certain specs. Fields are `null` only when the data doesn't exist, not because the scraper skipped them. ### Need help? Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained. # Actor input Schema ## `searchTerms` (type: `array`): Keywords to search Alibaba.com for, e.g. wireless earbuds, stainless steel water bottle, solar panel. Each keyword is scraped as its own product feed. Leave empty if you only use Start URLs / Product IDs. ## `startUrls` (type: `array`): Alibaba.com URLs to scrape directly: product pages (/product-detail/...html), search/category pages (/trade/search?SearchText=... or /showroom/...) or supplier minisites (https://\.en.alibaba.com/). Used in addition to the keyword search. ## `productIds` (type: `array`): Alibaba.com product IDs to fetch full product detail for directly (e.g. 1601295664563). Equivalent to pasting their product-detail URLs. ## `minPrice` (type: `integer`): Only keep products whose lowest unit price (in the chosen currency) is at least this much. ## `maxPrice` (type: `integer`): Only keep products whose lowest unit price (in the chosen currency) is at most this much. ## `maxMoq` (type: `integer`): Only keep products whose minimum order quantity is at most this many units — useful for finding low-MOQ suppliers for small / test orders. ## `supplierType` (type: `string`): Keep only products from a given supplier type (best-effort; based on supplier badges). ## `supplierCountry` (type: `string`): Keep only products whose supplier is registered in this ISO country code (e.g. CN, IN, VN, US). Leave blank for all. ## `minRating` (type: `string`): Only keep products with at least this average review score (0–5). Drops new / unrated items when set. ## `tradeAssuranceOnly` (type: `boolean`): Only keep products covered by Alibaba Trade Assurance (order protection). Requires product detail. ## `country` (type: `string`): ISO country code that prices, shipping and availability are localized to (e.g. US, GB, DE, AU). Drives the proxy exit country and the displayed currency. US shows USD. ## `maxProducts` (type: `integer`): Maximum number of product records to scrape across all searches / URLs. Alibaba.com search returns ~48 products per page. ## `includeProductDetails` (type: `boolean`): Open each product to add tiered wholesale (FOB) ladder prices, the full SKU/variant matrix, every product attribute/spec, all images & video, certifications, packaging & lead times, Trade Assurance, and the full supplier company profile. Adds one page fetch per product. ## `outputSupplierLeads` (type: `boolean`): In addition to product records, push one deduplicated lead record per unique supplier (type = "supplier") with company name, business type, country, years on Alibaba, employees, response time, on-time delivery rate, Gold/Verified/Trade-Assurance status, contact name, ratings, sample products and a 0–100 lead score. Implies product detail for the richest firmographics. (Alibaba does not publish supplier emails/phones — contact is via the supplier's minisite & the platform.) ## `deduplicateProducts` (type: `boolean`): Drop duplicate products that appear in more than one search / page in the same run. ## `monitorMode` (type: `boolean`): Remember products across runs in a named key-value store and emit ONLY products that are new OR whose price/MOQ changed since the last run (each carries a changeType: new / price\_drop / price\_rise / moq\_change). Pair with Apify Schedules for price-drop alerts — it complements the scheduler (the schedule starts the run, monitor mode dedupes against prior runs). ## `monitorKey` (type: `string`): Names the monitor's memory store so you can run several independent monitors (e.g. one per keyword). Reuse the same key to keep tracking the same feed. ## `maxConcurrency` (type: `integer`): Parallel page fetches. Keep low (2–4) so Alibaba's anti-bot doesn't challenge the proxy. ## `proxyConfiguration` (type: `object`): Proxies to use. Residential proxies are strongly recommended — Alibaba.com challenges datacenter IPs. Fresh residential sessions per request, primed with a homepage visit, stay ungated. ## Actor input object example ```json { "searchTerms": [ "wireless earbuds" ], "supplierType": "any", "minRating": "0", "tradeAssuranceOnly": false, "country": "US", "maxProducts": 100, "includeProductDetails": false, "outputSupplierLeads": false, "deduplicateProducts": true, "monitorMode": false, "monitorKey": "default", "maxConcurrency": 3, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): All scraped Alibaba.com product records and optional supplier/manufacturer lead records as JSON items in the default dataset. # 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 = { "searchTerms": [ "wireless earbuds" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapesage/alibaba-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 = { "searchTerms": ["wireless earbuds"], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("scrapesage/alibaba-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 '{ "searchTerms": [ "wireless earbuds" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call scrapesage/alibaba-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapesage/alibaba-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Alibaba.com Scraper - Wholesale Products & Supplier Leads", "description": "Scrape Alibaba.com B2B products by keyword, URL or ID: tiered wholesale (FOB) prices, MOQ, specs, SKU variants, certifications, images, Trade Assurance & supplier/manufacturer leads with firmographics & lead score. Filter, set currency & monitor price drops.", "version": "0.1", "x-build-id": "zEp589uOlVvvC2u1S" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~alibaba-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-alibaba-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/scrapesage~alibaba-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-alibaba-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/scrapesage~alibaba-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-alibaba-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": { "searchTerms": { "title": "Search keywords", "type": "array", "description": "Keywords to search Alibaba.com for, e.g. wireless earbuds, stainless steel water bottle, solar panel. Each keyword is scraped as its own product feed. Leave empty if you only use Start URLs / Product IDs.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Alibaba.com URLs to scrape directly: product pages (/product-detail/...html), search/category pages (/trade/search?SearchText=... or /showroom/...) or supplier minisites (https://<name>.en.alibaba.com/). Used in addition to the keyword search.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "productIds": { "title": "Product IDs (direct detail)", "type": "array", "description": "Alibaba.com product IDs to fetch full product detail for directly (e.g. 1601295664563). Equivalent to pasting their product-detail URLs.", "items": { "type": "string" } }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Only keep products whose lowest unit price (in the chosen currency) is at least this much." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Only keep products whose lowest unit price (in the chosen currency) is at most this much." }, "maxMoq": { "title": "Max MOQ (minimum order quantity)", "minimum": 1, "type": "integer", "description": "Only keep products whose minimum order quantity is at most this many units — useful for finding low-MOQ suppliers for small / test orders." }, "supplierType": { "title": "Supplier type", "enum": [ "any", "manufacturer", "tradingCompany", "verified", "goldSupplier" ], "type": "string", "description": "Keep only products from a given supplier type (best-effort; based on supplier badges).", "default": "any" }, "supplierCountry": { "title": "Supplier country", "type": "string", "description": "Keep only products whose supplier is registered in this ISO country code (e.g. CN, IN, VN, US). Leave blank for all." }, "minRating": { "title": "Min product rating", "enum": [ "0", "3", "3.5", "4", "4.5" ], "type": "string", "description": "Only keep products with at least this average review score (0–5). Drops new / unrated items when set.", "default": "0" }, "tradeAssuranceOnly": { "title": "Trade Assurance only", "type": "boolean", "description": "Only keep products covered by Alibaba Trade Assurance (order protection). Requires product detail.", "default": false }, "country": { "title": "Localize to country", "type": "string", "description": "ISO country code that prices, shipping and availability are localized to (e.g. US, GB, DE, AU). Drives the proxy exit country and the displayed currency. US shows USD.", "default": "US" }, "maxProducts": { "title": "Max products", "minimum": 1, "type": "integer", "description": "Maximum number of product records to scrape across all searches / URLs. Alibaba.com search returns ~48 products per page.", "default": 100 }, "includeProductDetails": { "title": "Include full product detail", "type": "boolean", "description": "Open each product to add tiered wholesale (FOB) ladder prices, the full SKU/variant matrix, every product attribute/spec, all images & video, certifications, packaging & lead times, Trade Assurance, and the full supplier company profile. Adds one page fetch per product.", "default": false }, "outputSupplierLeads": { "title": "Emit supplier / manufacturer lead records", "type": "boolean", "description": "In addition to product records, push one deduplicated lead record per unique supplier (type = \"supplier\") with company name, business type, country, years on Alibaba, employees, response time, on-time delivery rate, Gold/Verified/Trade-Assurance status, contact name, ratings, sample products and a 0–100 lead score. Implies product detail for the richest firmographics. (Alibaba does not publish supplier emails/phones — contact is via the supplier's minisite & the platform.)", "default": false }, "deduplicateProducts": { "title": "Deduplicate products", "type": "boolean", "description": "Drop duplicate products that appear in more than one search / page in the same run.", "default": true }, "monitorMode": { "title": "Monitor mode (only new / changed)", "type": "boolean", "description": "Remember products across runs in a named key-value store and emit ONLY products that are new OR whose price/MOQ changed since the last run (each carries a changeType: new / price_drop / price_rise / moq_change). Pair with Apify Schedules for price-drop alerts — it complements the scheduler (the schedule starts the run, monitor mode dedupes against prior runs).", "default": false }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "Names the monitor's memory store so you can run several independent monitors (e.g. one per keyword). Reuse the same key to keep tracking the same feed.", "default": "default" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 8, "type": "integer", "description": "Parallel page fetches. Keep low (2–4) so Alibaba's anti-bot doesn't challenge the proxy.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxies to use. Residential proxies are strongly recommended — Alibaba.com challenges datacenter IPs. Fresh residential sessions per request, primed with a homepage visit, stay ungated.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```