{ "openapi": "3.0.1", "info": { "title": "Alibaba 1688 Supplier Ratings Scraper", "description": "Check a 1688.com supplier's rating without an account. You get the score out of 5 and five sub-scores. Also the repeat-buyer rate, years on the platform, factory or trader, audits and location. Look up one company by name, or search a keyword. $0.40 per 1,000.", "version": "0.1", "x-build-id": "hZ42bgyYdqGJclPbR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~alibaba-1688-supplier-ratings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-alibaba-1688-supplier-ratings-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/dami_studio~alibaba-1688-supplier-ratings-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-alibaba-1688-supplier-ratings-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/dami_studio~alibaba-1688-supplier-ratings-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-alibaba-1688-supplier-ratings-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": { "searchTerms": { "title": "Product keywords, find the suppliers behind them", "type": "array", "description": "One product term per line. Every distinct seller whose listings match comes back as one row with their scorecard. Chinese matches far more inventory than English: 手机壳 returns millions of offers where \"phone case\" returns a few thousand. Both work.", "items": { "type": "string" } }, "supplierNames": { "title": "Supplier company names, look up a specific one", "type": "array", "description": "The exact company name as 1688 prints it on the store page, in Chinese, e.g. 东莞市元拓橡塑制品有限公司. One per line. Store URLs do NOT work here and are rejected with an explanation: 1688 has no supplier endpoint, and every seller-id search parameter it accepts is silently ignored, so a b2b-… id cannot be turned back into a company.", "items": { "type": "string" } }, "startUrls": { "title": "1688 search URLs", "type": "array", "description": "Optional. Paste 1688 search pages such as https://s.1688.com/selloffer/offer_search.htm?keywords=手机壳, the keyword is read out of the URL and treated like a product keyword.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum suppliers", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on supplier rows across all queries (1-1000). You are charged once per supplier returned. Suppliers dropped by the filters below are never charged." }, "minRating": { "title": "Minimum composite rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Optional. Drop suppliers rated below this on 1688's 0-5 composite score." }, "manufacturersOnly": { "title": "Manufacturers only", "type": "boolean", "description": "Keep only sellers 1688 classifies as 生产加工 (a factory), dropping wholesalers, distributors and trading agents. Measured over 341 suppliers: 73.9% manufacturers, 9.7% wholesalers, 16.1% with no business type published." }, "requestDelayMs": { "title": "Delay between requests (ms)", "minimum": 300, "maximum": 60000, "type": "integer", "description": "Pause between calls. 1688 meters by how many calls have been made rather than how fast, so this mostly affects how long a run takes." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Leave this alone unless you want to run through your own proxy servers, which is worth doing for high-volume runs because 1688 throttles heavily." } } }, "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 } } } } } } } } } }