{
"openapi": "3.0.1",
"info": {
"title": "1688 Products Wholesale Scraper - 50+ Fields, 250+ Products/Min",
"description": "Extract 50+ fields per product from 1688.com at 250+ products/minute. Tiered wholesale pricing, supplier verification, factory stats, dropship channels, certifications, trade service scores. Search by keyword (Chinese/English) or offer IDs. JSON output, no login required.",
"version": "0.0",
"x-build-id": "YfY3vnjcUphfdW6RY"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/zen-studio~1688-wholesale-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-zen-studio-1688-wholesale-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/zen-studio~1688-wholesale-scraper/runs": {
"post": {
"operationId": "runs-sync-zen-studio-1688-wholesale-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/zen-studio~1688-wholesale-scraper/run-sync": {
"post": {
"operationId": "run-sync-zen-studio-1688-wholesale-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": {
"keywords": {
"title": "Search keywords (English or Chinese) 🔍",
"type": "array",
"description": "Products to search for. Works with English (wireless earbuds, phone case) or Chinese (手机壳, 蓝牙耳机).
Each keyword is searched separately. Max results applies per keyword.
Chinese keywords typically return more results since 1688 is a domestic Chinese marketplace.
Ignored if Offer IDs are provided.",
"items": {
"type": "string"
}
},
"offerIds": {
"title": "Offer IDs",
"type": "array",
"description": "Specific product IDs to scrape directly (skips search). The ID appears in any 1688 product URL as offerId=735353578254.
If filled, the keywords and filters are ignored.",
"default": [],
"items": {
"type": "string"
}
},
"maxResults": {
"title": "Max results (set 10000 for unlimited)",
"minimum": 1,
"maximum": 10000,
"type": "integer",
"description": "Maximum products to scrape per keyword. Set to 10,000 for unlimited scraping. Ignored when Offer IDs are filled.",
"default": 100
},
"sortBy": {
"title": "Sort order",
"enum": [
"relevance",
"bestSelling",
"priceAsc",
"priceDesc"
],
"type": "string",
"description": "How to sort search results.",
"default": "relevance"
},
"includeSkuDetails": {
"title": "Include SKU variants",
"type": "boolean",
"description": "Add the full SKU variant matrix (colors, sizes, models with per-variant stock and sales). Significantly increases output size per product.
Leave off if you only need product-level data.",
"default": false
},
"includeDescriptionHtml": {
"title": "Include full description HTML",
"type": "boolean",
"description": "Add the complete product description as raw HTML (the long-form description page). This can be large and significantly increases output size per product.
The detail-image URLs and a plain-text version of the description are always included regardless of this setting — turn this on only if you need the full formatted HTML.",
"default": false
},
"includeSupplierIntelligence": {
"title": "Supplier Intelligence (paid add-on)",
"type": "boolean",
"description": "Add supplier & distribution intelligence per product: how many distributors already resell it, recent dropship order volume, fulfillment speed, the sales channels the supplier authorizes for resale, product certificates (quality reports, licenses, patents), and seller intelligence (transaction volume, favorited count, factory certification tags).
Billed only when enabled and the add-on is active; off by default.",
"default": false
},
"priceMin": {
"title": "Minimum price (CNY)",
"minimum": 0,
"type": "integer",
"description": "Only include products with unit price ≥ this value. In Chinese yuan."
},
"priceMax": {
"title": "Maximum price (CNY)",
"minimum": 0,
"type": "integer",
"description": "Only include products with unit price ≤ this value. In Chinese yuan."
},
"minOrderQuantity": {
"title": "Minimum order quantity",
"minimum": 1,
"type": "integer",
"description": "Only include suppliers whose minimum order is ≤ this value. Useful for finding suppliers willing to sell small quantities."
},
"merchantType": {
"title": "Merchant type",
"enum": [
"any",
"superFactory",
"verifiedMerchant"
],
"type": "string",
"description": "Filter by supplier verification tier.
Super Factory (超级工厂): top-tier manufacturers with verified production capacity.
Verified Merchant (实力商家): trusted sellers with strong track records.",
"default": "any"
},
"province": {
"title": "Supplier province",
"type": "string",
"description": "Filter suppliers by province. Use Chinese name, e.g. 广东 (Guangdong), 浙江 (Zhejiang), 江苏 (Jiangsu)."
},
"city": {
"title": "Supplier city",
"type": "string",
"description": "Filter suppliers by city. Use Chinese name, e.g. 深圳市 (Shenzhen), 广州市 (Guangzhou), 义乌市 (Yiwu)."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}