# Alibaba Scraper | Enterprise Grade (`scrapers-hub/alibaba-pro-search-scraper`) Actor Alibaba Pro Search scraper to extract supplier profiles, product listings, company details, contact information, certifications, locations, and ratings from Alibaba Pro Search 📦🏭 Perfect for B2B sourcing, supplier discovery, market research, competitor analysis, and wholesale lead generation. - **URL**: https://apify.com/scrapers-hub/alibaba-pro-search-scraper.md - **Developed by:** [Scrapers Hub](https://apify.com/scrapers-hub) (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 $1.99 / 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. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Alibaba.com Pro-Search Scraper Apify actor that scrapes **Alibaba.com AI / pro-search** product offers for one or more keywords and returns rich, namespaced records (title, pricing, MOQ, supplier, media, certifications, tracking, and the full raw offer). ### How it works (reverse-engineered) Pro-search data is **not** in the page HTML. The actor reproduces the browser's 3-hop handshake: 1. `GET /search/page?...` → read `__icbu_search_intention_id`. 2. `GET /search/ai/api?...` (SSE stream) → read the `asyncService` params for the `proTextSearch` service. 3. `GET /search/api/proTextSearch?...&page=N` → the real `model.offers[]` JSON. **Stack:** `requests` first; automatic fallback to `curl_cffi` (TLS/JA3 impersonation) when a response looks blocked (challenge page / 403 / empty). `parsel` + `regex` clean the HTML that Alibaba embeds in some titles, parse the price string, and (optionally) scrape detail pages. ### Pricing / currency Prices are driven by the **exit-IP country**, so the actor pins an Apify RESIDENTIAL proxy to `shipping_to` (e.g. `US` → `$`). The proxy username is built by hand (`groups-RESIDENTIAL,country-XX,session-...`) because `create_proxy_configuration` can silently return datacenter IPs on some plans. ### Input | Field | Type | Notes | |---|---|---| | `queries` | array | Keywords, one search each. **Required.** | | `limit` | int | Max offers per query (default 20). | | `shipping_to` | string | Buyer country code → pricing currency (default `US`). | | `enrich_data` | bool | Also fetch detail pages (description/specs/JSON-LD). | | `ta` / `supplier_tradeAssurance` | bool | Trade Assurance only (`ta=y`). | | `verifiedPro` / `supplier_verifiedProSupplier` | bool | Verified Pro suppliers (`verifiedPro=1`). | | `assessmentCompany` / `supplier_verifiedSupplier` | bool | Verified/assessed suppliers (`assessmentCompany=true`). | | `supplier_manufacturersOnly` | bool | Manufacturers only. | Filter param names were verified live against the search response `filterData.queryKey` fields. ### Output One dataset item per offer, e.g.: ```jsonc { "title": "Portable Air Purifier H13 ...", "imageUrl": "https://s.alicdn.com/...jpg", "pricing": { "price": "$22.80-29.90", "priceNumeric": 22.8, "currency": "$", "moq": "Min. order: 2 pieces" }, "product": { "productId": "1601600586097", "productUrl": "https://www.alibaba.com/product-detail/...html", ... }, "product_supplier": { "companyName": "...", "reviewScore": "5.0", ... }, "product_media": { "multiImage": ["..."] }, "product_certifications": { "certifications": [ ... ] }, "product_raw_offer": { /* full untouched offer */ }, "metadata": { "id": "...", "seedValue": "Air Purifier", "scrapedTime": "...Z", "pageIndex": 1, "domain": "alibaba.com" } } ```` ### Run ```bash apify run # local (needs APIFY_PROXY_PASSWORD for $ pricing) ``` Or push to the Apify platform and run with the input schema UI. # Actor input Schema ## `queries` (type: `array`): Enter one or more product keywords or phrases to search on Alibaba. Each query is automatically converted into a product search URL before scraping starts. ## `enrich_data` (type: `boolean`): Product detail enrichment is temporarily under maintenance. Even if this is enabled, the actor will use the regular search-results-only flow and will not visit product detail pages for extra enrichment data. ## `country` (type: `array`): Optionally limit product search results to suppliers located in specific countries. Select one or more countries. ## `moqt` (type: `integer`): Only include listings whose minimum order quantity is at least this number. Use this to only get suppliers that accept very small orders. ## `min_price` (type: `number`): Exclude listings priced below this amount. ## `max_price` (type: `number`): Exclude listings priced above this amount. ## `productAuthTag` (type: `array`): Limit results to products that advertise one or more selected certifications, such as CE or RoHS. ## `categoryId` (type: `integer`): Optionally restrict the search to a specific Alibaba category by entering its numeric category ID. This helps keep results tightly focused within one product category. ## `productTag` (type: `string`): Optionally apply an Alibaba internal product tag ID, such as `8000003589011`, to narrow results using Alibaba's own tagging system. ## `reviewScore` (type: `string`): Set the minimum supplier review score required for product search results. Higher values narrow the results to suppliers with stronger review ratings. ## `assessmentCompany` (type: `boolean`): Turn this on to keep only suppliers that Alibaba marks as audited or assessed by Alibaba or an approved third party. ## `ta` (type: `boolean`): Turn this on to show only suppliers that participate in Alibaba Trade Assurance for added order protection. ## `verifiedPro` (type: `boolean`): Turn this on to limit results to suppliers that Alibaba marks as verified. ## `supplier_queries` (type: `array`): Enter one or more supplier-focused keywords or phrases to search Alibaba suppliers directly. Each query is automatically converted into a supplier search URL before scraping starts. ## `supplier_manufacturersOnly` (type: `boolean`): Turn this on to limit supplier search results to companies Alibaba flags as verified manufacturer. ## `supplier_country` (type: `array`): Optionally limit supplier search results to suppliers located in selected countries. Choose one or more countries. ## `supplier_rating` (type: `string`): Optional filter to set the minimum star rating suppliers must have to appear in supplier search results. ## `supplier_years_on_alibaba` (type: `string`): Only include suppliers that have been active on Alibaba for at least the selected number of years. This can help focus on more established suppliers. ## `supplier_moqt` (type: `integer`): Only include supplier search results whose minimum order quantity is at least this value. ## `supplier_reorderRate` (type: `string`): Set the minimum reorder rate suppliers must meet to appear in supplier search results. Higher thresholds favor suppliers with stronger repeat-order behavior. ## `supplier_responseTime` (type: `string`): Set the maximum response time suppliers should have to appear in results. Faster response-time filters help surface more responsive suppliers. ## `supplier_onTimeDelivery` (type: `string`): Set the minimum on-time delivery rate suppliers must meet to appear in supplier search results. Higher thresholds prioritize more reliable delivery performance. ## `supplier_tradeAssurance` (type: `boolean`): Turn this on to keep only supplier search results from suppliers that offer Alibaba Trade Assurance. ## `supplier_verifiedSupplier` (type: `boolean`): Turn this on to keep only supplier search results where Alibaba applies the assessed verified supplier filter. ## `supplier_verifiedProSupplier` (type: `boolean`): Turn this on to keep only supplier search results where Alibaba applies the filter for Verified Pro suppliers. ## `shipping_to` (type: `string`): Select the country the items should ship to. Alibaba requires this for both product and supplier searches, and it also controls the localized pricing, currency, and item availability shown in results. ## `limit` (type: `integer`): Choose the maximum number of records to save for each individual URL or query seed. Leave this empty if you want to collect every available listing. ## Actor input object example ```json { "queries": [ "Air Purifier" ], "enrich_data": false, "shipping_to": "US", "limit": 20 } ``` # 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 = { "queries": [ "Air Purifier" ], "limit": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("scrapers-hub/alibaba-pro-search-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 = { "queries": ["Air Purifier"], "limit": 20, } # Run the Actor and wait for it to finish run = client.actor("scrapers-hub/alibaba-pro-search-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 '{ "queries": [ "Air Purifier" ], "limit": 20 }' | apify call scrapers-hub/alibaba-pro-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapers-hub/alibaba-pro-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Alibaba Scraper | Enterprise Grade", "description": "Alibaba Pro Search scraper to extract supplier profiles, product listings, company details, contact information, certifications, locations, and ratings from Alibaba Pro Search 📦🏭 Perfect for B2B sourcing, supplier discovery, market research, competitor analysis, and wholesale lead generation.", "version": "0.1", "x-build-id": "LQuk0Pjat2iRudnaJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers-hub~alibaba-pro-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers-hub-alibaba-pro-search-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/scrapers-hub~alibaba-pro-search-scraper/runs": { "post": { "operationId": "runs-sync-scrapers-hub-alibaba-pro-search-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/scrapers-hub~alibaba-pro-search-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers-hub-alibaba-pro-search-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": { "queries": { "title": "🔎 Add product search queries", "type": "array", "description": "Enter one or more product keywords or phrases to search on Alibaba. Each query is automatically converted into a product search URL before scraping starts.", "items": { "type": "string" } }, "enrich_data": { "title": "📄 Enrich results with full product data (temporarily unavailable)", "type": "boolean", "description": "Product detail enrichment is temporarily under maintenance. Even if this is enabled, the actor will use the regular search-results-only flow and will not visit product detail pages for extra enrichment data.", "default": false }, "country": { "title": "🌍 Filter suppliers by country", "uniqueItems": true, "type": "array", "description": "Optionally limit product search results to suppliers located in specific countries. Select one or more countries.", "items": { "type": "string", "enum": [ "AR", "AU", "AT", "BD", "BE", "BR", "KH", "CA", "CL", "CN", "CO", "CZ", "DK", "EG", "FI", "FR", "DE", "GR", "HK", "HU", "IN", "ID", "IT", "JP", "KR", "MY", "MX", "MA", "NP", "NL", "NZ", "PK", "PE", "PH", "PL", "PT", "RO", "SA", "SG", "ZA", "ES", "LK", "SE", "CH", "TW", "TH", "TN", "TR", "AE", "GB", "US", "VN" ], "enumTitles": [ "🇦🇷 Argentina", "🇦🇺 Australia", "🇦🇹 Austria", "🇧🇩 Bangladesh", "🇧🇪 Belgium", "🇧🇷 Brazil", "🇰🇭 Cambodia", "🇨🇦 Canada", "🇨🇱 Chile", "🇨🇳 China", "🇨🇴 Colombia", "🇨🇿 Czech Republic", "🇩🇰 Denmark", "🇪🇬 Egypt", "🇫🇮 Finland", "🇫🇷 France", "🇩🇪 Germany", "🇬🇷 Greece", "🇭🇰 Hong Kong SAR", "🇭🇺 Hungary", "🇮🇳 India", "🇮🇩 Indonesia", "🇮🇹 Italy", "🇯🇵 Japan", "🇰🇷 South Korea", "🇲🇾 Malaysia", "🇲🇽 Mexico", "🇲🇦 Morocco", "🇳🇵 Nepal", "🇳🇱 Netherlands", "🇳🇿 New Zealand", "🇵🇰 Pakistan", "🇵🇪 Peru", "🇵🇭 Philippines", "🇵🇱 Poland", "🇵🇹 Portugal", "🇷🇴 Romania", "🇸🇦 Saudi Arabia", "🇸🇬 Singapore", "🇿🇦 South Africa", "🇪🇸 Spain", "🇱🇰 Sri Lanka", "🇸🇪 Sweden", "🇨🇭 Switzerland", "🇹🇼 Taiwan", "🇹🇭 Thailand", "🇹🇳 Tunisia", "🇹🇷 Turkey", "🇦🇪 United Arab Emirates", "🇬🇧 United Kingdom", "🇺🇸 United States", "🇻🇳 Vietnam" ] } }, "moqt": { "title": "📦 Set a minimum order quantity (MOQ)", "minimum": 1, "type": "integer", "description": "Only include listings whose minimum order quantity is at least this number. Use this to only get suppliers that accept very small orders." }, "min_price": { "title": "💵 Set a minimum price", "minimum": 0, "type": "number", "description": "Exclude listings priced below this amount." }, "max_price": { "title": "💸 Set a maximum price", "minimum": 0, "type": "number", "description": "Exclude listings priced above this amount." }, "productAuthTag": { "title": "📜 Filter by product certifications", "uniqueItems": true, "type": "array", "description": "Limit results to products that advertise one or more selected certifications, such as CE or RoHS.", "items": { "type": "string", "enum": [ "BIS", "CB", "CCC", "CE", "CPC", "CQC", "CSA", "EAC", "EMC", "ENERGY-STAR", "ETL", "FCC", "FSC", "GS", "IC", "KC", "PSE", "RCM", "ROHS", "SAA", "TELEC", "TUV MARK", "TUV SUD MARK", "UKCA", "UL", "VDE" ], "enumTitles": [ "BIS", "CB", "CCC", "CE", "CPC", "CQC", "CSA", "EAC", "EMC", "Energy Star", "ETL", "FCC", "FSC", "GS", "IC", "KC", "PSE", "RCM", "RoHS", "SAA", "TELEC", "TUV Mark", "TUV SUD Mark", "UKCA", "UL", "VDE" ] } }, "categoryId": { "title": "🗂️ Lock search to a category ID", "type": "integer", "description": "Optionally restrict the search to a specific Alibaba category by entering its numeric category ID. This helps keep results tightly focused within one product category." }, "productTag": { "title": "🏷️ Filter by Alibaba product tag", "type": "string", "description": "Optionally apply an Alibaba internal product tag ID, such as `8000003589011`, to narrow results using Alibaba's own tagging system." }, "reviewScore": { "title": "⭐ Filter by minimum review score", "enum": [ "4~", "4.5~", "5~" ], "type": "string", "description": "Set the minimum supplier review score required for product search results. Higher values narrow the results to suppliers with stronger review ratings." }, "assessmentCompany": { "title": "✅ Show assessed suppliers only", "type": "boolean", "description": "Turn this on to keep only suppliers that Alibaba marks as audited or assessed by Alibaba or an approved third party." }, "ta": { "title": "🛡️ Show Trade Assurance suppliers only", "type": "boolean", "description": "Turn this on to show only suppliers that participate in Alibaba Trade Assurance for added order protection." }, "verifiedPro": { "title": "✔️ Show verified suppliers only", "type": "boolean", "description": "Turn this on to limit results to suppliers that Alibaba marks as verified." }, "supplier_queries": { "title": "🏭 Add supplier search queries", "type": "array", "description": "Enter one or more supplier-focused keywords or phrases to search Alibaba suppliers directly. Each query is automatically converted into a supplier search URL before scraping starts.", "items": { "type": "string" } }, "supplier_manufacturersOnly": { "title": "🏗️ Show manufacturers only", "type": "boolean", "description": "Turn this on to limit supplier search results to companies Alibaba flags as verified manufacturer." }, "supplier_country": { "title": "🌍 Filter supplier search by country", "uniqueItems": true, "type": "array", "description": "Optionally limit supplier search results to suppliers located in selected countries. Choose one or more countries.", "items": { "type": "string", "enum": [ "AR", "AU", "AT", "BD", "BE", "BR", "KH", "CA", "CL", "CN", "CO", "CZ", "DK", "EG", "FI", "FR", "DE", "GR", "HK", "HU", "IN", "ID", "IT", "JP", "KR", "MY", "MX", "MA", "NP", "NL", "NZ", "PK", "PE", "PH", "PL", "PT", "RO", "SA", "SG", "ZA", "ES", "LK", "SE", "CH", "TW", "TH", "TN", "TR", "AE", "GB", "US", "VN" ], "enumTitles": [ "🇦🇷 Argentina", "🇦🇺 Australia", "🇦🇹 Austria", "🇧🇩 Bangladesh", "🇧🇪 Belgium", "🇧🇷 Brazil", "🇰🇭 Cambodia", "🇨🇦 Canada", "🇨🇱 Chile", "🇨🇳 China", "🇨🇴 Colombia", "🇨🇿 Czech Republic", "🇩🇰 Denmark", "🇪🇬 Egypt", "🇫🇮 Finland", "🇫🇷 France", "🇩🇪 Germany", "🇬🇷 Greece", "🇭🇰 Hong Kong SAR", "🇭🇺 Hungary", "🇮🇳 India", "🇮🇩 Indonesia", "🇮🇹 Italy", "🇯🇵 Japan", "🇰🇷 South Korea", "🇲🇾 Malaysia", "🇲🇽 Mexico", "🇲🇦 Morocco", "🇳🇵 Nepal", "🇳🇱 Netherlands", "🇳🇿 New Zealand", "🇵🇰 Pakistan", "🇵🇪 Peru", "🇵🇭 Philippines", "🇵🇱 Poland", "🇵🇹 Portugal", "🇷🇴 Romania", "🇸🇦 Saudi Arabia", "🇸🇬 Singapore", "🇿🇦 South Africa", "🇪🇸 Spain", "🇱🇰 Sri Lanka", "🇸🇪 Sweden", "🇨🇭 Switzerland", "🇹🇼 Taiwan", "🇹🇭 Thailand", "🇹🇳 Tunisia", "🇹🇷 Turkey", "🇦🇪 United Arab Emirates", "🇬🇧 United Kingdom", "🇺🇸 United States", "🇻🇳 Vietnam" ] } }, "supplier_rating": { "title": "⭐ Filter by minimum supplier rating", "enum": [ "4~", "4.5~", "5~" ], "type": "string", "description": "Optional filter to set the minimum star rating suppliers must have to appear in supplier search results." }, "supplier_years_on_alibaba": { "title": "📅 Filter by years on Alibaba", "enum": [ "~5", "~10", "~15" ], "type": "string", "description": "Only include suppliers that have been active on Alibaba for at least the selected number of years. This can help focus on more established suppliers." }, "supplier_moqt": { "title": "📦 Set a supplier minimum order quantity", "minimum": 1, "type": "integer", "description": "Only include supplier search results whose minimum order quantity is at least this value." }, "supplier_reorderRate": { "title": "🔁 Filter by supplier reorder rate", "enum": [ "0.15~", "0.3~", "0.5~" ], "type": "string", "description": "Set the minimum reorder rate suppliers must meet to appear in supplier search results. Higher thresholds favor suppliers with stronger repeat-order behavior." }, "supplier_responseTime": { "title": "⏱️ Filter by supplier response time", "enum": [ "~240", "~120", "~60" ], "type": "string", "description": "Set the maximum response time suppliers should have to appear in results. Faster response-time filters help surface more responsive suppliers." }, "supplier_onTimeDelivery": { "title": "🚚 Filter by on-time delivery rate", "enum": [ "0.9~", "0.95~", "1~" ], "type": "string", "description": "Set the minimum on-time delivery rate suppliers must meet to appear in supplier search results. Higher thresholds prioritize more reliable delivery performance." }, "supplier_tradeAssurance": { "title": "🛡️ Require supplier Trade Assurance", "type": "boolean", "description": "Turn this on to keep only supplier search results from suppliers that offer Alibaba Trade Assurance." }, "supplier_verifiedSupplier": { "title": "✅ Require verified suppliers", "type": "boolean", "description": "Turn this on to keep only supplier search results where Alibaba applies the assessed verified supplier filter." }, "supplier_verifiedProSupplier": { "title": "🏅 Require Verified Pro suppliers", "type": "boolean", "description": "Turn this on to keep only supplier search results where Alibaba applies the filter for Verified Pro suppliers." }, "shipping_to": { "title": "📍 Choose the shipping destination country", "enum": [ "AD", "AE", "AF", "AG", "AL", "AM", "AO", "AR", "AT", "AU", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI", "BJ", "BN", "BO", "BR", "BS", "BT", "BW", "BY", "BZ", "CA", "CD", "CF", "CG", "CH", "CI", "CL", "CM", "CN", "CO", "CR", "CU", "CV", "CY", "CZ", "DE", "DJ", "DK", "DM", "DO", "DZ", "EC", "EE", "EG", "ER", "ES", "ET", "FI", "FJ", "FR", "GA", "GB", "GD", "GE", "GH", "GM", "GN", "GQ", "GR", "GT", "GW", "GY", "HK", "HN", "HR", "HT", "HU", "ID", "IE", "IL", "IN", "IQ", "IR", "IS", "IT", "JM", "JO", "JP", "KE", "KG", "KH", "KM", "KN", "KR", "KW", "KZ", "LA", "LB", "LC", "LI", "LK", "LR", "LS", "LT", "LU", "LV", "LY", "MA", "MC", "MD", "ME", "MG", "MK", "ML", "MM", "MN", "MO", "MR", "MT", "MU", "MV", "MW", "MX", "MY", "MZ", "NA", "NE", "NG", "NI", "NL", "NO", "NP", "NZ", "OM", "PA", "PE", "PG", "PH", "PK", "PL", "PR", "PS", "PT", "PY", "QA", "RO", "RS", "RU", "RW", "SA", "SB", "SC", "SD", "SE", "SG", "SI", "SK", "SL", "SM", "SN", "SO", "SR", "SS", "ST", "SV", "SY", "SZ", "TD", "TG", "TH", "TJ", "TL", "TM", "TN", "TO", "TR", "TT", "TW", "TZ", "UA", "UG", "US", "UY", "UZ", "VA", "VC", "VE", "VN", "VU", "WS", "XK", "YE", "ZA", "ZM", "ZW" ], "type": "string", "description": "Select the country the items should ship to. Alibaba requires this for both product and supplier searches, and it also controls the localized pricing, currency, and item availability shown in results.", "default": "US" }, "limit": { "title": "🔢 Set the maximum items per seed", "minimum": 1, "type": "integer", "description": "Choose the maximum number of records to save for each individual URL or query seed. Leave this empty if you want to collect every available listing." } } }, "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 } } } } } } } } } } ```