{ "openapi": "3.0.1", "info": { "title": "1688.com Product Scraper - Wholesale Prices, MOQ & Suppliers", "description": "Scrape 1688.com wholesale listings by keyword, product URL or supplier: price tiers, MOQ, SKU variants, stock, sales, repurchase rate and supplier details.", "version": "1.0", "x-build-id": "xKDA5okcvwYyGL7ck" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/seemuapps~alibaba-1688-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-seemuapps-alibaba-1688-product-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/seemuapps~alibaba-1688-product-scraper/runs": { "post": { "operationId": "runs-sync-seemuapps-alibaba-1688-product-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/seemuapps~alibaba-1688-product-scraper/run-sync": { "post": { "operationId": "run-sync-seemuapps-alibaba-1688-product-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "product", "supplier" ], "type": "string", "description": "Search returns listing data for every matching product. Product details returns the full product page (all price tiers, SKU variants with stock, attributes, images, supplier). Supplier lists every product sold by one or more suppliers.", "default": "search" }, "keywords": { "title": "Search keywords", "type": "array", "description": "Search mode: keywords to search on 1688.com, one per line. Chinese keywords (e.g. 手机壳) give the most results; English keywords also work for common product names.", "items": { "type": "string" } }, "productUrls": { "title": "Product URLs or offer IDs", "type": "array", "description": "Product mode: 1688 product links (detail.1688.com/offer/123.html or m.1688.com/offer/123.html) or bare offer IDs, one per line.", "items": { "type": "string" } }, "suppliers": { "title": "Suppliers", "type": "array", "description": "Supplier mode: supplier member IDs (b2b-...), m.1688.com/winport/b2b-... links, or any product URL sold by that supplier (the supplier is looked up from the product). The memberId field of search results can be pasted here.", "items": { "type": "string" } }, "supplierKeyword": { "title": "Keyword filter within supplier", "type": "string", "description": "Supplier mode only: optional keyword to search inside each supplier's catalogue. Leave empty to list all of the supplier's products." }, "sort": { "title": "Sort by", "enum": [ "relevance", "priceAsc", "priceDesc" ], "type": "string", "description": "Order of search and supplier results.", "default": "relevance" }, "includeDetails": { "title": "Include full product details", "type": "boolean", "description": "Search and supplier modes: also open each product page to add SKU variants with stock, every price tier, attributes, all images, video and review stats. Slower and billed as a product detail instead of a search result.", "default": false }, "maxItems": { "title": "Max results per keyword / supplier", "minimum": 0, "type": "integer", "description": "Maximum records per keyword or supplier (product mode: maximum products in total). 0 means no limit. Search results come 60 per page; 1688 shows at most about 2,000 results per keyword.", "default": 100 }, "pageId": { "title": "Page ID (pagination)", "type": "string", "description": "Paste NEXT_PAGE_ID from the previous run's Key-value store (e.g. 3:60) to fetch the next page. Use the same keyword or supplier as that run." } } }, "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 } } } } } } } } } }