{ "openapi": "3.0.1", "info": { "title": "TradeKorea Scraper: Korean Suppliers, Products & Buying Leads", "description": "Scrape TradeKorea buying leads (RFQs), Korean supplier profiles and products. Filter by keyword, category and buyer country, see the days left on every lead, and monitor new, updated and expired RFQs on a schedule. Public pages only: no login, no buyer emails or phone numbers.", "version": "0.9", "x-build-id": "FmNhn8T0TyrONz4h0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~tradekorea-supplier-rfq-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-tradekorea-supplier-rfq-feed", "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/getascraper~tradekorea-supplier-rfq-feed/runs": { "post": { "operationId": "runs-sync-getascraper-tradekorea-supplier-rfq-feed", "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/getascraper~tradekorea-supplier-rfq-feed/run-sync": { "post": { "operationId": "run-sync-getascraper-tradekorea-supplier-rfq-feed", "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": { "mode": { "title": "What to collect", "enum": [ "buyingLeads", "suppliers", "products" ], "type": "string", "description": "Buying leads (RFQs posted by overseas buyers), Korean supplier profiles, or products.", "default": "buyingLeads" }, "urls": { "title": "TradeKorea links or IDs", "type": "array", "description": "Buying lead, supplier or product links from tradekorea.com, or plain numbers (read as the type chosen above). Links are read first and need no search.", "default": [], "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "One search per keyword, for example cosmetics or steel pipe. Leave empty to read the newest records.", "default": [], "items": { "type": "string" } }, "category": { "title": "Category", "type": "string", "description": "A TradeKorea category by name or path, for example Beauty & Personal Care or Food & Beverage > Foods > Snacks." }, "countries": { "title": "Countries", "type": "array", "description": "Country names or two-letter codes. For buying leads this is the buyer country, for suppliers and products the supplier country.", "default": [], "items": { "type": "string" } }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Buying leads only. Keep leads posted in the last N days." }, "onlyOpen": { "title": "Only open leads", "type": "boolean", "description": "Buying leads only. Skip leads whose offer period has ended.", "default": true }, "expiringWithinDays": { "title": "Expiring within (days)", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Buying leads only. Keep open leads that close within N days." }, "minQuantity": { "title": "Minimum quantity", "minimum": 0, "type": "integer", "description": "Buying leads only. Keep leads asking for at least this quantity. Leads without a stated quantity are skipped." }, "sortBy": { "title": "Sort buying leads", "enum": [ "newest", "relevance" ], "type": "string", "description": "With keywords, newest first checks up to 1,000 matches and returns the most recent ones. Relevance keeps the site order.", "default": "newest" }, "maxItems": { "title": "Maximum records", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Records to return. With a monitor name it is the number of newest matching records checked on each run. Free-plan runs are capped at 25.", "default": 10 }, "includeDetails": { "title": "Read full profiles and product pages", "type": "boolean", "description": "Suppliers and products only. Adds address, employees, certificates and main products for suppliers, and price, minimum order, payment terms and description for products. Slower. Buying leads always include their full text.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Give this search a name to remember it between runs. Each record is then marked new, updated or expired (buying leads). Reuse the same name on a schedule." }, "onlyChanges": { "title": "Only return changes", "type": "boolean", "description": "With a monitor name, return only records that are new, updated or expired since the previous run, and pay only for those.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave empty for the built-in connection, which switches to a proxy by itself if TradeKorea refuses requests." } } }, "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 } } } } } } } } } }