{
"openapi": "3.0.1",
"info": {
"title": "Alibaba Products & Suppliers Scraper - Prices, MOQ & KPIs",
"description": "Scrape Alibaba.com products and suppliers: tiered prices, MOQ, specs, SKUs, lead times, on-time delivery, 6-month orders. Export CSV, Excel, JSON or XML.",
"version": "0.1",
"x-build-id": "ftlabEImnamhgEtby"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/parseforge~alibaba-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-parseforge-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/parseforge~alibaba-scraper/runs": {
"post": {
"operationId": "runs-sync-parseforge-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/parseforge~alibaba-scraper/run-sync": {
"post": {
"operationId": "run-sync-parseforge-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 terms",
"type": "array",
"description": "Products to search for on Alibaba.com, e.g. yoga mat, cnc machine, led strip. Each term is searched separately. Leave empty and pick a Category to browse a whole category.",
"items": {
"type": "string"
}
},
"productUrls": {
"title": "Product URLs",
"type": "array",
"description": "Alibaba.com product pages to scrape directly, e.g. https://www.alibaba.com/product-detail/..._1601617846699.html. Each URL returns one fully detailed row.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
},
"resultType": {
"title": "Result type",
"enum": [
"products",
"suppliers"
],
"type": "string",
"description": "Products: one row per product with its supplier. Suppliers: one row per unique supplier found by the search, with how many of its products matched.",
"default": "products"
},
"includeDetails": {
"title": "Include product details",
"type": "boolean",
"description": "Open each product page to add attributes, SKU options, lead times, package size, sample price, video, full gallery, category path and supplier performance (on-time delivery, response time, 6-month orders and revenue, store rating). Slower, but much richer. In Suppliers mode it opens one product page per supplier.",
"default": true
},
"excludeSponsored": {
"title": "Exclude sponsored listings",
"type": "boolean",
"description": "Skip paid (sponsored) placements and keep only organic results. Sponsored rows are always flagged in the sponsored field.",
"default": false
},
"categoryId": {
"title": "Category",
"enum": [
"",
"2",
"3",
"202014504",
"66",
"2829",
"201943703",
"13",
"44",
"5",
"502",
"41",
"1503",
"17",
"100002908",
"15",
"6",
"43",
"36",
"39",
"1524",
"201725504",
"23",
"26",
"201951502",
"201946504",
"201723202",
"9",
"201726502",
"30",
"21",
"28",
"322",
"18",
"202240208",
"201734802",
"1420",
"34",
"201275273"
],
"type": "string",
"description": "Limit results to an Alibaba.com category. With no search terms, browses the whole category.",
"default": ""
},
"supplierCountry": {
"title": "Supplier location",
"enum": [
"",
"CN",
"IN",
"VN",
"TR",
"PK",
"US",
"AU",
"AT",
"BD",
"BE",
"BR",
"BG",
"KH",
"CA",
"CO",
"CZ",
"DK",
"EG",
"FI",
"FR",
"DE",
"GR",
"HK",
"HU",
"ID",
"IE",
"IL",
"IT",
"JP",
"JO",
"KZ",
"KE",
"MY",
"MX",
"MA",
"MM",
"NP",
"NL",
"NZ",
"NG",
"PE",
"PH",
"PL",
"PT",
"RO",
"RU",
"SA",
"SG",
"ZA",
"KR",
"ES",
"LK",
"CH",
"TW",
"TH",
"TN",
"UA",
"AE",
"UK",
"UZ"
],
"type": "string",
"description": "Only products from suppliers located in this country or region.",
"default": ""
},
"sortBy": {
"title": "Sort by",
"enum": [
"relevance",
"responseRate",
"transactionLevel"
],
"type": "string",
"description": "Best match is Alibaba's default. Response rate puts suppliers that answer every inquiry first. Transaction level puts established, high-volume suppliers first.",
"default": "relevance"
},
"minPrice": {
"title": "Min price (USD)",
"minimum": 0,
"type": "integer",
"description": "Minimum unit price in US dollars."
},
"maxPrice": {
"title": "Max price (USD)",
"minimum": 0,
"type": "integer",
"description": "Maximum unit price in US dollars."
},
"maxMoq": {
"title": "Max minimum order",
"minimum": 1,
"type": "integer",
"description": "Only products whose minimum order quantity is at most this many units."
},
"tradeAssurance": {
"title": "Trade Assurance only",
"type": "boolean",
"description": "Only suppliers that offer Alibaba Trade Assurance order protection.",
"default": false
},
"verifiedSupplier": {
"title": "Verified Suppliers only",
"type": "boolean",
"description": "Only suppliers whose credentials were inspected by a third-party company.",
"default": false
},
"verifiedProSupplier": {
"title": "Verified Pro Suppliers only",
"type": "boolean",
"description": "Only Verified Pro Suppliers, Alibaba's top verification tier.",
"default": false
},
"freeSample": {
"title": "Free samples only",
"type": "boolean",
"description": "Only products that offer free samples.",
"default": false
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Optional proxy. Off by default.",
"default": {
"useApifyProxy": 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
}
}
}
}
}
}
}
}
}
}