{ "openapi": "3.0.1", "info": { "title": "Korea DART Disclosures - Corporate Filings API (전자공시)", "description": "Korean corporate disclosures from DART (금융감독원 전자공시): filings by company, stock code, report type, market & date. No API key. KOSPI/KOSDAQ filing alerts.", "version": "0.2", "x-build-id": "gpvddOYsgOPnSIQjZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thistle_electricity_fwz~korea-dart-disclosures/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thistle_electricity_fwz-korea-dart-disclosures", "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/thistle_electricity_fwz~korea-dart-disclosures/runs": { "post": { "operationId": "runs-sync-thistle_electricity_fwz-korea-dart-disclosures", "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/thistle_electricity_fwz~korea-dart-disclosures/run-sync": { "post": { "operationId": "run-sync-thistle_electricity_fwz-korea-dart-disclosures", "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": { "companies": { "title": "Companies (optional)", "type": "array", "description": "Exact Korean company name (삼성전자), 6-digit stock code (005930) or 8-digit DART corp code (00126380). Leave empty to get filings from ALL companies.", "default": [], "items": { "type": "string" } }, "reportKeywords": { "title": "Report name keywords (optional)", "type": "array", "description": "Only filings whose report name contains this text, e.g. 유상증자 (rights offering), 전환사채 (convertible bonds), 공급계약 (supply contract), 자기주식 (buyback). Each keyword is a separate search.", "default": [], "items": { "type": "string" } }, "filingTypes": { "title": "Filing types", "type": "array", "description": "DART disclosure categories to include.", "items": { "type": "string", "enum": [ "A", "B", "C", "D", "E", "F", "G", "H", "I", "J" ], "enumTitles": [ "A – Periodic reports (정기공시)", "B – Major events (주요사항보고)", "C – Securities issuance (발행공시)", "D – Ownership / 5% holders (지분공시)", "E – Other (기타공시)", "F – Audit reports (외부감사관련)", "G – Funds (펀드공시)", "H – Asset-backed (자산유동화)", "I – Exchange filings (거래소공시)", "J – Fair Trade Commission (공정위공시)" ] }, "default": [ "A", "B", "C", "D", "E", "F", "G", "H", "I", "J" ] }, "market": { "title": "Market", "enum": [ "all", "kospi", "kosdaq", "konex", "other" ], "type": "string", "description": "Filter by listing market of the company.", "default": "all" }, "daysBack": { "title": "Days back", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Number of days up to 'Date to' (or today, KST) to search. Ignored when 'Date from' is set.", "default": 3 }, "dateFrom": { "title": "Date from (YYYY-MM-DD)", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Optional start date (KST)." }, "dateTo": { "title": "Date to (YYYY-MM-DD)", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Optional end date (KST). Defaults to today." }, "finalOnly": { "title": "Latest version only", "type": "boolean", "description": "Show only the final (latest amended) version of each report, like DART's '최종보고서' option.", "default": true }, "includeFilerName": { "title": "Include filer name", "type": "boolean", "description": "Include the filer (제출인) as published by DART. Off by default because for ownership reports this can be an individual executive or shareholder. Turn on only if you need it and have a lawful purpose.", "default": false }, "maxItems": { "title": "Max filings", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of filings to save (you pay per filing).", "default": 100 }, "requestDelaySecs": { "title": "Delay between requests (s)", "minimum": 0, "maximum": 30, "type": "integer", "description": "Polite delay between page requests to DART.", "default": 1 } } }, "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 } } } } } } } } } }