{
"openapi": "3.0.1",
"info": {
"title": "Alibaba Scraper | Products, Prices and Suppliers",
"description": "Alibaba scraper that turns keyword search into structured supplier data: price range, MOQ, certifications, dispatch time, review scores, and verified or gold supplier badges. No Alibaba account required. Export sourcing and procurement leads to JSON, CSV, or Excel for spreadsheets and pipelines.",
"version": "1.0",
"x-build-id": "lqPT21eYk8HoZ00OA"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/silentflow~alibaba-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-silentflow-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/silentflow~alibaba-scraper/runs": {
"post": {
"operationId": "runs-sync-silentflow-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/silentflow~alibaba-scraper/run-sync": {
"post": {
"operationId": "run-sync-silentflow-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": {
"keywords": {
"title": "🔎 Keywords",
"type": "array",
"description": "What to search on Alibaba.com, one keyword per line, as you would type it in the search bar (wireless earbuds, led strip lights, yoga mat). English keywords match best. Each keyword lists 40 products per page in the order buyers see them, and a common keyword runs to thousands of products.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "🔗 Product or search pages",
"type": "array",
"description": "Alibaba.com addresses pasted from your browser. A product page (alibaba.com/product-detail/..._1601721674813.html) gives one full row with its price tiers, lead times, attributes and supplier figures. A search page (alibaba.com/trade/search?SearchText=yoga+mat, alibaba.com/premium/yoga-mat.html, alibaba.com/showroom/yoga-mat.html) is read like its keyword. Pasted products are delivered whatever the filters.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"maxItems": {
"title": "🔢 Max products",
"minimum": 1,
"type": "integer",
"description": "How many rows to save for the whole run, all keywords together. A page holds 40 products, so 100 reads three pages of one keyword or the first pages of several. Cost scales with the rows delivered, so set it to what you need.",
"default": 100
},
"minPrice": {
"title": "💵 Min price (USD)",
"minimum": 0,
"type": "number",
"description": "Lowest unit price you accept, in US dollars, compared with the product's starting price (2.5). Leave empty for no floor."
},
"maxPrice": {
"title": "💵 Max price (USD)",
"minimum": 0,
"type": "number",
"description": "Highest unit price you accept, in US dollars, compared with the product's starting price (20). Leave empty for no ceiling."
},
"maxMoq": {
"title": "📦 Max MOQ",
"minimum": 0,
"type": "integer",
"description": "Largest minimum order quantity you accept (50 keeps products a supplier sells from 50 units or fewer). Useful to find suppliers open to sample-size orders. Leave empty for no limit."
},
"verifiedSupplierOnly": {
"title": "✅ Verified suppliers only",
"type": "boolean",
"description": "On: keep only products from suppliers holding Alibaba's Verified Supplier badge, whose company was inspected by a third party. Roughly half of the listings pass this filter, so a keyword yields fewer rows per page.",
"default": false
},
"includeDetails": {
"title": "📄 Read product pages",
"type": "boolean",
"description": "On: each product's page is read to add its price tiers by quantity, product attributes (material, function, model number...), category path, production lead times, unit weight and size, the supplier's business type, staff count, on-time delivery rate, response time, orders of the last six months, trade assurance amount and store rating. About one second per product. Alibaba serves product pages to only some connections: a row whose page cannot be read keeps its listing fields, and after a few unreadable pages in a row the run stops asking for them. Off: the listing fields only, fast and always complete.",
"default": false
},
"debugMode": {
"title": "🐞 Debug mode",
"type": "boolean",
"description": "Adds detailed lines to the run log. Leave it off for normal runs.",
"default": false
}
}
},
"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
},
"PROXY_UNBLOCKER_UNITS": {
"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
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}