{ "openapi": "3.0.1", "info": { "title": "Korea Public Tenders Scraper - KONEPS 나라장터 Bids & Awards", "description": "South Korea government tenders from the official KONEPS (나라장터) open API: bid notices for goods, services and construction with agency, estimated price, deadlines, region limits and attachments, plus award winners. English fields.", "version": "0.1", "x-build-id": "bFrVzmymbxqKs6pR7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/elabstudio~korea-public-tenders/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-elabstudio-korea-public-tenders", "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-public-tenders/runs": { "post": { "operationId": "runs-sync-elabstudio-korea-public-tenders", "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-public-tenders/run-sync": { "post": { "operationId": "run-sync-elabstudio-korea-public-tenders", "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": { "categories": { "title": "Categories", "type": "array", "description": "Which KONEPS business types to search: goods, services, construction, foreign (foreign procurement). Empty means all four.", "items": { "type": "string", "enum": [ "goods", "services", "construction", "foreign" ], "enumTitles": [ "Goods (물품)", "Services (용역)", "Construction (공사)", "Foreign procurement (외자)" ] }, "default": [ "goods", "services", "construction" ] }, "keywords": { "title": "Title keywords", "type": "array", "description": "Optional. Words that must appear in the notice title. Titles are Korean, so Korean works best (e.g. \"소프트웨어\", \"인공지능\", \"청소\"). Common English words such as software, cloud, AI, security, cleaning, construction, consulting are translated automatically. Each keyword is a separate search; results are merged.", "items": { "type": "string" } }, "daysBack": { "title": "Posted in the last N days", "minimum": 1, "maximum": 366, "type": "integer", "description": "Used when dateFrom is empty. Counted in Korea time, including today.", "default": 7 }, "dateFrom": { "title": "Posted from (YYYY-MM-DD)", "type": "string", "description": "Optional start of the posting date range (Korea time). Long ranges are split into ~4-week windows automatically." }, "dateTo": { "title": "Posted to (YYYY-MM-DD)", "type": "string", "description": "Optional end of the posting date range. Default today." }, "agencyName": { "title": "Ordering agency contains", "type": "string", "description": "Optional, Korean agency name or part of it, e.g. \"조달청\", \"서울특별시\", \"한국전력\"." }, "demandAgencyName": { "title": "Demand agency contains", "type": "string", "description": "Optional, the agency that needs the goods or service (수요기관), e.g. \"국방\", \"교육청\"." }, "minEstimatedPriceKrw": { "title": "Min estimated price (KRW)", "minimum": 0, "type": "integer", "description": "Optional, e.g. 100000000 for 100 million won." }, "maxEstimatedPriceKrw": { "title": "Max estimated price (KRW)", "minimum": 0, "type": "integer", "description": "Optional." }, "openBidsOnly": { "title": "Only bids still open", "type": "boolean", "description": "Skip notices whose bid deadline has passed.", "default": false }, "includeRegionRestrictions": { "title": "Add region restrictions", "type": "boolean", "description": "Adds the regions a bidder must be located in (참가가능지역), when the notice has any. Costs a few extra API calls, no extra charge.", "default": true }, "includeAwards": { "title": "Include award results", "type": "boolean", "description": "Also return award results (낙찰) for the same categories, keywords and dates: winning company, business number, winning bid, rate and number of bidders. Award rows are separate items with record_type = award.", "default": false }, "krwPerUsd": { "title": "KRW per USD (optional)", "minimum": 1, "type": "integer", "description": "If set (e.g. 1400), adds approximate USD amounts next to KRW prices." }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Stop after this many rows (notices plus awards). 0 = no limit.", "default": 500 } } }, "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 } } } } } } } } } }