{
  "openapi": "3.0.1",
  "info": {
    "title": "JobKorea Scraper - Jobs, Salaries, Companies & Contacts",
    "description": "Scrape JobKorea (jobkorea.co.kr) job listings by keyword, region, career level or employment type. Extract job titles, salaries, deadlines, requirements, benefits, workplace locations, HR contacts, full descriptions and company profiles.",
    "version": "0.1",
    "x-build-id": "bYEOgXWmKtGtOyTaz"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/abotapi~jobkorea-job-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-abotapi-jobkorea-job-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/abotapi~jobkorea-job-scraper/runs": {
      "post": {
        "operationId": "runs-sync-abotapi-jobkorea-job-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/abotapi~jobkorea-job-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-abotapi-jobkorea-job-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": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "url"
            ],
            "type": "string",
            "description": "Search mode finds postings by keyword and filters. URL mode reads the links you paste: a search page, a posting, a company page or a listing page.",
            "default": "search"
          },
          "searchTerms": {
            "title": "Search keywords",
            "type": "array",
            "description": "Keywords to search in posting titles, companies and skills, for example python or 마케팅. One search runs per keyword. Leave empty to browse every posting with the filters below. Search mode only.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Regions",
            "type": "array",
            "description": "Only postings in these regions. Leave empty for all regions. Search mode only.",
            "items": {
              "type": "string",
              "enum": [
                "seoul",
                "gyeonggi",
                "incheon",
                "daejeon",
                "chungnam",
                "chungbuk",
                "jeonnamGwangju",
                "jeonbuk",
                "daegu",
                "gyeongbuk",
                "busan",
                "ulsan",
                "gyeongnam",
                "gangwon",
                "jeju",
                "nationwide"
              ],
              "enumTitles": [
                "Seoul",
                "Gyeonggi",
                "Incheon",
                "Daejeon",
                "Chungnam",
                "Chungbuk",
                "Jeonnam and Gwangju",
                "Jeonbuk",
                "Daegu",
                "Gyeongbuk",
                "Busan",
                "Ulsan",
                "Gyeongnam",
                "Gangwon",
                "Jeju",
                "Nationwide"
              ]
            }
          },
          "careerType": {
            "title": "Career level",
            "enum": [
              "",
              "newcomer",
              "experienced",
              "any"
            ],
            "type": "string",
            "description": "Only postings for this career level. Leave empty for every level. Search mode only.",
            "default": ""
          },
          "employmentTypes": {
            "title": "Employment types",
            "type": "array",
            "description": "Only postings of these employment types. Leave empty for all types. Search mode only.",
            "items": {
              "type": "string",
              "enum": [
                "permanent",
                "contract",
                "intern",
                "dispatch",
                "subcontract",
                "freelancer",
                "partTime",
                "trainee"
              ],
              "enumTitles": [
                "Permanent",
                "Contract",
                "Intern",
                "Dispatch",
                "Subcontract",
                "Freelancer",
                "Part-time",
                "Trainee"
              ]
            }
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "newest",
              "recentlyUpdated",
              "closingSoon",
              "mostViewed",
              "mostApplicants"
            ],
            "type": "string",
            "description": "Relevance follows the site's own ranking; Newest lists the most recently posted first; the other orders follow the site's own sort options. Search mode only.",
            "default": "relevance"
          },
          "urls": {
            "title": "Links",
            "type": "array",
            "description": "Multi-URL. Links to search pages (keyword and filters are read from the link), posting pages, company pages, listing pages and sitemaps. Filter fields above are ignored in this mode. Results continue from the page in the link.",
            "default": [
              "https://www.jobkorea.co.kr/Search/?stext=python",
              "https://www.jobkorea.co.kr/Search/?stext=python&tabType=recruit&Page_No=2",
              "https://www.jobkorea.co.kr/Search/?stext=python&local=I000&careerType=1&employmentType=1&orderBy=RegDtDesc",
              "https://www.jobkorea.co.kr/Recruit/GI_Read/50309869",
              "https://www.jobkorea.co.kr/Recruit/GI_Read/50309869?Oem_Code=C1&logpath=1&stext=python&listno=1&sc=630",
              "https://m.jobkorea.co.kr/Recruit/GI_Read/50309869",
              "https://m.jobkorea.co.kr/Search/Adv?Keyword=python",
              "https://m.jobkorea.co.kr/Search/?stext=python",
              "https://www.jobkorea.co.kr/recruit/joblist?menucode=local&localorder=1",
              "https://www.jobkorea.co.kr/recruit/joblist?menucode=duty",
              "https://www.jobkorea.co.kr/Theme/Main",
              "https://www.jobkorea.co.kr/Search/?stext=%EA%B3%A0%EC%98%81&tabType=corp",
              "https://www.jobkorea.co.kr/company/1774734/Info",
              "https://www.jobkorea.co.kr/company/1774734/Recruit",
              "https://www.jobkorea.co.kr/Recruit/Co_Read/C/153549?Oem_Code=C1",
              "https://www.jobkorea.co.kr/starter/",
              "https://www.jobkorea.co.kr/content/sitemapindex.xml",
              "https://www.jobkorea.co.kr/content/sitemapindex/company/company_0001.xml",
              "https://www.jobkorea.co.kr/content/sitemapindex/searchresult/searchresult_001.xml"
            ],
            "items": {
              "type": "string"
            }
          },
          "fetchDetails": {
            "title": "Fetch posting details",
            "type": "boolean",
            "description": "On (default): each posting is read in full, with requirements, pay, deadline, contact, description and company profile. Off: only the fields shown in the search results are returned and no detail charge applies. A pasted posting link is always read in full.",
            "default": true
          },
          "maxPages": {
            "title": "Max pages per search",
            "minimum": 0,
            "type": "integer",
            "description": "Does not cap the run: it has no default and defers to Max items, which is the only default cap. Leave empty or 0 to walk every result page; set it only to stop a search earlier."
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 0,
            "type": "integer",
            "description": "The one default cap on the run (20). Maximum postings to return across all searches and links. 0 means unlimited.",
            "default": 20
          },
          "proxy": {
            "title": "Proxy",
            "type": "object",
            "description": "Proxy settings. The default connection works on every plan. Residential is recommended for the most reliable results on large or frequent runs; it is billed by traffic on your account. If the selected connection is refused, the run switches to a backup connection on its own. You can also supply your own proxy URLs.",
            "default": {
              "useApifyProxy": true
            }
          },
          "resumeFromRunId": {
            "title": "Resume from run ID",
            "type": "string",
            "description": "Run ID (or dataset ID) of a previous run of this Actor. Postings already collected there are skipped, so this run returns only the delta. Leave empty for a normal run. For recurring monitoring of the same search, use Incremental mode instead."
          },
          "incrementalMode": {
            "title": "Incremental changes for scheduled runs",
            "type": "boolean",
            "description": "For recurring monitoring. A posting is returned as NEW the first time, and as UPDATED when a compared field changes: title, status, deadline, requirements, pay, benefits, workplace, contact, apply channels, description and company profile. Not compared (still in the row): the view count, the search position, badges and keyword tags, the company's open-posting count, company rank and the scrape time. Unchanged postings are not returned or billed. State is kept per search setup, or per State key when you set one.",
            "default": false
          },
          "stateKey": {
            "title": "State key",
            "type": "string",
            "description": "Optional name for a monitoring campaign. Runs sharing a key share their incremental state. Leave empty to scope it automatically to the search."
          },
          "emitExpired": {
            "title": "Emit expired postings (incremental mode only)",
            "type": "boolean",
            "description": "Off by default. Turn on to also return postings that were present in a previous run but are no longer found, marked EXPIRED. Only produced once a run has fully scanned a complete search from its first page, so never when Max items or Max pages capped it, when Resume was used, when a page could not be read, or for single posting, company, listing and sitemap links. This returns, and bills, extra rows.",
            "default": false
          },
          "expireAfterMissedScans": {
            "title": "Expire after missed scans (incremental mode only)",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "With Emit expired postings on, a posting is marked EXPIRED only after it was missing from this many consecutive complete scans (default 1). EXPIRED means it was no longer found in the search; a search drop and a removal look the same without opening each posting.",
            "default": 1
          },
          "ignoreFieldsForChanges": {
            "title": "Ignore fields when detecting changes (incremental mode only)",
            "type": "array",
            "description": "Field names that must not make a posting UPDATED, for example applicationEndAt or updatedAt. A dotted path such as careers.range ignores that key inside every entry while the rest is still compared. The fields stay in the returned row. Changing this list keeps your saved state, so it never causes a wave of UPDATED rows.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "mcpConnectors": {
            "title": "Pipe results into your apps (optional)",
            "type": "array",
            "description": "Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify Settings, Integrations, then select it here. The connector receives a condensed summary per item; the full record stays in the dataset. Leave empty to skip."
          },
          "notionParentPageUrl": {
            "title": "Notion parent page (Notion connector only)",
            "type": "string",
            "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors."
          },
          "maxNotifyListings": {
            "title": "Max items to export per connector",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Cap on items written to each connector per run. Does not affect the dataset.",
            "default": 50
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}