{ "openapi": "3.0.1", "info": { "title": "Alibaba 1688 Supplier Ratings Scraper", "description": "1688.com supplier scorecards, no account needed: rating out of 5, five sub-scores, repeat-buyer rate, years on platform, factory or trader, audits, location. Look a company up by name or get every supplier behind a keyword. $0.40/1,000 - the lowest per-supplier price on Apify.", "version": "0.1", "x-build-id": "YdWa5YIMuR8kQB32f" }, "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. Applied after the data comes back, so filtered-out suppliers cost you nothing." }, "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 API calls. 1688 meters by how many calls an exit address has made rather than how fast, so this mostly affects run time — the fix for a BLOCKED run is more addresses, not more waiting." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. The Actor ships with its own exit addresses; leave this alone unless you want to run through your own proxies, which is worth doing for high-volume runs because 1688's per-address quota refills slowly." } } }, "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 } } } } } } } } } }