{ "openapi": "3.0.1", "info": { "title": "buyKOREA Scraper & API - Korean Suppliers, Products & Prices", "description": "buyKOREA scraper and API (KOTRA): Korean B2B products and supplier leads by keyword. USD price tiers, MOQ, HS code, specs, business type, website, address, employees, revenue, year founded, export markets. Supplier profiles included. $1.50 per 1,000, no start fee. Only buyKOREA actor (7 Nov 2026).", "version": "1.0", "x-build-id": "Vbfr5XwmcCRO8emKh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rel8ble~buykorea-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rel8ble-buykorea-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~buykorea-scraper/runs": { "post": { "operationId": "runs-sync-rel8ble-buykorea-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~buykorea-scraper/run-sync": { "post": { "operationId": "run-sync-rel8ble-buykorea-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": "Keywords (or buyKOREA URLs)", "type": "array", "description": "Provide at least one. English product keywords, e.g. \"cosmetics\", \"led lighting\", \"auto parts\", \"kimchi\", or buyKOREA URLs: a search (https://buykorea.org/comm/buyer/search.do?keyword=cosmetics) or a supplier storefront (https://buykorea.org/seller-home/2248110396, gives one company row). Default [\"cosmetics\"] (demo).", "default": [ "cosmetics" ], "items": { "type": "string" } }, "searchType": { "title": "What to collect", "enum": [ "products", "companies" ], "type": "string", "description": "\"products\" (default) = one row per product with price tiers, MOQ, HS code and the supplier profile. \"companies\" = one row per Korean supplier matching the keyword (website, employees, revenue, founding year, products) for lead lists.", "default": "products" }, "maxResultsPerSearch": { "title": "Max results per search", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Optional. Rows saved per keyword, 0-10000. Default 50; 0 = as many as buyKOREA serves (up to 10,000 per keyword). You pay per row, so start with 20.", "default": 50 }, "scrapeProfiles": { "title": "Read supplier profiles", "type": "boolean", "description": "Default true. Reads each supplier's \"Our Company\" page once per run and adds business type, address, website, employees, annual revenue, year established, main markets, main categories and description. Turn off for the fastest export (product and search data only).", "default": true }, "productType": { "title": "Product class", "enum": [ "commercial", "materials", "services", "all" ], "type": "string", "description": "Products search only. \"commercial\" (default, finished goods), \"materials\" (raw materials, parts, components), \"services\" or \"all\".", "default": "commercial" }, "sort": { "title": "Sort order", "enum": [ "newest", "popularity", "lowPrice", "highPrice", "AtoZ", "ZtoA" ], "type": "string", "description": "Order of the buyKOREA results. Default \"newest\". lowPrice / highPrice apply to products only.", "default": "newest" }, "uniqueSuppliers": { "title": "One row per supplier", "type": "boolean", "description": "Products search only. true = keep only the first product of each supplier (a supplier lead list). Default false.", "default": false }, "onlyWithPrice": { "title": "Only products with a public price", "type": "boolean", "description": "Products only. Skip \"price on request\" products. Default false.", "default": false }, "maxPrice": { "title": "Max unit price (USD)", "minimum": 0, "type": "number", "description": "Products only. Skip products whose lowest published price is above this. Omit for no limit." }, "maxMoq": { "title": "Max MOQ", "minimum": 1, "type": "integer", "description": "Products only. Skip products whose minimum order quantity is above this, e.g. 100 for small test orders. Omit for no limit." }, "halalOnly": { "title": "Halal certified only", "type": "boolean", "description": "Products only. Keep only products registered as Halal certified. Default false.", "default": false }, "onlyWithWebsite": { "title": "Only suppliers with a website", "type": "boolean", "description": "Keep only rows whose supplier lists a homepage (reads profiles). Default false.", "default": false }, "minYearsInBusiness": { "title": "Minimum years in business", "minimum": 0, "type": "integer", "description": "Keep only suppliers founded at least this many years ago (reads profiles). Default 0.", "default": 0 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Optional, advanced. Parallel requests, 1-20. Default 8.", "default": 8 }, "maxRequestRetries": { "title": "Max retries per request", "minimum": 0, "maximum": 20, "type": "integer", "description": "Optional, advanced. Retries per failed request, 0-20. Default 5.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional, advanced. Default Apify Proxy (datacenter), which works for buyKOREA.", "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 } } } } } } } } } }