Albamon part-time map, Albamon Z and Gigmon data API

알바몬 (Albamon) is Workspear's (웍스피어) Android app for Korea's hourly and part-time 아르바이트 market. Jobseekers sign in with an Albamon ID or Kakao, Naver, Facebook, Google or Apple, then hunt nearby shifts on a Naver map, save scraps, set home filters by city/county/town, work period, week and time, and complete an Albamon Z matching resume covering locations, job parts and a wished schedule. Franchise-store accounts and employers follow interest-corporation pins on the same map; Gigmon is the in-app gig chat and short-task trade layer. In Korea it is Jobkorea's hourly sibling, aimed at students, teens under minor-of-law rules, and short-term retail, F&B and logistics 알바 rather than white-collar career boards.

Each map pin hydrates into a recruit card keyed by recruitNo, carrying companyName, hourly pay/payType, workplaceAddress, closingDDay and an useAlbamonZ flag.

Home filters persist Korean cityCode/countyCode/townCode areas plus workPeriodTypes and a map radius; Albamon Z resumes expose resumeNo, wishWorkTimes and a match key/value triad, while Gigmon chat cards add talent_No, trade_No and trade_Stat_Code. Workforce dashboards can overlay neighbourhood 알바 density, HR tools can watch matching and interest-corporation folders, and marketplace bots can track short-task trade state — openData Studio turns those fields into callable open data.

Screenshots

API surface

The endpoints and request/response examples below are reconstructed from the app's interface — illustrative, not a live capture.

Member login session

POST /v1/members/session osint

Signs a personal, franchise or social member in and returns accessToken, memberNo, minorOfLaw and gigmonMemberNo used on later listing and Gigmon calls.

Auth: No prior session. Request headers AM_App_No=17, Key_No, App_Ver and App_VerCode. Response sets session cookies (mapp_nid, appnewid) and returns accessToken for later calls.

accessToken
age
agreeCollectionAndUsePersonalInfoForMarketing
agreeReceiveEmailAndSms
appLoginKey
birthDay
certificationStatus
email
genderType
gigmonMemberNo
loginTime
formattedLoginTime
memberId
memberName
memberNo
memberType
minorOfLaw
snsType
franchiseBrandCode
franchiseStoreCode
franchiseStoreName
captchaKey

POST /v1/members/session HTTP/1.1
Content-Type: application/json
AM_App_No: 17
Key_No: <app-key>
App_Ver: 5.4.20
App_VerCode: 301

{
  "memberId": "seeker01",
  "memberPassword": "********",
  "memberType": "PERSONAL",
  "captchaKey": ""
}

{
  "accessToken": "eyJhbGciOiJIUzI1NiJ9.example",
  "age": 24,
  "agreeCollectionAndUsePersonalInfoForMarketing": false,
  "agreeReceiveEmailAndSms": true,
  "appLoginKey": "alk_9f2a",
  "birthDay": "2001-04-12",
  "certificationStatus": true,
  "email": "[email protected]",
  "genderType": {"description": "여성", "key": "W", "value": 2},
  "gigmonMemberNo": "882145",
  "loginTime": "2026-10-02T09:14:22+09:00",
  "formattedLoginTime": "2026.10.02 09:14",
  "memberId": "seeker01",
  "memberName": "김민지",
  "memberNo": 4412891,
  "memberType": {"description": "개인회원", "key": "PERSONAL", "value": "PERSONAL"},
  "minorOfLaw": false,
  "snsType": {"description": "카카오", "key": "KAKAO", "value": "KAKAO"},
  "franchiseBrandCode": null,
  "franchiseStoreCode": null,
  "franchiseStoreName": null
}

Home job filters

GET /v1/home/filter-set opendata

Loads the saved home-tab filter: Korean admin areas, job-part codes, work period/week/time windows and an optional map radius.

Auth: Session cookies mapp_nid / appnewid plus AM_App_No, Key_No, App_Ver and App_VerCode headers. Optional accessToken after login.

id
condition
commonCondition
areas
cityCode
countyCode
townCode
parts
categoryCode
code
excludeBar
workPeriodTypes
workWeekTypes
workDayTypes
excludeNegoWorkWeek
workTimeTypes
startWorkTime
endWorkTime
excludeNegoWorkTime
areaSearchType
map
latitude
longitude
radius
name

GET /v1/home/filter-set HTTP/1.1
AM_App_No: 17
Key_No: <app-key>
App_Ver: 5.4.20
App_VerCode: 301
Cookie: mapp_nid=<nid>; appnewid=<id>
Accept: application/json

{
  "id": "cond_home_1",
  "condition": {
    "commonCondition": {
      "areas": [{"cityCode": "11", "countyCode": "110", "townCode": "1101"}],
      "parts": [{"categoryCode": "SVC", "code": "CS010"}],
      "excludeBar": true,
      "workPeriodTypes": ["SHORT"],
      "workWeekTypes": ["WEEKDAY"],
      "workDayTypes": ["MON", "TUE", "WED", "THU", "FRI"],
      "excludeNegoWorkWeek": false,
      "workTimeTypes": ["EVENING"],
      "startWorkTime": "18:00",
      "endWorkTime": "23:00",
      "excludeNegoWorkTime": false,
      "areaSearchType": "AREA",
      "map": {"latitude": 37.5665, "longitude": 126.9780, "radius": 2000, "name": "서울 중구"}
    }
  }
}

Search suggestions

GET /v1/search/suggest opendata

Typeahead for the keyword-search screen: each hit carries keyword, featureCode, featureName and a deep-link url.

Auth: Session cookies plus AM_App_No, Key_No, App_Ver and App_VerCode headers.

keyword
suggestions
featureCode
featureName
url
size
mobile

GET /v1/search/suggest?keyword=%EC%BB%A4%ED%94%BC&size=8&mobile=true HTTP/1.1
AM_App_No: 17
Cookie: mapp_nid=<nid>; appnewid=<id>
Accept: application/json

{
  "keyword": "커피",
  "suggestions": [{
    "keyword": "커피전문점",
    "featureCode": "PART",
    "featureName": "직종",
    "url": "/search?keyword=%EC%BB%A4%ED%94%BC%EC%A0%84%EB%AC%B8%EC%A0%90"
  }]
}

Area codes from coordinate

POST /v1/geo/admin-areas opendata

Resolves a GPS point to Korean city/county/town type-code pairs used to seed the home filter areas list.

Auth: Session cookies plus AM_App_No, Key_No, App_Ver and App_VerCode headers.

latitude
longitude
content
type
code

POST /v1/geo/admin-areas HTTP/1.1
Content-Type: application/json
AM_App_No: 17
Cookie: mapp_nid=<nid>; appnewid=<id>

{
  "latitude": 37.5665,
  "longitude": 126.9780
}

{
  "content": [
    {"type": "CITY", "code": "11"},
    {"type": "COUNTY", "code": "110"},
    {"type": "TOWN", "code": "1101"}
  ]
}

Map recruit cards

POST /v1/map/shift-cards opendata

Hydrates map-selected recruitNos into listing cards: title, hourly pay, workplace geo, closing D-day and Albamon Z eligibility.

Auth: Session cookies plus AM_App_No headers. accessToken from POST /v1/members/session after sign-in.

collection
recruitNo
recruitTitle
companyId
companyName
logoUrl
latitude
longitude
distanceToWorkplace
workplaceAddress
workplaceArea
pay
payType
parts
workingPeriod
workingWeek
workingTime
closingDDay
closingDate
postedDate
scraped
existsMap
useAlbamonZ
managerPhoneNumber
postStatusType
recruitType
recruitListType
wishAreaNo
recruitNos

POST /v1/map/shift-cards HTTP/1.1
Content-Type: application/json
AM_App_No: 17
Cookie: mapp_nid=<nid>; appnewid=<id>

{
  "recruitListType": "MAP",
  "wishAreaNo": 11,
  "recruitNos": [88214501, 88214502]
}

{
  "collection": [{
    "recruitNo": 88214501,
    "recruitTitle": "주말 카페 홀서빙",
    "companyId": "C009918",
    "companyName": "한강커피",
    "logoUrl": "https://cdn.example.org/logo/c009918.png",
    "latitude": 37.5210,
    "longitude": 126.9240,
    "distanceToWorkplace": 420,
    "workplaceAddress": "서울 영등포구 여의동",
    "workplaceArea": "여의도",
    "pay": "11000",
    "payType": {"description": "시급", "key": "HOURLY", "value": 1},
    "parts": ["외식·음료"],
    "workingPeriod": "단기",
    "workingWeek": "주말",
    "workingTime": "10:00~18:00",
    "closingDDay": 5,
    "closingDate": "2026-10-08",
    "postedDate": "2026-09-28",
    "scraped": false,
    "existsMap": true,
    "useAlbamonZ": true,
    "managerPhoneNumber": "02-1234-5678",
    "postStatusType": {"description": "게재중", "key": "OPEN", "value": 1},
    "recruitType": {"description": "일반", "key": "NORMAL", "value": 0}
  }]
}

