{ "openapi": "3.0.1", "info": { "title": "Korea Company Registry API - Business Number Lookup 사업자 조회", "description": "Look up South Korean companies by name or business registration number (사업자등록번호) from official government data: corporate number, CEO, address, employees, listing, financials and live NTS status.", "version": "0.1", "x-build-id": "k3tGLKUFbGEIcCxZ7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/elabstudio~korea-company-registry/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-elabstudio-korea-company-registry", "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/elabstudio~korea-company-registry/runs": { "post": { "operationId": "runs-sync-elabstudio-korea-company-registry", "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/elabstudio~korea-company-registry/run-sync": { "post": { "operationId": "run-sync-elabstudio-korea-company-registry", "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": { "companyNames": { "title": "Company names (Korean)", "type": "array", "description": "Search the official corporate registry by company name. Korean names work (e.g. \"삼성전자\", \"카카오\"); the search matches names that contain the text. English names are not searchable at the source.", "items": { "type": "string" } }, "businessNumbers": { "title": "Business registration numbers (사업자등록번호)", "type": "array", "description": "10-digit Korean business registration numbers, with or without dashes (\"124-81-00998\"). Each one returns the live National Tax Service status (active, suspended, closed, tax type) and the company profile when the business is a registered corporation.", "items": { "type": "string" } }, "corporateNumbers": { "title": "Corporate registration numbers (법인등록번호)", "type": "array", "description": "Optional. 13-digit corporate registration numbers, with or without dash (\"130111-0006246\").", "items": { "type": "string" } }, "maxResultsPerName": { "title": "Max companies per name", "minimum": 0, "type": "integer", "description": "Name searches can match many companies (\"전자\" matches thousands). Best matches (exact name first, then larger companies) are kept. 0 = no limit.", "default": 50 }, "exactNameMatch": { "title": "Exact name match only", "type": "boolean", "description": "Keep only companies whose name equals the query (ignoring 주식회사, (주) and spaces).", "default": false }, "includeNtsStatus": { "title": "Add National Tax Service status", "type": "boolean", "description": "Adds the live business status from the National Tax Service: active (계속사업자), suspended (휴업자), closed (폐업자), closure date and VAT tax type. Free of extra charge.", "default": true }, "includeFinancials": { "title": "Add financial statements", "type": "boolean", "description": "Adds yearly revenue, operating profit, net income, assets, liabilities, equity and debt ratio (consolidated and separate) where the company files them. Billed as an extra event per company with financials.", "default": false }, "financialYears": { "title": "Financial years", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many of the latest fiscal years to include.", "default": 3 }, "onlyActive": { "title": "Only active businesses", "type": "boolean", "description": "Drop companies whose NTS status is suspended, closed or not registered.", "default": false }, "maxItems": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Stop after N results in total. 0 = no limit.", "default": 0 } } }, "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 } } } } } } } } } }