{ "openapi": "3.0.1", "info": { "title": "Alibaba Scraper | $1 / 1k | All In One", "description": "Extract structured Alibaba product and supplier data including pricing, MOQs, certifications, supplier profiles, and performance signals. Built for enterprise-grade sourcing intelligence, supplier discovery, procurement analysis, and automated data pipelines.", "version": "0.1", "x-build-id": "WrdVuhfEsI7eaVlyt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~alibaba-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-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/fatihtahta~alibaba-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-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/fatihtahta~alibaba-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-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": { "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", "type": "boolean", "description": "Turn this on to visit each product detail page and collect additional `product`, `seller`, `review`, and `description` data from listings. Leave it off for a faster search-results-only run.", "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 } } } } } } } } } }