# Albamon Part-time Jobs Scraper (알바몬 알바) (`kasidesk/albamon-jobs-scraper`) Actor

Scrapes part-time job listings from Albamon (알바몬), Korea's biggest part-time job board. Returns titles, companies, hourly wages, work hours, locations and deadlines as structured JSON.

- **URL**: https://apify.com/kasidesk/albamon-jobs-scraper.md
- **Developed by:** [Kasidesk Studio](https://apify.com/kasidesk) (community)
- **Categories:** Jobs, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Albamon Part-time Jobs Scraper (알바몬 알바)

Scrapes part-time job listings from [Albamon](https://www.albamon.com), Korea's biggest part-time and hourly job board (200,000+ live listings). Search by keyword or paste a filtered list URL, and get structured JSON: job title, company, hourly wage, work hours, job categories, full workplace address, apply methods, deadline and posting time.

No login, no API key, no headless browser. Albamon renders its listing pages server-side, so this runs on plain HTTP crawling.

This is part of a three-actor Korean jobs suite: [Saramin](https://apify.com/kasidesk/saramin-jobs-scraper) covers full-time hiring with keyword search, [JobKorea](https://apify.com/kasidesk/jobkorea-jobs-scraper) covers corporate hiring by job category and region, and this one covers the part-time and hourly market, which is a different dataset entirely: hourly wages, shift times, store-level addresses.

### What the wage data is good for

The interesting thing about Albamon is that almost every listing carries an actual wage figure, normalized here into `wageAmount` (KRW, numeric) and `wageType` (hourly/daily/weekly/monthly/yearly). That makes it usable for real analysis: hourly wage levels by region or job category, how postings respond to minimum wage changes, staffing demand for franchises and retail chains, which neighborhoods are hiring. Recruiting tools and gig-economy products use the feed directly; researchers use the wage series.

Recruiting and staffing products also use it as hiring-signal data: which franchises, stores and neighborhoods are actively hiring hourly workers right now.

### Use with AI agents (MCP)

This actor works as a live tool for AI agents through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp), so an agent can query Korean part-time jobs mid-conversation ("find night-shift convenience store jobs in Gangnam paying over 12,000/hr"). Point your MCP client (Claude, Cursor, or any MCP-compatible agent) at:

```
https://mcp.apify.com?tools=kasidesk/albamon-jobs-scraper
```

For agent calls, set `maxItems` to 10-20 - responses come back in seconds and stay compact. Numeric `wageAmount` and English `wageTypeEn` let agents filter wages without handling Korean text.

### Input

```json
{
    "keywords": ["편의점", "카페"],
    "maxItems": 200
}
```

- `keywords` - each runs as its own search. Korean works best (it's what employers write in). Leave empty to scrape the full recent-jobs feed
- `listUrls` - optional. Paste Albamon list URLs from your browser, keeping any region/category filters you set on the site
- `maxItems` - total cap across all searches
- `proxyConfiguration` - leave the default (residential, KR). Korean job sites block datacenter IPs

### Output

One item per listing:

```json
{
    "id": "118311819",
    "title": "호텔(게스트하우스) 리셉션 / 객실청소(평일,주말) / 상주직원 구합니다",
    "company": "호텔 퍼스트스테이 명동",
    "url": "https://www.albamon.com/jobs/detail/118311819",
    "region": "중구",
    "neighborhood": "태평로2가",
    "wageAmount": 12000,
    "wageType": "시급",
    "wageTypeEn": "hourly",
    "workHours": "시간협의",
    "categories": ["호텔·리조트·숙박", "안내데스크·리셉션", "서비스 기타"],
    "applyMethods": ["온라인지원", "이메일지원"],
    "address": "서울 중구 세종대로 66 (태평로2가) 호텔 퍼스트스테이 명동",
    "deadline": "상시모집",
    "isOpenEnded": true,
    "postedAgo": "7분전",
    "postedAt": "2026-08-07T11:53:00.000Z"
}
```

Field names are English, wages are numeric, posting times are converted to ISO timestamps, and enum-ish values get English equivalents (`wageTypeEn`, `isOpenEnded`) - you don't need to read Korean to work with the output. Titles, company names and addresses stay in the original Korean, since that's the actual data.

### Notes

Only public data: no login, nothing from behind authentication, no personal data. Job postings are public advertisements. You're responsible for how you use the data.

`postedAt` is derived from Albamon's relative timestamps ("7분전"), so it's accurate to about a minute for fresh posts and gets coarser for older ones.

If a run comes back empty or a field stops populating, Albamon probably changed their markup. Open an issue and I'll usually have a fix out within a day - I run this daily myself, so breakage tends to get caught fast.

For full-time hiring, use the [Saramin scraper](https://apify.com/kasidesk/saramin-jobs-scraper) (keyword search) or the [JobKorea scraper](https://apify.com/kasidesk/jobkorea-jobs-scraper) (category and region browsing).

***

#### 한국어 안내

알바몬 채용공고를 로그인 없이 구조화된 JSON으로 수집합니다. 키워드 또는 알바몬 목록 URL을 입력하면 공고 제목, 회사명, 시급(숫자 변환), 근무시간, 업직종, 근무지 주소, 접수방법, 마감일, 등록 시각을 정리해서 반환합니다. 공개 데이터만 다루며 개인정보는 수집하지 않습니다. 문의는 Issues 탭으로 남겨주세요.

# Actor input Schema

## `keywords` (type: `array`):

Keywords to search for on Albamon, in Korean or English. Each keyword runs as its own search. Leave empty to scrape the full recent-jobs feed. Examples: 편의점, 카페, 물류

## `listUrls` (type: `array`):

Optional. Paste Albamon job-list URLs from your browser instead of (or on top of) keywords, keeping any region or category filters you set on the site. Must start with https://www.albamon.com/jobs

## `maxItems` (type: `integer`):

Total number of listings to collect across all keywords and URLs.

## `proxyConfiguration` (type: `object`):

Korean job sites block datacenter IPs, keep the residential default.

## Actor input object example

```json
{
  "keywords": [
    "편의점"
  ],
  "listUrls": [],
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "KR"
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "편의점"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "KR"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("kasidesk/albamon-jobs-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": ["편의점"],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "KR",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("kasidesk/albamon-jobs-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": [
    "편의점"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "KR"
  }
}' |
apify call kasidesk/albamon-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,kasidesk/albamon-jobs-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 <APIFY_API_TOKEN>` 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/zBRMaWqYXSohju7LH/builds/XCdrKjckt29aDiRHF/openapi.json