{
"openapi": "3.0.1",
"info": {
"title": "JobKorea Job Scraper — Korean Jobs, Salaries & Hiring Companies",
"description": "Scrape job postings from JobKorea (jobkorea.co.kr), Korea's biggest job board. Titles, companies, regions, salary ranges in KRW, experience and education requirements, employment type, deadlines, benefits and full descriptions as clean JSON.",
"version": "1.0",
"x-build-id": "9Q4NLLfavmXhbjXt5"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/youfuxu~jobkorea-korea-jobs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-youfuxu-jobkorea-korea-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/youfuxu~jobkorea-korea-jobs-scraper/runs": {
"post": {
"operationId": "runs-sync-youfuxu-jobkorea-korea-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/youfuxu~jobkorea-korea-jobs-scraper/run-sync": {
"post": {
"operationId": "run-sync-youfuxu-jobkorea-korea-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",
"required": [
"keyword"
],
"properties": {
"keyword": {
"title": "Search keyword",
"type": "string",
"description": "What to search for, e.g. python, 데이터 분석, 마케팅, 반도체. Korean or English both work — JobKorea matches titles, skills and company names.",
"default": "python"
},
"location": {
"title": "Region filter",
"type": "string",
"description": "Optional. One or more regions separated by commas — English or Korean names (Seoul, 경기, Busan, Incheon) or JobKorea area codes (I000 Seoul, B000 Gyeonggi, I010 Seoul › Gangnam-gu). Leave empty for all of Korea.",
"default": ""
},
"careerType": {
"title": "Experience level",
"enum": [
"",
"1",
"2",
"4"
],
"type": "string",
"description": "Optional. Limit to entry-level (신입), experienced (경력) or postings open to any experience level (경력무관).",
"default": ""
},
"employmentType": {
"title": "Employment type",
"enum": [
"",
"1",
"2",
"3",
"4",
"6",
"7",
"8"
],
"type": "string",
"description": "Optional. Limit to one employment type.",
"default": ""
},
"sortBy": {
"title": "Sort order",
"enum": [
"RelevanceDesc",
"RegDtDesc",
"EditDtDesc",
"ApplyCloseDtAsc",
"ReadCntDesc",
"ApplicantDesc"
],
"type": "string",
"description": "How JobKorea orders the results before the scraper walks through them. Use Newest first for daily monitoring.",
"default": "RelevanceDesc"
},
"maxItems": {
"title": "Max jobs",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Maximum number of postings to return (JobKorea pages 20 at a time). Keep it small for a quick test, raise it for a full export.",
"default": 50
},
"includeDetails": {
"title": "Include detail page data",
"type": "boolean",
"description": "Visit each posting to add the full job description text, street address with coordinates, exact salary as posted, working hours, application channels / external apply URL, headcount and the exposed HR contact. Two extra requests per posting, so it is noticeably slower — the search results already include title, company, region, salary range, experience, education, employment type, benefits, skills and deadline without it.",
"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
}
}
}
}
}
}
}
}
}
}