{
"openapi": "3.0.1",
"info": {
"title": "Alibaba.com Scraper - Wholesale Products & Supplier Leads",
"description": "Scrape Alibaba.com B2B products by keyword, URL or ID: tiered wholesale (FOB) prices, MOQ, specs, SKU variants, certifications, images, Trade Assurance & supplier/manufacturer leads with firmographics & lead score. Filter, set currency & monitor price drops.",
"version": "0.1",
"x-build-id": "zEp589uOlVvvC2u1S"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~alibaba-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-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/scrapesage~alibaba-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-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/scrapesage~alibaba-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-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 keywords",
"type": "array",
"description": "Keywords to search Alibaba.com for, e.g. wireless earbuds, stainless steel water bottle, solar panel. Each keyword is scraped as its own product feed. Leave empty if you only use Start URLs / Product IDs.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "Start URLs",
"type": "array",
"description": "Alibaba.com URLs to scrape directly: product pages (/product-detail/...html), search/category pages (/trade/search?SearchText=... or /showroom/...) or supplier minisites (https://<name>.en.alibaba.com/). Used in addition to the keyword search.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"productIds": {
"title": "Product IDs (direct detail)",
"type": "array",
"description": "Alibaba.com product IDs to fetch full product detail for directly (e.g. 1601295664563). Equivalent to pasting their product-detail URLs.",
"items": {
"type": "string"
}
},
"minPrice": {
"title": "Min price",
"minimum": 0,
"type": "integer",
"description": "Only keep products whose lowest unit price (in the chosen currency) is at least this much."
},
"maxPrice": {
"title": "Max price",
"minimum": 0,
"type": "integer",
"description": "Only keep products whose lowest unit price (in the chosen currency) is at most this much."
},
"maxMoq": {
"title": "Max MOQ (minimum order quantity)",
"minimum": 1,
"type": "integer",
"description": "Only keep products whose minimum order quantity is at most this many units — useful for finding low-MOQ suppliers for small / test orders."
},
"supplierType": {
"title": "Supplier type",
"enum": [
"any",
"manufacturer",
"tradingCompany",
"verified",
"goldSupplier"
],
"type": "string",
"description": "Keep only products from a given supplier type (best-effort; based on supplier badges).",
"default": "any"
},
"supplierCountry": {
"title": "Supplier country",
"type": "string",
"description": "Keep only products whose supplier is registered in this ISO country code (e.g. CN, IN, VN, US). Leave blank for all."
},
"minRating": {
"title": "Min product rating",
"enum": [
"0",
"3",
"3.5",
"4",
"4.5"
],
"type": "string",
"description": "Only keep products with at least this average review score (0–5). Drops new / unrated items when set.",
"default": "0"
},
"tradeAssuranceOnly": {
"title": "Trade Assurance only",
"type": "boolean",
"description": "Only keep products covered by Alibaba Trade Assurance (order protection). Requires product detail.",
"default": false
},
"country": {
"title": "Localize to country",
"type": "string",
"description": "ISO country code that prices, shipping and availability are localized to (e.g. US, GB, DE, AU). Drives the proxy exit country and the displayed currency. US shows USD.",
"default": "US"
},
"maxProducts": {
"title": "Max products",
"minimum": 1,
"type": "integer",
"description": "Maximum number of product records to scrape across all searches / URLs. Alibaba.com search returns ~48 products per page.",
"default": 100
},
"includeProductDetails": {
"title": "Include full product detail",
"type": "boolean",
"description": "Open each product to add tiered wholesale (FOB) ladder prices, the full SKU/variant matrix, every product attribute/spec, all images & video, certifications, packaging & lead times, Trade Assurance, and the full supplier company profile. Adds one page fetch per product.",
"default": false
},
"outputSupplierLeads": {
"title": "Emit supplier / manufacturer lead records",
"type": "boolean",
"description": "In addition to product records, push one deduplicated lead record per unique supplier (type = \"supplier\") with company name, business type, country, years on Alibaba, employees, response time, on-time delivery rate, Gold/Verified/Trade-Assurance status, contact name, ratings, sample products and a 0–100 lead score. Implies product detail for the richest firmographics. (Alibaba does not publish supplier emails/phones — contact is via the supplier's minisite & the platform.)",
"default": false
},
"deduplicateProducts": {
"title": "Deduplicate products",
"type": "boolean",
"description": "Drop duplicate products that appear in more than one search / page in the same run.",
"default": true
},
"monitorMode": {
"title": "Monitor mode (only new / changed)",
"type": "boolean",
"description": "Remember products across runs in a named key-value store and emit ONLY products that are new OR whose price/MOQ changed since the last run (each carries a changeType: new / price_drop / price_rise / moq_change). Pair with Apify Schedules for price-drop alerts — it complements the scheduler (the schedule starts the run, monitor mode dedupes against prior runs).",
"default": false
},
"monitorKey": {
"title": "Monitor key",
"type": "string",
"description": "Names the monitor's memory store so you can run several independent monitors (e.g. one per keyword). Reuse the same key to keep tracking the same feed.",
"default": "default"
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 8,
"type": "integer",
"description": "Parallel page fetches. Keep low (2–4) so Alibaba's anti-bot doesn't challenge the proxy.",
"default": 3
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxies to use. Residential proxies are strongly recommended — Alibaba.com challenges datacenter IPs. Fresh residential sessions per request, primed with a homepage visit, stay ungated.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}