{ "openapi": "3.0.1", "info": { "title": "TradeKorea Scraper & API - Korean Suppliers, FOB Prices & MOQ", "description": "TradeKorea scraper and API (KITA): Korea B2B exporters and products by keyword. FOB price, MOQ, HS code, specs, payment terms, lead time, business type, year established, employees, address, export markets. Supplier profiles included. $1.50 per 1,000, lowest on 7 Nov 2026, no start fee.", "version": "1.0", "x-build-id": "ry3DtGM0ULgZt1ZSc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rel8ble~tradekorea-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rel8ble-tradekorea-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/rel8ble~tradekorea-scraper/runs": { "post": { "operationId": "runs-sync-rel8ble-tradekorea-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/rel8ble~tradekorea-scraper/run-sync": { "post": { "operationId": "run-sync-rel8ble-tradekorea-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": "Products (keywords or tradeKorea URLs)", "type": "array", "description": "Provide at least one. English product keywords, e.g. \"cosmetics\", \"ramen\", \"led light\", \"car parts\", or tradeKorea URLs: a search (https://www.tradekorea.com/total_search/search.do?search_query=cosmetics), a category (https://www.tradekorea.com/total_search/search.do?search_category=12%5e1214%5e1214139&search_categoryname=Noodles+%26+Pastas) or one product (https://www.tradekorea.com/product/detail/P857249/OTTOGI-RAMEN.html). Default [\"ramen\"] (demo).", "default": [ "ramen" ], "items": { "type": "string" } }, "maxResultsPerSearch": { "title": "Max results per search", "minimum": 0, "type": "integer", "description": "Optional. Products saved per keyword / URL, integer >= 0. Default 10; 0 = everything tradeKorea returns (60 per page). You pay per row.", "default": 10 }, "scrapeDetails": { "title": "Read product pages (price, MOQ, specs, trade terms)", "type": "boolean", "description": "Default true. Reads each product page for FOB price, MOQ, brand, specs, HS code, payment terms, lead time, images, description and the supplier block (year established, membership, business type, export markets). false = fastest listing-only export (name, image, HS code, supplier name, member years).", "default": true }, "scrapeCompanyProfiles": { "title": "Read supplier company profiles", "type": "boolean", "description": "Default true. Reads each supplier's profile once (cached per run) for address, employees, product categories, main products and the company introduction. Needs scrapeDetails.", "default": true }, "uniqueSuppliers": { "title": "One row per supplier", "type": "boolean", "description": "Optional. true = keep only the first product of each supplier (a Korean exporter lead list). Default false = one row per product.", "default": false }, "onlyWithPrice": { "title": "Only products with a listed price", "type": "boolean", "description": "Optional. Skip products whose price is only \"Negotiable\". Default false.", "default": false }, "maxPrice": { "title": "Max FOB unit price (USD)", "minimum": 0, "type": "number", "description": "Optional. Skip products whose lowest listed price is above this. Products without a listed price are kept unless onlyWithPrice is on." }, "maxMoq": { "title": "Max MOQ", "minimum": 1, "type": "integer", "description": "Optional. Skip products whose minimum order quantity is above this number. Products with a negotiable MOQ are kept." }, "minYearsInBusiness": { "title": "Minimum years in business", "minimum": 0, "type": "integer", "description": "Optional. Keep only suppliers established at least this many years ago (from the year established). Default 0.", "default": 0 }, "minMemberYears": { "title": "Minimum years as tradeKorea member", "minimum": 0, "type": "integer", "description": "Optional. Keep only suppliers with at least this many years of tradeKorea membership. Default 0.", "default": 0 }, "membership": { "title": "Membership grades", "type": "array", "description": "Optional. Keep only these seller grades, e.g. [\"VIP\", \"Pro\"]. Empty = all.", "items": { "type": "string", "enum": [ "VIP", "Pro", "Biz" ], "enumTitles": [ "VIP", "Pro", "Biz" ] }, "default": [] }, "businessTypes": { "title": "Business types", "type": "array", "description": "Optional. Keep only suppliers whose business type contains one of these words, e.g. [\"Manufacturer\"] or [\"Trading Company\", \"Distributor\"]. Empty = all.", "default": [], "items": { "type": "string" } }, "onlyWithCertification": { "title": "Only suppliers with a verification mark", "type": "boolean", "description": "Optional. Keep only suppliers showing a tradeKorea verification mark (e.g. TRADE DEAL). Default false.", "default": false }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Optional, advanced. Parallel requests, 1-20. Default 6 (tradeKorea starts dropping connections above about 8).", "default": 6 }, "maxRequestRetries": { "title": "Max retries per request", "minimum": 0, "maximum": 20, "type": "integer", "description": "Optional, advanced. Retries per failed request (each on a new proxy session), 0-20. Default 5.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional, advanced. Default Apify Proxy (datacenter), which works for tradeKorea.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }