{ "openapi": "3.0.1", "info": { "title": "Alibaba Products Scraper — Suppliers, Prices & MOQ", "description": "Scrape Alibaba.com B2B products by keyword or URL: tier prices, MOQ, supplier name, years, country, Gold status, response rate, GMV and reviews.", "version": "1.1", "x-build-id": "PRjBLDABAX7luBDJV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~alibaba-products-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-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/khadinakbar~alibaba-products-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-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/khadinakbar~alibaba-products-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-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": { "searchQuery": { "title": "Search keyword", "type": "string", "description": "Free-text product keyword searched on Alibaba.com (e.g. 'led lights', 'stainless steel water bottle'). Each keyword is searched on Alibaba.com's public product search (about 48 cards per page; further pages are read until maxResults is reached). Leave empty if you only use startUrls. NOT a supplier name or product URL." }, "searchQueries": { "title": "Search keywords (multiple)", "type": "array", "description": "List of product keywords to scrape in one run, e.g. ['led lights', 'solar panel', 'yoga mat']. Each keyword is searched and paginated separately. Combined with searchQuery if both are set. NOT URLs — use startUrls for those.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Alibaba.com search or showroom URLs to scrape directly, e.g. 'https://www.alibaba.com/trade/search?SearchText=led+lights' or 'https://www.alibaba.com/showroom/led-lights.html'. Search, showroom and /products/ URLs are converted to the same keyword on Alibaba.com's product search. Use this when you already have a search URL; otherwise use searchQuery. NOT product-detail URLs.", "items": { "type": "string" } }, "maxResults": { "title": "Max products", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum total product cards across all keywords/URLs. Defaults to 100. Range 1–5000. Search pages are paginated until this cap is reached. Each product is billed once, so this is also your hard cost cap.", "default": 100 }, "enrichDetails": { "title": "Enrich with product detail pages", "type": "boolean", "description": "When true, the actor visits each product's detail page to add description and spec attributes (billed extra per enriched product). Slower and more block-prone on Alibaba's anti-bot, so defaults to false. The listing cards already include price, MOQ, supplier and review data without enrichment.", "default": false }, "customProxyUrls": { "title": "Custom proxy URLs (optional, residential recommended)", "type": "array", "description": "Optional list of your own proxy URLs (e.g. 'http://user:pass@host:port' for your own residential proxy). Alibaba is IP-reputation sensitive; residential proxies materially raise the success rate. Leave empty to use Apify's datacenter proxy first and Apify Residential (US) for pages that stay blocked. NOT an Apify proxy group name.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Apify proxy configuration", "type": "object", "description": "Apify proxy settings used when customProxyUrls is empty. Defaults to Apify datacenter proxy; listing pages that stay blocked are retried on Apify Residential pinned to the US so prices stay in USD. Ignored when customProxyUrls is provided.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }