{ "openapi": "3.0.1", "info": { "title": "Korean Company Filings & Financials - DART", "description": "Pull Korean public company profiles, audited financial statements and regulatory filings from DART, Korea's official disclosure system. Search by company name, ticker or corp code.", "version": "0.1", "x-build-id": "sWysPYKUIeH1ptN7k" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/loopchips~korea-company-filings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-loopchips-korea-company-filings-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/loopchips~korea-company-filings-scraper/runs": { "post": { "operationId": "runs-sync-loopchips-korea-company-filings-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/loopchips~korea-company-filings-scraper/run-sync": { "post": { "operationId": "run-sync-loopchips-korea-company-filings-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", "required": [ "dartApiKey", "companies" ], "properties": { "dartApiKey": { "title": "DART API key", "type": "string", "description": "Your own free OpenDART key. Get one in 3 minutes at https://opendart.fss.or.kr (인증키 신청/관리 > 인증키 신청). Free tier allows 20,000 calls per day." }, "companies": { "title": "Companies", "type": "array", "description": "Company names, 6-digit tickers or 8-digit DART corp codes. Examples: 삼성전자, 005930, 00126380. Korean names match best.", "items": { "type": "string" } }, "includeFinancials": { "title": "Include financial statements", "type": "boolean", "description": "Adds balance sheet and income statement figures plus headline metrics (assets, equity, revenue, operating profit, net income).", "default": true }, "financialYear": { "title": "Financial year", "minimum": 2015, "maximum": 2030, "type": "integer", "description": "Business year of the report to fetch, e.g. 2025.", "default": 2025 }, "reportType": { "title": "Report type", "enum": [ "annual", "half", "q1", "q3" ], "type": "string", "description": "Which periodic report to read the financials from.", "default": "annual" }, "includeDisclosures": { "title": "Include regulatory filings", "type": "boolean", "description": "Adds the company's recent DART filings with titles, dates and direct links.", "default": true }, "disclosureFromDate": { "title": "Filings from date", "type": "string", "description": "Start date for filings, YYYY-MM-DD. Defaults to one year ago." }, "disclosureToDate": { "title": "Filings to date", "type": "string", "description": "End date for filings, YYYY-MM-DD. Defaults to today." }, "maxDisclosures": { "title": "Max filings per company", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many recent filings to attach to each company.", "default": 20 }, "requestDelayMs": { "title": "Delay between requests (ms)", "minimum": 100, "maximum": 5000, "type": "integer", "description": "Politeness delay between API calls.", "default": 400 }, "refreshDirectory": { "title": "Refresh company directory", "type": "boolean", "description": "The Actor ships with a company directory snapshot so lookups are instant. Turn this on to download the latest directory from DART instead (slow outside Korea, and it uses your API quota). Only needed for companies registered very recently.", "default": false } } }, "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 } } }, "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 } } } } } } } } } }