{ "openapi": "3.0.1", "info": { "title": "1688 Scraper & API: Product Search, Price Tiers, Suppliers", "description": "1688 scraper for 1688.com, China's wholesale marketplace: search by keywords or a 1688 search URL, or paste product links. Price per quantity tier, minimum order, every variant with price and stock, specifications, sales and supplier. No 1688 account.", "version": "0.1", "x-build-id": "0FNbrjyvunykCxJ9D" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/quarra~1688-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-quarra-1688-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/quarra~1688-scraper/runs": { "post": { "operationId": "runs-sync-quarra-1688-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/quarra~1688-scraper/run-sync": { "post": { "operationId": "run-sync-quarra-1688-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": { "searchQueries": { "title": "Search keywords or search URLs", "maxItems": 5000, "type": "array", "description": "One per line: keywords in Chinese (手机壳) or English, or a 1688 search URL pasted as is (s.1688.com/selloffer/offer_search.htm?keywords=…). Each search returns products in 1688 order, up to 'Max results per search'.", "items": { "type": "string", "maxLength": 2000 } }, "productUrls": { "title": "Product URLs or offer IDs", "maxItems": 5000, "type": "array", "description": "One per line: 1688 product URLs (detail.1688.com/offer/….html, mobile links) or offer IDs. Each gets the full details.", "items": { "type": "string", "maxLength": 2000 } }, "maxItems": { "title": "Max products", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Total number of products delivered by the run (search results and products with full details), counted exactly.", "default": 100 }, "maxResultsPerSearch": { "title": "Max results per search", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Products per search, at most 2,000 (1688 shows no more than 2,000 results for one search).", "default": 100 }, "scrapeDetails": { "title": "Full details for search results", "type": "boolean", "description": "Off: search results with title, price, sales, repurchase rate, images and supplier (charged as search results). On: every search result also gets the full product details: price tiers, minimum order, every variant with price and stock, specifications, rating (charged as products).", "default": false }, "sort": { "title": "Sort", "enum": [ "relevance", "sales", "priceAsc", "priceDesc" ], "type": "string", "description": "Order of search results.", "default": "relevance" }, "minPrice": { "title": "Min price (CNY)", "minimum": 0, "type": "number", "description": "Lowest price, in Chinese yuan." }, "maxPrice": { "title": "Max price (CNY)", "minimum": 0, "type": "number", "description": "Highest price, in Chinese yuan." }, "deliveryConnector": { "title": "Send results to your app (MCP connector: Notion, Slack…)", "type": "string", "description": "Pick one of your Apify MCP connectors: at the end of each run, a summary of the results (count, the first 25 with their links, a link to the full dataset) is posted there. With a schedule and 'Only new', you get each day's new results where your team works. Nothing is sent when a run finds nothing. Notion connects in one click; Slack and Google need your own OAuth app in Apify, or use the webhook field below." }, "deliveryTarget": { "title": "Where in the app (channel, page or sheet ID)", "type": "string", "description": "Slack channel ID (C0123…), Notion page ID, Google Sheet ID… Leave empty if the app needs no target (a new Notion page is then created at the top of your workspace)." }, "deliveryWebhookUrl": { "title": "Or a webhook URL (Slack, Discord, Make, Zapier, n8n)", "type": "string", "description": "No connector needed. A Slack Incoming Webhook (hooks.slack.com/…) gets a message, a Discord channel webhook gets a message, any other URL receives the summary as JSON (title, text, count, datasetUrl, items)." }, "deliveryTool": { "title": "Connector tool (advanced)", "type": "string", "description": "Name of the connector's tool to call. Leave empty: the best tool that posts a message, creates a page or appends rows is picked, and the run log lists every tool the connector offers." }, "deliveryArguments": { "title": "Connector tool arguments (advanced)", "type": "object", "description": "Extra arguments for the tool, merged last, for example {\"channel\": \"#reddit-leads\"} or {\"parent\": {\"database_id\": \"…\"}}." } } }, "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 } } } } } } } } } }