{
"openapi": "3.0.1",
"info": {
"title": "Alibaba Scraper: Products, Suppliers, Prices and MOQ",
"description": "Search Alibaba.com for wholesale products with quantity price breaks, MOQ, specs, variants and the supplier behind each listing. Browse a category, paste product URLs, or pull manufacturer profiles with factory verification reports. Buyer review text included at no extra charge.",
"version": "0.0",
"x-build-id": "ba3Gehpvtlxi5GiNd"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/sourabhbgp~alibaba-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-sourabhbgp-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/sourabhbgp~alibaba-scraper/runs": {
"post": {
"operationId": "runs-sync-sourabhbgp-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/sourabhbgp~alibaba-scraper/run-sync": {
"post": {
"operationId": "run-sync-sourabhbgp-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": {
"resultType": {
"title": "What to scrape",
"enum": [
"products",
"suppliers"
],
"type": "string",
"description": "Products: product listings with the supplier attached.
Suppliers: manufacturer and factory profiles.",
"default": "products"
},
"searchTerms": {
"title": "Search terms",
"type": "array",
"description": "Keywords to search. Each term is searched separately and returns 48 products per page.",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"categoryId": {
"title": "Category ID",
"pattern": "^[0-9]{4,12}$",
"type": "string",
"description": "Browse a whole category instead of, or alongside, a keyword. Use the numeric leaf category ID from an Alibaba category URL, for example 39050101 for Flashlights and Torches. Leave empty for a plain keyword search."
},
"productUrls": {
"title": "Product URLs",
"type": "array",
"description": "Alibaba product pages to read directly. Use this instead of search when you already know the products.",
"items": {
"type": "string",
"pattern": "^https?://[a-z0-9.-]*alibaba\\.com/product-detail/.+_\\d{6,}\\.html"
}
},
"maxItems": {
"title": "Maximum results",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "Stop after this many results. You are only charged for results actually delivered.",
"default": 100
},
"scrapeProductDetails": {
"title": "Include full product detail",
"type": "boolean",
"description": "Adds around 30 specifications, product variants and per variant prices, stock by variant, production lead times, customization minimums, all product images and the full supplier profile. Also adds the seller written description where the seller published one. Costs one extra request per product.",
"default": false
},
"includeReviews": {
"title": "Include review text",
"type": "boolean",
"description": "Adds buyer reviews with the text, rating, buyer country and photos. Product reviews are used when the product has them, otherwise store reviews are returned. Every review says which of the two it is.",
"default": false
},
"maxReviewsPerProduct": {
"title": "Maximum reviews per product",
"minimum": 1,
"maximum": 20,
"type": "integer",
"description": "Upper limit on reviews returned for each product.",
"default": 10
},
"includeVerificationReport": {
"title": "Include factory verification report",
"type": "boolean",
"description": "Suppliers mode only. Adds the independent verification report where one exists: year established, floor space, production lines, quality inspectors, R and D engineers, customization levels, the inspecting company and the factory tour video.",
"default": false
},
"sortBy": {
"title": "Sort by",
"enum": [
"relevance",
"trade_ranking",
"response_rate"
],
"type": "string",
"description": "Order results. Alibaba trade ranking re-ranks toward established trading suppliers: it returns a substantially different result set, but it is not a strict units-sold ordering, so do not read it as one. Supplier response rate puts the fastest-replying suppliers first. Alibaba offers no price sort on this data.",
"default": "relevance"
},
"minPrice": {
"title": "Min price",
"minimum": 0,
"type": "integer",
"description": "Only products at or above this unit price, in US dollars."
},
"maxPrice": {
"title": "Max price",
"minimum": 0,
"type": "integer",
"description": "Only products at or below this unit price, in US dollars."
},
"tradeAssuranceOnly": {
"title": "Trade Assurance only",
"type": "boolean",
"description": "Only listings covered by Alibaba Trade Assurance order protection.",
"default": false
},
"supplierCountry": {
"title": "Supplier country",
"pattern": "^[A-Za-z]{2}$",
"type": "string",
"description": "Only suppliers based in this country. Two letter country code, for example CN, IN or VN."
},
"country": {
"title": "Deliver to",
"enum": [
"US",
"GB",
"DE",
"FR",
"ES",
"IT",
"NL",
"CA",
"AU",
"IN",
"BR",
"MX",
"AE",
"SA",
"JP",
"KR",
"SG",
"ZA",
"RU",
"TR"
],
"type": "string",
"description": "Buyer destination. Changes the shipping cost quoted on each listing and which listings can ship at all.",
"default": "US"
},
"currency": {
"title": "Currency",
"enum": [
"USD",
"EUR",
"GBP",
"CAD",
"AUD",
"INR",
"BRL",
"MXN",
"AED",
"SAR",
"JPY",
"KRW",
"SGD",
"ZAR",
"RUB",
"TRY"
],
"type": "string",
"description": "Currency for the localised price fields. A US dollar figure is always returned as well, whatever you pick here.",
"default": "USD"
},
"includeSponsored": {
"title": "Include sponsored listings",
"type": "boolean",
"description": "Alibaba mixes paid placements into search results. They are skipped and never charged for by default. Turn this on if you want them, marked with isSponsored.",
"default": false
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Datacenter proxy is used by default and is all this scraper needs. Residential is not required for any part of it.",
"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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}