{ "openapi": "3.0.1", "info": { "title": "GobizKOREA Scraper & API - Korean Suppliers, Products & MOQ", "description": "GobizKOREA scraper and API for Korean B2B suppliers and products (KOSME export portal) by keyword. One result = one product + supplier: price lines with incoterm, MOQ, payment terms, supply ability, specs, business type, year founded, revenue, address, website. $1.50 per 1,000.", "version": "1.0", "x-build-id": "kvHdFSCRma3L6FA4M" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rel8ble~gobizkorea-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rel8ble-gobizkorea-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~gobizkorea-scraper/runs": { "post": { "operationId": "runs-sync-rel8ble-gobizkorea-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~gobizkorea-scraper/run-sync": { "post": { "operationId": "run-sync-rel8ble-gobizkorea-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 GobizKOREA URLs)", "type": "array", "description": "Provide at least one. English product keywords, e.g. \"cosmetics\", \"sunscreen\", \"led\", \"auto parts\", or gobizkorea.com URLs: a search (https://www.gobizkorea.com/user/search/search.do?sqt=cosmetics) or one product (https://www.gobizkorea.com/user/goods/frontGoodsDetail.do?goods_no=GS...). Default [\"cosmetics\"] (demo).", "default": [ "cosmetics" ], "items": { "type": "string" } }, "maxResultsPerSearch": { "title": "Max results per search", "minimum": 0, "type": "integer", "description": "Optional. Products saved per keyword / URL, integer >= 0. Default 20 (the form starts at 10, so a first try stays well under a minute); 0 = everything GobizKOREA lists (20 per page). You pay per row.", "default": 20 }, "searchIn": { "title": "Match keyword in", "enum": [ "product", "all" ], "type": "string", "description": "Optional. \"product\" (default) matches the product name and keywords only, giving tight results; \"all\" also matches descriptions and company text, giving many more (e.g. \"cosmetics\": about 950 vs 22,800 products).", "default": "product" }, "sortBy": { "title": "Sort by", "enum": [ "responseRate", "bestTransaction", "newest", "supplierAZ" ], "type": "string", "description": "Optional. GobizKOREA result order. Default \"responseRate\" (suppliers that answer inquiries first).", "default": "responseRate" }, "scrapeDetails": { "title": "Read product pages (trade terms, specs, supplier)", "type": "boolean", "description": "Default true. Reads each product page and adds every price line with incoterm, payment terms, supply ability, countries of sale, model, origin, specs, description, images and the supplier block (business type, main products, year established, revenue band, employees, export revenue, address, website). Off = fastest card-only export (name, brand, listed price, MOQ).", "default": true }, "uniqueSuppliers": { "title": "One row per supplier", "type": "boolean", "description": "Optional. true = keep only the first product of each supplier (a supplier lead list). Default false = one row per product.", "default": false }, "manufacturersOnly": { "title": "Manufacturers only", "type": "boolean", "description": "Optional. Keep only suppliers whose business type is manufacturer. Default false.", "default": false }, "minYearsInBusiness": { "title": "Minimum years in business", "minimum": 0, "type": "integer", "description": "Optional. Keep only companies established at least this many years ago. Default 0.", "default": 0 }, "onlyWithWebsite": { "title": "Only suppliers with a website", "type": "boolean", "description": "Optional. Keep only suppliers that publish their own website. Default false.", "default": false }, "onlyWithPrice": { "title": "Only products with a price", "type": "boolean", "description": "Optional. Skip products quoted as \"Depend on quantity\" with no number. Default false.", "default": false }, "maxPrice": { "title": "Max unit price (USD)", "minimum": 0, "type": "number", "description": "Optional. Skip products whose lowest USD unit price is above this. Products priced in KRW or without a price are kept unless \"Only products with a price\" is on." }, "maxMoq": { "title": "Max MOQ", "minimum": 1, "type": "integer", "description": "Optional. Skip products whose minimum order quantity is above this number, e.g. 100 for small-batch buying. Products without a listed MOQ are kept." }, "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 (each on a new proxy session), 0-20. Default 6.", "default": 6 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional, advanced. Default Apify Proxy (datacenter), which works for GobizKOREA. Switch to {\"useApifyProxy\": true, \"apifyProxyGroups\": [\"RESIDENTIAL\"]} only if the log shows repeated blocks.", "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 } } } } } } } } } }