{ "openapi": "3.0.1", "info": { "title": "JobKorea Jobs Scraper (잡코리아 채용공고)", "description": "Scrapes job listings from JobKorea (잡코리아), Korea's leading job board. Returns titles, companies, locations, experience level, salary, deadlines and keywords as structured JSON.", "version": "1.0", "x-build-id": "TSRqYb8UGA5rW096H" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kasidesk~jobkorea-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kasidesk-jobkorea-jobs-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/kasidesk~jobkorea-jobs-scraper/runs": { "post": { "operationId": "runs-sync-kasidesk-jobkorea-jobs-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/kasidesk~jobkorea-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-kasidesk-jobkorea-jobs-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": { "dutyCategories": { "title": "Job categories", "type": "array", "description": "JobKorea job-function categories to scrape. Each selected category runs as its own crawl. Leave everything empty (categories, codes and regions) to scrape the whole latest-jobs feed.", "items": { "type": "string", "enum": [ "10026", "10027", "10028", "10029", "10030", "10031", "10032", "10033", "10034", "10035", "10036", "10037", "10038", "10039", "10040", "10041", "10042", "10043", "10044", "10045", "10046" ], "enumTitles": [ "Planning & Strategy (기획·전략)", "Legal & General Affairs (법무·사무·총무)", "HR (인사·HR)", "Accounting & Tax (회계·세무)", "Marketing & Ads & MD (마케팅·광고·MD)", "AI & Software & Data (AI·개발·데이터)", "Design (디자인)", "Logistics & Trade (물류·무역)", "Driving & Delivery (운전·운송·배송)", "Sales (영업)", "Customer Support & TM (고객상담·TM)", "Finance & Insurance (금융·보험)", "Food & Beverage (식·음료)", "Customer Service & Retail (고객서비스·리테일)", "Engineering & Design (엔지니어링·설계)", "Manufacturing (제조·생산)", "Education (교육)", "Construction & Facilities (건축·시설)", "Medical & Bio (의료·바이오)", "Media & Culture & Sports (미디어·문화·스포츠)", "Public & Welfare (공공·복지)" ] } }, "dutyCodes": { "title": "Specific duty codes (optional)", "type": "array", "description": "Fine-grained JobKorea duty codes for specific roles, e.g. 1000186 (web planning). Find codes in the README's code table or in the checkbox values on jobkorea.co.kr/recruit/joblist. Each code runs as its own crawl on top of the categories above.", "default": [], "items": { "type": "string" } }, "localCodes": { "title": "Regions", "type": "array", "description": "Limit results to regions. Combined with each selected job category (category x region).", "items": { "type": "string", "enum": [ "I000", "B000", "K000", "G000", "1000", "O000", "P000", "L000", "M000", "F000", "D000", "H000", "J000", "C000", "A000", "N000", "Q000", "Y000", "Z000", "X000", "R000", "U000" ], "enumTitles": [ "Seoul (서울)", "Gyeonggi (경기)", "Incheon (인천)", "Daejeon (대전)", "Sejong (세종)", "Chungnam (충남)", "Chungbuk (충북)", "Gwangju/Jeonnam (전남광주)", "Jeonbuk (전북)", "Daegu (대구)", "Gyeongbuk (경북)", "Busan (부산)", "Ulsan (울산)", "Gyeongnam (경남)", "Gangwon (강원)", "Jeju (제주)", "Nationwide (전국)", "USA (미국)", "Japan (일본)", "China/HK (중국·홍콩)", "Asia/Middle East (아시아·중동)", "Europe (유럽)" ] }, "default": [] }, "careerTypes": { "title": "Career level", "type": "array", "description": "Filter by required experience. Leave empty for all levels.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8" ], "enumTitles": [ "Entry level (신입)", "1-3 years", "4-6 years", "7-9 years", "10-15 years", "16-20 years", "21+ years", "Any experience (경력무관)" ] }, "default": [] }, "jobTypes": { "title": "Employment type", "type": "array", "description": "Filter by employment type. Leave empty for all types.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10" ], "enumTitles": [ "Full-time (정규직)", "Contract (계약직)", "Intern (인턴)", "Dispatch (파견직)", "Subcontract (도급)", "Freelance (프리랜서)", "Part-time (아르바이트)", "Trainee (연수생)", "Military service exception (병역특례)", "Commissioned (위촉직)" ] }, "default": [] }, "sortBy": { "title": "Sort results by", "enum": [ "latest", "deadline", "recommended" ], "type": "string", "description": "latest returns newest postings first, which is what you want for monitoring. deadline returns postings closing soonest. recommended uses JobKorea's own ranking.", "default": "latest" }, "maxItems": { "title": "Max jobs", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Total number of listings to collect across all filter combinations.", "default": 100 }, "scrapeJobDetails": { "title": "Scrape full job details", "type": "boolean", "description": "Also visit each job's detail page to get salary, working hours, full address, application deadline and the job description summary. Uses roughly twice the requests, so costs more.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "JobKorea serves Korean residential traffic best, keep the residential KR default.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "KR" } } } }, "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 } } } } } } } } } }