{ "openapi": "3.0.1", "info": { "title": "JobKorea Scraper", "description": "Scrape JobKorea jobs by Korean or English keyword. Returns title, company, salary in KRW, HR contact, headcount, working hours, experience and education required, benefits, company size, industry and website. Pay per result.", "version": "1.2", "x-build-id": "lwmcG5eniRrkYSqLR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/santamaria-automations~jobkorea-kr-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-santamaria-automations-jobkorea-kr-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/santamaria-automations~jobkorea-kr-scraper/runs": { "post": { "operationId": "runs-sync-santamaria-automations-jobkorea-kr-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/santamaria-automations~jobkorea-kr-scraper/run-sync": { "post": { "operationId": "run-sync-santamaria-automations-jobkorea-kr-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": { "sortBy": { "title": "Sort Order", "enum": [ "newest", "relevance", "closingSoon", "mostViewed" ], "type": "string", "description": "Order in which results are returned. newest (default): jobs posted most recently first (등록일순). relevance: JobKorea relevance score (관련도순). closingSoon: application deadline soonest first (마감임박순). mostViewed: most-viewed listings first (조회수순).", "default": "newest" }, "searchQueries": { "title": "Search Keywords", "type": "array", "description": "One or more Korean or English job titles to search for on jobkorea.co.kr (for example '개발자', 'software engineer', '마케팅'). Each keyword runs as a separate search. Results are deduplicated by job ID. Leave blank if you supply startUrls instead.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (alternative to keywords)", "type": "array", "description": "Direct JobKorea search URLs to crawl instead of building searches from keywords. Example: https://www.jobkorea.co.kr/Search/?stext=developer&tabType=recruit. Mutually exclusive with searchQueries: provide one or the other.", "items": { "type": "string" } }, "includeJobDetails": { "title": "Include Full Job Details", "type": "boolean", "description": "Fetch each job's detail page for the full description (from S3), exact address, employment type, salary, apply URL, contact email, and skills. Adds one extra HTTP request per job. Each job then costs $0.008 in total ($0.003 search result plus $0.005 detail result), against $0.003 without details.", "default": false }, "includeCompanyDetails": { "title": "Include Company Details", "type": "boolean", "description": "In detail mode, also open the employer's JobKorea company profile to read the homepage (company_website) and founding year. Adds one request per new employer (cached within a run). No extra charge.", "default": true }, "maxResults": { "title": "Max Total Results", "minimum": 1, "type": "integer", "description": "Total result cap across all search keywords.", "default": 5 }, "maxResultsPerQuery": { "title": "Max Results per Keyword", "minimum": 1, "type": "integer", "description": "Maximum results per individual search keyword.", "default": 5 }, "maxConcurrency": { "title": "Detail Page Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Number of detail pages to fetch in parallel when includeJobDetails is enabled.", "default": 4 } } }, "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 } } } } } } } } } }