{
  "openapi": "3.0.1",
  "info": {
    "title": "Saramin Scraper - Korea Jobs, Salaries & Company Details",
    "description": "Scrape Saramin (saramin.co.kr) job listings by keyword, filters or URL. Extract job titles, companies, salaries, experience requirements, locations, GPS coordinates, benefits, full descriptions, application deadlines and company details.",
    "version": "0.1",
    "x-build-id": "70ssLhUSotp85ngFR"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/abotapi~saramin-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-abotapi-saramin-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/abotapi~saramin-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-abotapi-saramin-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/abotapi~saramin-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-abotapi-saramin-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": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "What do you want to scrape?",
            "enum": [
              "search",
              "url"
            ],
            "type": "string",
            "description": "Search runs the keywords and filters below. URL mode scrapes the Saramin links you paste (search, list, company, job and more) and ignores the search fields.",
            "default": "search"
          },
          "searchTerms": {
            "title": "Search keywords",
            "type": "array",
            "description": "One keyword per line, Korean or English (for example python, 간호사, 마케팅). Each keyword is walked page by page, 40 jobs per page, until Max items is reached. Leave empty to run on the filters alone.",
            "default": [
              "python"
            ],
            "items": {
              "type": "string"
            }
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "relation",
              "accuracy",
              "reg_dt",
              "edit_dt",
              "closing_dt",
              "apply_cnt",
              "employ_cnt"
            ],
            "type": "string",
            "description": "Order of the results for every keyword.",
            "default": "relation"
          },
          "location": {
            "title": "Work area",
            "enum": [
              "any",
              "101000",
              "102000",
              "108000",
              "106000",
              "104000",
              "105000",
              "103000",
              "107000",
              "118000",
              "109000",
              "110000",
              "111000",
              "112000",
              "113000",
              "114000",
              "115000",
              "116000",
              "117000",
              "210000"
            ],
            "type": "string",
            "description": "Keep only jobs located in this region. Any area keeps all.",
            "default": "any"
          },
          "experience": {
            "title": "Experience level",
            "enum": [
              "any",
              "1",
              "2"
            ],
            "type": "string",
            "description": "Entry level or experienced hires. Any keeps all.",
            "default": "any"
          },
          "education": {
            "title": "Education level",
            "enum": [
              "any",
              "6",
              "7",
              "8",
              "9"
            ],
            "type": "string",
            "description": "Keep only jobs asking for exactly this education level. Any keeps all.",
            "default": "any"
          },
          "jobTypes": {
            "title": "Employment types",
            "type": "array",
            "description": "Keep only jobs of these employment types. Empty keeps all.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "4",
                "5",
                "9",
                "14",
                "8",
                "6",
                "3",
                "12",
                "7"
              ],
              "enumTitles": [
                "Full-time",
                "Contract",
                "Intern",
                "Part-time job",
                "Freelancer",
                "Part",
                "Commissioned",
                "Dispatched",
                "Military service substitute",
                "Trainee",
                "Overseas work"
              ]
            }
          },
          "categoryCodes": {
            "title": "Job categories",
            "type": "array",
            "description": "Optional. Job categories to keep, one per line, by plain name: a Saramin job group (for example IT개발·데이터, Marketing, Sales) or a job (for example 백엔드/서버개발, backend, nurse). English names work for the common ones. A numeric code (the cat_kewd value of a Saramin category link, for example 84) also works. Names that are not recognised are reported in the log and ignored.",
            "items": {
              "type": "string"
            }
          },
          "industryCodes": {
            "title": "Industries",
            "type": "array",
            "description": "Optional. Industries to keep, one per line, by plain name: a Saramin industry group (for example 게임, banking, hotel) or an industry (for example 의료기기, hospital). English names work for the common ones. A numeric code (the ind_key value of a Saramin industry link, for example 70115) also works. Names that are not recognised are reported in the log and ignored.",
            "items": {
              "type": "string"
            }
          },
          "urls": {
            "title": "Saramin links",
            "type": "array",
            "description": "Saramin links, one per line. Accepted: a search link (saramin.co.kr/zf_user/search/recruit?searchword=..., filters, sort and page in the link are kept), the category, industry and area list links, the public sector, headhunting and top 100 list pages (first page of jobs), a company link (all its open jobs), a sitemap link (jobs of the first companies listed), and a job link (desktop or mobile). Tracking parameters are ignored. Other pages carry no job list and are skipped with a warning. Filter fields are ignored in this mode.",
            "default": [
              "https://www.saramin.co.kr/zf_user/search/recruit?searchword=python&recruitPage=2&recruitPageCount=40",
              "https://www.saramin.co.kr/zf_user/search?searchType=search&searchword=python&loc_mcd=101000&exp_cd=1&edu_min=8&job_type=1&sort=reg_dt",
              "https://www.saramin.co.kr/zf_user/search/get-recruit-list?searchword=python&recruitPage=2&recruitPageCount=40&recruitSort=relation&mainSearch=n",
              "https://www.saramin.co.kr/zf_user/jobs/list/job-category?cat_kewd=84",
              "https://www.saramin.co.kr/zf_user/jobs/list/industry?ind_key=70115",
              "https://www.saramin.co.kr/zf_user/jobs/list/domestic?loc_mcd=101000",
              "https://www.saramin.co.kr/zf_user/jobs/relay/view?rec_idx=55177767",
              "https://www.saramin.co.kr/zf_user/jobs/relay/view-ajax?rec_idx=55177767",
              "https://www.saramin.co.kr/zf_user/jobs/relay/view-detail?rec_idx=55177767&rec_seq=0&view_type=search",
              "https://www.saramin.co.kr/zf_user/company-info/view?csn=RUFVUitvUW14QXBSUWQ4R2JaQ3J6Zz09",
              "https://www.saramin.co.kr/zf_user/company-info/view-inner-recruit?csn=RUFVUitvUW14QXBSUWQ4R2JaQ3J6Zz09",
              "https://m.saramin.co.kr/job-search/view?rec_idx=55177767",
              "https://www.saramin.co.kr/zf_user/jobs/public/list",
              "https://www.saramin.co.kr/zf_user/jobs/list/headhunting",
              "https://www.saramin.co.kr/zf_user/jobs/hot100",
              "https://www.saramin.co.kr/sitemapindex.xml"
            ],
            "items": {
              "type": "string"
            }
          },
          "fetchDetails": {
            "title": "Add job details",
            "type": "boolean",
            "description": "Open each job to add the full description, benefits, application method, start and closing dates, address with coordinates, view count and the company block. Off returns the listing fields only. Job links always open the job.",
            "default": true
          },
          "fetchCompanyProfile": {
            "title": "Add company profile",
            "type": "boolean",
            "description": "With job details on, also open the company page once per company to add employee count, revenue, founding date, group affiliation and company description.",
            "default": true
          },
          "maxPages": {
            "title": "Max pages per search",
            "minimum": 0,
            "type": "integer",
            "description": "Optional. Search result pages to walk per keyword or link. This does not cap the run by default: empty or 0 means no page limit and it defers to Max items, which is the one default cap (20)."
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 0,
            "type": "integer",
            "description": "The single default cap of the run: maximum jobs to return across the whole run (default 20). Max pages has no finite default and defers to this field. 0 means no limit. In incremental mode, unchanged jobs count toward this number.",
            "default": 20
          },
          "proxy": {
            "title": "Proxy",
            "type": "object",
            "description": "Proxy settings. The default Apify Proxy works for this site. Residential proxies are recommended for the most reliable results; they are billed by traffic on your account, so they cost more. If the selected connection is refused, the run switches to a backup connection on its own. You can also enter your own proxy URLs; if your proxy re-signs HTTPS traffic, the run says so in the log and reads through it without certificate verification for that proxy only.",
            "default": {
              "useApifyProxy": true
            }
          },
          "resumeFromRunId": {
            "title": "Resume from run ID",
            "type": "string",
            "description": "Run ID (or dataset ID) of a previous run of this Actor. Jobs 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 job is returned as NEW the first time and as UPDATED when a tracked field changes: title, location, address, experience, education, employment type, salary, start and closing dates, categories, tags, benefits, description, application method and the company fields. Unchanged jobs are not returned or billed. Never compared: rank, search keyword, collection time, view, scrap and open-job counters, ranking badges, the closing countdown text, the open or closed status and the company logo link. State is kept per tracked search or link set, 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 or links."
          },
          "baselineDatasetId": {
            "title": "Start from an existing dataset (incremental mode only)",
            "type": "string",
            "description": "Optional. Pick the dataset of an earlier full run of this Actor so the first incremental run returns only jobs that changed since then. Pick it unedited. Only used on the first run for a state key and not combined with Resume."
          },
          "emitExpired": {
            "title": "Emit expired jobs (incremental mode only)",
            "type": "boolean",
            "description": "Off by default. Also returns jobs that were tracked before and are no longer found, marked EXPIRED. Only produced after a complete scan, never when Max items, Max pages, a pasted page beyond 1, a list page link or Resume limited the run. These synthetic rows are returned and billed, so leave it off unless you need expiry tracking.",
            "default": false
          },
          "expireAfterMissedScans": {
            "title": "Expire after N missed full scans (incremental mode only)",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Only used with Emit expired jobs. A job is marked EXPIRED only after it was missing from this many complete scans in a row (default 1). Raise it so a job that briefly drops out of the results is not reported as gone.",
            "default": 1
          },
          "ignoreFieldsForChanges": {
            "title": "Ignore fields when detecting changes (incremental mode only)",
            "type": "array",
            "description": "Extra field names that must not mark a job as UPDATED in incremental mode. Rank, counters, badges, the countdown text and the status are already ignored. Use a dotted name such as benefits.items to ignore one key inside every benefit group.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}