# Saramin Scraper: South Korea Jobs & Pay \[USD 0.89/1K] (`usefulapi/saramin-scraper`) Actor Scrape Saramin (saramin.co.kr) jobs in South Korea, newest first: title, company, region and district, experience, education, job type, pay in KRW only when the ad names its unit, application period, work address, benefits, full description. USD 0.89 per 1,000 jobs. - **URL**: https://apify.com/usefulapi/saramin-scraper.md - **Developed by:** [Useful API](https://apify.com/usefulapi) (community) - **Categories:** Jobs, Lead generation, Automation - **Security:** Limited permissions - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.89 / 1,000 jobs This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Saramin Scraper: jobs in South Korea, newest first Scrape **Saramin** (saramin.co.kr), a Korean job site, newest first, by keyword, region, job type and experience: title, company and its website, region and district, experience, education, job type, pay in KRW when the ad names its unit (yearly, monthly, hourly), application period with times, work address with postal code and coordinates, work hours, probation, benefits, keyword tags, company facts and the full description. Export to CSV, Excel or JSON, or use the API. **USD 0.89 per 1,000 jobs.** No login, no browser. ### What you get - **Pay with its unit, never guessed:** "연봉 3,300 만원" gives 33,000,000 KRW per YEAR, "시급 10,320 원" gives 10,320 per HOUR, and "면접 후 결정" (decided after the interview) gives text only. Many ads state no figure: none of the 20 newest "python" ads in our test, 4 of 6 production jobs (생산직). - **Newest first,** so "Posted within" stops a search at the first page of older jobs. - **Saramin's own filters:** region, job type (regular, contract, intern, part-time, dispatch, freelance...), entry level or experienced, or a pasted search URL with any of its filters. - **Page-only facts:** application start and end with times, probation, work hours, apply method, benefits grouped by type, employer type (headhunter), company type, industry, staff, founded. - The recruiter's name and phone are never collected. ### Input examples ```json { "keywords": ["python"], "maxJobs": 200 } ``` Entry-level regular production jobs in Gyeonggi from the last 3 days, new ones only (daily schedule): ```json { "keywords": ["생산직"], "locations": ["Gyeonggi"], "jobType": "regular", "experience": "entry", "postedWithinDays": 3, "onlyNewJobs": true } ``` ### Example row From a saved Saramin job page (empty fields left out, description shortened): ```json { "jobId": "55271413", "title": "[정규직] 2026년 하반기 Java/Python 신입 개발자를 모집합니다.", "company": "(주)위즈온텍", "companyUrl": "http://www.wizontech.com", "companyLogoUrl": "https://clogo.saramin.co.kr/company/logo/202006/22/qcbfq3_kbmk-wvtg0m_logo.png", "location": "서울 중구", "city": "중구", "region": "서울", "country": "KR", "salaryMin": 33000000, "salaryMax": 33000000, "salaryCurrency": "KRW", "salaryPeriod": "YEAR", "salaryText": "연봉 3,300 만원 (주 40시간)", "employmentType": "FULL_TIME", "employmentTypeText": "정규직", "experienceLevel": "신입", "category": "IT개발·데이터", "skills": [ "Java", "Python", "웹개발" ], "datePosted": "2026-10-13T11:00", "validThrough": "2026-10-18T23:59", "descriptionText": "[정규직] 2026년 하반기 Java/Python 신입 개발자를 모집합니다. 모집분야 소프트웨어 개발(0명) 📋 주요업무 • java/python 기반 백앤드 개발 • react 기반 프론트앤드 개발 • docker/k8s 기반 시스템 구축 • ...", "jobUrl": "https://www.saramin.co.kr/zf_user/jobs/relay/view?rec_idx=55271413", "sourceBoard": "Saramin", "duplicateKey": "19076b86a657188d", "language": "ko", "extra": { "education": "대졸(4년제) 이상", "deadlineText": "오늘마감", "companyBadge": "연봉상승률 10% 이상", "companyId": "MUZOOUU0dFJOKzVTNmV0VEp6QlRkdz09", "probation": "2개월", "workHours": "09:30~18:30", "deadlineLabel": "오늘 마감", "applyMethod": "사람인 입사지원", "applicationForm": "자유양식", "benefits": { "지원금/보험": "각종 경조사 지원", "급여제도": "퇴직연금, 상여금, 장기근속자 포상, 4대 보험", "선물": "명절선물/귀향비, 생일자 조기퇴근, 장기근속 선물", "교육/생활": "창립일행사, 도서구입비지원, 자격증취득지원, 교육비 지원, 간식 제공, 음료제공(차,커피)", "근무 환경": "회의실, 공기청정기, 문턱 없음, 노트북, 사무용품 지급", "조직문화": "회식강요 안함, 야근강요 안함, 자유복장, 자유로운 연차사용, 칼퇴근 보장", "출퇴근": "야간교통비지급, 주 40시간제 시행", "리프레시": "연차, 여름휴가, 경조휴가제, 반차, 창립일휴무, 근로자의날 휴무" }, "workAddress": "서울 중구 을지로3가 을지비즈센터 805호", "companyType": "중소기업", "companyIndustry": "응용 소프트웨어 개발 및 공급업", "companyEmployees": "11 명 (2026년 기준)", "companyFounded": "2013년 4월 18일 (업력 14년차)", "companyAddress": "서울 중구 수표로 45, 805호 (저동2가,을지비즈센터)", "tags": [ "IT개발·데이터", "Java", "Python", "웹개발", "서울" ] } } ``` ### Good to know - Edited ads move into the newest-first order (they show a modified date), so the order is close to, not strictly, by date. - The first search page is large (about 2.4 MB), then each job page is about 0.45 MB. A 20-job run took 48 s, so 1,000 jobs with job pages take about 40 minutes. - With job pages off, rows keep the card fields: the pay as printed (no number), the registered date, the deadline. - Dates and times are as Saramin writes them (Korean time, no offset). - Education, salary and industry filters work only through a pasted search URL. - Korean personal names inside an ad's own text are not removed (emails and phones are). - Not given: apply link, a remote flag (`extra.remoteWork` only when the place says 재택근무 가능), skills as such (`skills` holds Saramin's keyword tags). ### Who uses it - **Recruiters and HR firms in Korea:** the newest jobs by keyword, region and job type every day. - **Pay research:** stated yearly, monthly and hourly pay in KRW. ### Output: one row per job Every Actor in this family writes the same columns, so you can merge boards in one sheet or database. | Field | What it holds | |---|---| | `jobId` | The board's own job id | | `title`, `company` | Job title and hiring company (as the board shows them) | | `companyUrl`, `companyLogoUrl` | Company page and logo on the board, when given | | `location`, `city`, `region`, `postalCode`, `country` | Location as shown, and its parts; `country` is an ISO code (FR, DE, US...) | | `remote`, `workplaceType` | `true`/`false` and `remote`, `hybrid` or `onsite`, only when the board says so | | `salaryMin`, `salaryMax`, `salaryCurrency`, `salaryPeriod`, `salaryText` | Salary range as numbers, ISO currency, `HOUR`/`DAY`/`WEEK`/`MONTH`/`YEAR`; empty when the board gives none (never guessed) | | `employmentType`, `employmentTypeText` | `FULL_TIME`, `PART_TIME`, `TEMPORARY`, `INTERN`, `APPRENTICE`, `CONTRACTOR`, `FREELANCE`..., and the board's own wording | | `experienceLevel`, `category`, `skills` | When the board gives them | | `datePosted`, `validThrough` | ISO 8601 dates | | `descriptionText`, `descriptionHtml` | Full description as plain text and as HTML | | `applyUrl`, `jobUrl` | Where to apply, and the job's page on the board | | `sourceBoard`, `searchLabel`, `scrapedAt` | Which board, which of your searches found it, when | | `duplicateKey` | The same key for the same ad posted on several boards (or reposted): title without (m/w/d) or H/F tags, company without legal form, city, country. Use it to merge results from several of our board Actors | | `extra` | A few fields only this board has | Contact email addresses and phone numbers inside descriptions are removed: this Actor never collects recruiters' personal contact details. ### Job alerts: only new jobs, sent where you work 1. Switch on **Only new jobs since the last run** and schedule the Actor (daily, hourly). It remembers the jobs it has already delivered for the same searches and filters, in a key-value store on your own account (named job-boards-seen-), and saves only new ones. The first run delivers everything and remembers it. **Memory name** shares one memory between schedules, or starts fresh. 2. Paste a **Slack or Discord webhook** (or a Zapier or Make webhook, which can email you) into **Send new jobs to**. After each run that found new jobs you get one message with the count and up to 10 jobs with their links. Free: the message is never billed. Apify's own integrations (Google Sheets, email, webhooks) work too. ### Pricing Pay per job saved: **USD 0.89 per 1,000 jobs** (USD 0.00089 a job), plus USD 0.002 per run start. No monthly rental, no charge for jobs skipped as duplicates, already seen or filtered out. Set a maximum cost per run in Apify and the Actor stops just before it, keeping everything saved so far. ### Use it through the API ```bash curl -X POST "https://api.apify.com/v2/acts/usefulapi~saramin-scraper/run-sync-get-dataset-items?token=YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"keywords":["python"],"maxJobs":20}' ``` Python: `ApifyClient("YOUR_API_TOKEN").actor("usefulapi/saramin-scraper").call(run_input={...})`, then read the dataset items. ### Good to know - **Polite by design:** one request at a time per site with a pause between requests, and the site's robots.txt is followed. Runs read public job pages only: no login, no candidate profiles or CVs. - **What a run summary tells you:** the `OUTPUT` record has jobs saved per search, jobs skipped (duplicates, seen before, too old) and why a run stopped early, if it did. - **Is it legal?** The Actor reads job ads that the board publishes openly, the same pages a job seeker sees. You are responsible for how you use the data (for example, the board's terms and data protection rules in your country). - **Found a problem?** Open an issue on the Issues tab: we answer quickly. # Actor input Schema ## `keywords` (type: `array`): One search per line, in Korean or English (python, 간호사, 회계, 영업). Saramin's own search matches the title, the text and the skills. ## `locations` (type: `array`): Korean regions, one search each per keyword: Seoul, Gyeonggi, Busan, Daegu, Incheon, Daejeon, Ulsan, Gwangju, Sejong, Gangwon, Chungbuk, Chungnam, Jeonbuk, Gyeongbuk, Gyeongnam, Jeju, Nationwide (or in Korean, 서울, 경기...). Leave empty for all of Korea. ## `jobType` (type: `string`): Only jobs of this type. ## `experience` (type: `string`): Entry level (신입, includes jobs open to all), experienced (경력), or any. ## `sort` (type: `string`): Newest first (default; with 'posted within' a search stops at the first page of older jobs) or Saramin's relevance order. ## `startUrls` (type: `array`): Paste search result URLs such as https://www.saramin.co.kr/zf_user/search/recruit?searchword=python\&loc_mcd=101000. Page numbers and tracking parameters are dropped. When given, the fields above are ignored. ## `maxJobs` (type: `integer`): Stop after saving this many jobs (across all searches). You pay only for jobs saved. ## `postedWithinDays` (type: `integer`): Only jobs published in the last N days. 0 = any date. ## `onlyNewJobs` (type: `boolean`): Remembers the jobs already delivered for these searches (in a key-value store on your account) and saves only jobs not seen before. Ideal for daily or hourly schedules and job alerts. The first run delivers everything and remembers it. ## `stateKey` (type: `string`): Use the same name on several schedules to share one memory, or a new name to start fresh. Letters, digits, - and \_. Empty = one memory per set of searches. ## `includeDetails` (type: `boolean`): Reads each job's own page for the full description and extra fields. Turn off for faster runs with list fields only (same price per job). ## `notifyUrl` (type: `string`): Paste a Slack or Discord webhook link, or a Zapier or Make webhook (which can email you). After each run that saved jobs you get one message with the count and up to 10 jobs with their links. With 'Only new jobs' on and a schedule, this is a free job alert. Not billed. ## `descriptionFormat` (type: `string`): Plain text, HTML, both, or none (smaller datasets). ## `maxJobsPerSearch` (type: `integer`): Cap for each search line, so one broad search does not use up the whole run. 0 = no cap. ## `proxyConfiguration` (type: `object`): Not needed for Saramin in our tests. Apify datacenter proxy or your own proxies only; residential proxy is not supported. ## Actor input object example ```json { "keywords": [ "python" ], "sort": "newest", "maxJobs": 20, "postedWithinDays": 0, "onlyNewJobs": false, "includeDetails": true, "descriptionFormat": "both", "maxJobsPerSearch": 0, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (type: `string`): One row per job, same columns on every board of this family. Download as CSV, Excel or JSON. ## `summary` (type: `string`): Jobs saved per search, jobs skipped (duplicates, seen before, too old), pages read and why the run stopped early (if it did). # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "python" ], "maxJobs": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("usefulapi/saramin-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keywords": ["python"], "maxJobs": 20, } # Run the Actor and wait for it to finish run = client.actor("usefulapi/saramin-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keywords": [ "python" ], "maxJobs": 20 }' | apify call usefulapi/saramin-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,usefulapi/saramin-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/ZqPBqmaJse39QCfrb/builds/3TsflZJsHKck0eRrR/openapi.json