Map scrap toggle

POST /v1/map/bookmark opendata

Saves or unsaves a map listing; the ack echoes corpName, employment title and partName for the scrap toast.

Auth: Signed-in session cookies and accessToken from POST /v1/members/session.

recruitNo
scrap
corpName
empmntName
partName
resultCode
resultMessage
errorMessage

POST /v1/map/bookmark HTTP/1.1
Content-Type: application/json
AM_App_No: 17
Cookie: mapp_nid=<nid>; appnewid=<id>

{
  "recruitNo": 88214501,
  "scrap": true
}

{
  "corpName": "한강커피",
  "empmntName": ["주말 카페 홀서빙"],
  "partName": ["외식·음료"],
  "resultCode": 0,
  "resultMessage": "OK",
  "errorMessage": null
}

Nearby hotspot

POST /v1/map/nearby-cluster opendata

Tells the map whether a named 알바 hotspot sits inside the current radius, with hotspot code, name, lat/lng and arrow angle.

Auth: Session cookies plus AM_App_No headers. Optional accessToken after login.

latitude
longitude
radius
existsNearbyHotSpot
nearbyHotSpot
hCode
hName
hLatitude
hLongitude
hAngle
address

POST /v1/map/nearby-cluster HTTP/1.1
Content-Type: application/json
AM_App_No: 17
Cookie: mapp_nid=<nid>; appnewid=<id>

{
  "latitude": "37.5665",
  "longitude": "126.9780",
  "radius": "1500"
}

{
  "existsNearbyHotSpot": true,
  "nearbyHotSpot": {
    "hCode": 1101,
    "hName": "명동",
    "hLatitude": 37.5636,
    "hLongitude": 126.9826,
    "hAngle": 45,
    "address": "서울 중구 명동"
  }
}

Saved search condition

GET /v1/search/saved-suit opendata

Reads a saved 맞춤 (suit) search: si/gu/dong areas, hourly pay band, keyword exclude list and map zoom used by the detailed-search screen.

Auth: Signed-in session cookies and accessToken from POST /v1/members/session.

condition
conditionId
recruitListType
suitNo
areas
si
gu
dong
parts
categoryCode
categoryName
payCondition
payType
moreThanWon
lessThanWon
startWorkTime
endWorkTime
workPeriodTypes
workWeekTypes
excludeBar
excludeKeywords
includeKeyword
map
latitude
longitude
radius
zoom
suit
suitTitle
albamonZ
excludeHomeWork
quickStart

GET /v1/search/saved-suit?recruitListType=MAP&suitNo=12 HTTP/1.1
AM_App_No: 17
Cookie: mapp_nid=<nid>; appnewid=<id>
Accept: application/json

{
  "condition": {
    "conditionId": "suit_12",
    "recruitListType": "MAP",
    "areas": [{"si": "서울", "gu": "중구", "dong": "명동"}],
    "parts": [{"categoryCode": "SVC", "categoryName": "서비스", "code": "CS010", "name": "커피전문점"}],
    "payCondition": {"payType": "HOURLY", "moreThanWon": 10000, "lessThanWon": 15000, "payAddType": null},
    "startWorkTime": "18:00",
    "endWorkTime": "23:00",
    "workPeriodTypes": ["SHORT"],
    "workWeekTypes": ["WEEKEND"],
    "excludeBar": true,
    "excludeKeywords": ["유흥"],
    "includeKeyword": "카페",
    "map": {"latitude": 37.5665, "longitude": 126.9780, "radius": 2000, "zoom": 15},
    "suit": {"suitNo": 12, "suitTitle": "여의도 주말"},
    "albamonZ": {"excludeHomeWork": false},
    "quickStart": true
  }
}

Albamon Z resume

GET /v1/matching/short-resume osint

Returns the jobseeker's Albamon Z matching profile: resumeNo, preferred locations and parts, wished work times and notify/alarm window.

Auth: Signed-in session cookies and accessToken from POST /v1/members/session.

resumeNo
locations
parts
skills
schedule
wishWorkTimes
workPeriodType
description
key
value
notify
alarm
alarmOff
alarmOffStartTime
alarmOffEndTime
step

GET /v1/matching/short-resume HTTP/1.1
AM_App_No: 17
Cookie: mapp_nid=<nid>; appnewid=<id>
Accept: application/json

{
  "resumeNo": 55201,
  "locations": [{"cityCode": "11", "countyCode": "110"}],
  "parts": [{"categoryCode": "SVC", "code": "CS010"}],
  "skills": ["POS", "홀서빙"],
  "schedule": {
    "wishWorkTimes": ["18:00-23:00"],
    "workPeriodType": {"description": "단기", "key": "SHORT", "value": 1}
  },
  "notify": {
    "alarm": true,
    "alarmOff": false,
    "alarmOffStartTime": null,
    "alarmOffEndTime": null
  },
  "step": {"description": "작성완료", "key": "DONE", "value": 3}
}

Albamon Z match status
GET /v1/matching/ready-flag opendata
Reports whether the Albamon Z profile has completed the required match step (description/key/value triad).
Auth: Signed-in session cookies and accessToken from POST /v1/members/session.
- description
- key
- value
```
GET /v1/matching/ready-flag HTTP/1.1
AM_App_No: 17
Cookie: mapp_nid=<nid>; appnewid=<id>
Accept: application/json
```
```
{
  "description": "매칭 완료",
  "key": "MATCHED",
  "value": "DONE"
}
```

Interest-corporation map pins

GET /v1/employers/followed-pins opendata

Plots followed employers on the interest-corp map: each pin has companyId, lat/lng, clustered recruitList and listing count.

Auth: Signed-in session cookies and accessToken from POST /v1/members/session.

mTotalCount
mTotalPage
markerItem
orderNo
nameValue
code
latitudeValue
longitudeValue
partValue
url
count
recruitList
companyId
flag
isEvent
myLocationEnc
reqDateTime
ListUrl
myLocationStat
mapLat
mapLng
mapR
pinSize
isExcludeBar

GET /v1/employers/followed-pins?myLocationStat=1&mapLat=37.5665&mapLng=126.9780&mapR=2000&pinSize=40&isExcludeBar=true HTTP/1.1
AM_App_No: 17
Cookie: mapp_nid=<nid>; appnewid=<id>
Accept: application/json

{
  "mTotalCount": 12,
  "mTotalPage": 1,
  "markerItem": [{
    "orderNo": 1,
    "nameValue": "한강커피 여의도점",
    "code": "C009918",
    "latitudeValue": 37.5210,
    "longitudeValue": 126.9240,
    "partValue": "CS010",
    "url": "/corp/C009918",
    "count": "3",
    "recruitList": [88214501, 88214507],
    "companyId": "C009918",
    "flag": 0,
    "isEvent": false
  }],
  "myLocationEnc": "enc-loc",
  "reqDateTime": "2026-10-02T09:20:00+09:00",
  "ListUrl": "/interest/list"
}

Follow interest corporation
POST /v1/employers/follow opendata
Adds or updates a followed employer in a favorite-corporation folder and reports whether app-push for that corp is on.
Auth: Signed-in session cookies and accessToken from POST /v1/members/session.
- companyId
- favoriteCorporationFolderNumber
- isFavoriteCorporation
- isFavoriteCorporationDefaultFolder
- isAppPushStatus
- resultCode
- resultMessage
```
POST /v1/employers/follow HTTP/1.1
Content-Type: application/json
AM_App_No: 17
Cookie: mapp_nid=<nid>; appnewid=<id>

{
  "companyId": "C009918",
  "favoriteCorporationFolderNumber": "1",
  "isFavoriteCorporation": true,
  "isFavoriteCorporationDefaultFolder": true
}
```
```
{
  "isAppPushStatus": true,
  "resultCode": 0,
  "resultMessage": "OK"
}
```
Gigmon chat access token
POST /v1/gigs/chat-token osint
Mints the Gigmon chat Bearer token for the member identified by gigmonMemberNo from the Albamon login payload.
Auth: Form body after Albamon login. Response accessToken is sent as Bearer on later Gigmon chat and trade calls.
- gigmonMemberNo
- accessToken
```
POST /v1/gigs/chat-token HTTP/1.1
Content-Type: application/x-www-form-urlencoded

gigmonMemberNo=882145
```
```
{
  "accessToken": "gm_tok_7f3a9c2e"
}
```

Gigmon talent chat card

POST /v1/gigs/chat-card opendata

Loads a Gigmon gig card for chat: talent title and image, seller flag, person presence and trade_No / trade_Stat_Code.

Auth: Bearer accessToken from POST /v1/gigs/chat-token. Form-encoded FieldMap body.

talent_No
talent_Title
talent_Image
isSeller
talent_Stat_Code
talent_Stat_Message
talent_Stat_Sub_Message
person_Stat_Code
person_Stat_Message
trade_No
trade_Stat_Code
items

POST /v1/gigs/chat-card HTTP/1.1
Authorization: Bearer gm_tok_7f3a9c2e
Content-Type: application/x-www-form-urlencoded

talent_No=4412

{
  "talent_No": 4412,
  "talent_Title": "주말 전단지 배포",
  "talent_Image": "https://cdn.example.org/gigmon/4412.jpg",
  "isSeller": true,
  "talent_Stat_Code": "ON",
  "talent_Stat_Message": "거래가능",
  "talent_Stat_Sub_Message": "오늘 가능",
  "person_Stat_Code": "ONLINE",
  "person_Stat_Message": "접속중",
  "trade_No": 9901,
  "trade_Stat_Code": "START",
  "items": []
}

Where teams use this data

Hourly vacancy map with pay and D-day
A city labour dashboard can join map recruit cards on recruitNo with workplace latitude/longitude, payType and closingDDay, then overlay Korean 알바 density by neighbourhood.
Albamon Z matching watch
HR tooling can read resumeNo, wishWorkTimes and the match key/value status, then alert when a jobseeker's short resume becomes MATCHED against nearby parts.
Followed-employer pin sync
A recruiter CRM can poll interest-corporation pins for companyId, recruitList and isAppPushStatus to keep a folder of followed stores in sync with the jobseeker map.
Gigmon trade-state tracker
A marketplace bot can watch talent_No, trade_No and trade_Stat_Code on gig chat cards to flag START versus cancelled short-task trades.

Frequently asked questions

How does Albamon authenticate jobseekers?

POST /v1/members/session returns accessToken, memberNo, gigmonMemberNo and minorOfLaw, and the client stores session cookies (mapp_nid, appnewid). Later calls send those cookies plus AM_App_No, Key_No, App_Ver and App_VerCode. Gigmon chat uses a separate Bearer from POST /v1/gigs/chat-token.

What fields sit on a map listing card?

POST /v1/map/shift-cards returns collection items with recruitNo, recruitTitle, companyName, pay and payType, workplaceAddress, latitude/longitude, closingDDay, scraped and useAlbamonZ.

What is Albamon Z in the data model?

GET /v1/matching/short-resume is the short matching profile (resumeNo, locations, parts, wishWorkTimes, notify alarm window, step). GET /v1/matching/ready-flag is a description/key/value flag for whether that profile has finished matching.

Does Gigmon expose gig trade state?

POST /v1/gigs/chat-card returns talent_No, talent_Title, isSeller, person_Stat_Code, trade_No and trade_Stat_Code on the gig chat card used after the Gigmon access token is minted.

More Jobs & Careers apps

Topics

albamon
알바몬
part-time jobs Korea
아르바이트
albamon z
gigmon
recruitNo
job map API

Need this app's data API integrated?

We deliver scoped integrations for any named app — from USD 500 with source-code handoff, or hosted access billed per call. Tell us the data you need.

NDA + SOW on every engagement
Delivery in 3–7 days
Payment only after acceptance
Work scoped to authorized use

Get a quote

Albamon part-time map, Albamon Z and Gigmon data API

Screenshots

API surface

Member login session

Home job filters

Search suggestions

Area codes from coordinate

Map recruit cards

Map scrap toggle

Nearby hotspot

Saved search condition

Albamon Z resume

Albamon Z match status

Interest-corporation map pins

Follow interest corporation

Gigmon chat access token

Gigmon talent chat card

Data categories

Where teams use this data

Hourly vacancy map with pay and D-day

Albamon Z matching watch

Followed-employer pin sync

Gigmon trade-state tracker

Frequently asked questions

More Jobs & Careers apps

apna - Search Job, Vacancy App

Bumeran

Clickworker

Fiverr - Freelance Service

Topics

Need this app's data API integrated?