{
"openapi": "3.0.1",
"info": {
"title": "Alibaba Products Scraper",
"description": "Scrape Alibaba search results by keyword or search URL: title, price range and quantity price tiers, minimum order, images, certifications, delivery estimate, and the supplier's country, years, rating, response rate and badges. Up to 4,800 products per keyword, with price and MOQ filters.",
"version": "0.1",
"x-build-id": "vmalb4MVo8LA9QuFh"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/blueskyscraper~alibaba-products-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-blueskyscraper-alibaba-products-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/blueskyscraper~alibaba-products-scraper/runs": {
"post": {
"operationId": "runs-sync-blueskyscraper-alibaba-products-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/blueskyscraper~alibaba-products-scraper/run-sync": {
"post": {
"operationId": "run-sync-blueskyscraper-alibaba-products-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": {
"mode": {
"title": "🧭 What to get",
"enum": [
"products"
],
"type": "string",
"description": "Products — Alibaba search results: title, price and quantity price tiers, minimum order, supplier with years, country, rating and response rate. Product details — the full product page: specifications, variants, lead time, sample price, sold count, supplier contact. Suppliers — one row per company selling a product. Buying requests — RFQs posted by buyers: product, quantity, country.",
"default": "products"
},
"keywords": {
"title": "🔍 Search keywords",
"type": "array",
"description": "What you would type into the Alibaba search box: yoga mat, led strip light, custom t-shirt. Each keyword is one search.",
"items": {
"type": "string"
}
},
"productUrls": {
"title": "🔗 Product URLs or IDs",
"type": "array",
"description": "Product pages for Product details: https://www.alibaba.com/product-detail/_1601617846699.html or just the ID 1601617846699.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "🔗 Alibaba URLs",
"type": "array",
"description": "Any alibaba.com link, routed automatically: a search results page with your filters (alibaba.com/trade/search?SearchText=…), a product page, or a buying-requests search on sourcing.alibaba.com.",
"items": {
"type": "string"
}
},
"maxResultsPerInput": {
"title": "💯 Results per keyword or URL",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "Cap for each keyword or URL, not for the whole run. Alibaba shows up to 4,800 products per search (100 pages of 48).",
"default": 50
},
"minPrice": {
"title": "💲 Minimum price (USD)",
"minimum": 0,
"type": "number",
"description": "Alibaba's own price filter."
},
"maxPrice": {
"title": "💲 Maximum price (USD)",
"minimum": 0,
"type": "number",
"description": "Alibaba's own price filter."
},
"maxMinOrder": {
"title": "📦 Minimum order at most",
"minimum": 0,
"type": "integer",
"description": "Only products you can order in this quantity or less — e.g. 10 for small test orders."
},
"supplierCountries": {
"title": "🌍 Supplier countries",
"type": "array",
"description": "Two-letter codes: CN, IN, VN, TR, PK, US. One code uses Alibaba's filter; several are filtered row by row. Empty = all.",
"items": {
"type": "string"
}
},
"tradeAssuranceOnly": {
"title": "🛡️ Trade Assurance only",
"type": "boolean",
"description": "Suppliers covered by Alibaba Trade Assurance.",
"default": false
},
"verifiedSupplierOnly": {
"title": "✅ Verified suppliers only",
"type": "boolean",
"description": "Suppliers inspected by a third party (Alibaba's Verified Supplier badge).",
"default": false
},
"verifiedProOnly": {
"title": "⭐ Verified Pro suppliers only",
"type": "boolean",
"description": "Alibaba's highest supplier tier.",
"default": false
},
"minSupplierRating": {
"title": "⭐ Minimum supplier rating",
"minimum": 0,
"maximum": 5,
"type": "number",
"description": "Store rating out of 5, e.g. 4.5."
},
"sortBy": {
"title": "↕️ Order",
"enum": [
"bestMatch",
"responseRate"
],
"type": "string",
"description": "Alibaba's Best match, or suppliers who answer fastest first.",
"default": "bestMatch"
},
"excludeAds": {
"title": "🚫 Skip sponsored listings",
"type": "boolean",
"description": "Leave out products placed by paid ads (marked isAd). Skipped rows are free.",
"default": false
},
"includeDetails": {
"title": "📋 Open each product page ($0.003 instead of $0.001)",
"type": "boolean",
"description": "Products mode: one full product-page row per result — specifications, variants, lead time, sample price, sold count, supplier contact person — billed as a product page.",
"default": false
},
"maxItems": {
"title": "Maximum rows per run",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Stop after this many rows in the whole run — a hard ceiling on cost.",
"default": 10000
},
"monitoringStoreName": {
"title": "🔔 Monitoring mode — store name",
"type": "string",
"description": "Give the run a name (e.g. new-yoga-mats) and every later run with the same name returns only rows it has not delivered before — new products, new suppliers, new buying requests. Schedule it daily. Empty = normal 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
},
"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
}
}
}
}
}
}
}
}
}
}