Zigbang Scraper - Korea Real Estate Listings & Agents

🏢 Zigbang Scraper — South Korea Real Estate Listings, Rental Prices & Agent Contacts

Extract structured South Korean property listings, rental prices, deposits, building specs, GPS coordinates, and real-estate agent contact details from Zigbang (직방) — Korea's leading mobile property platform. Collect one-room studios (원룸), officetels (오피스텔), and villas (빌라) across monthly rent (월세), jeonse (전세), and short-term rentals (단기) with optional English translations. No login, no coding.

Export to JSON, CSV, Excel, XML, or API for Korean real-estate market analytics, expat relocation platforms, proptech valuation models, and licensed broker/agent B2B lead generation.

---

⚡ At a glance

Capability	Details
🎯 Primary Target	Zigbang (zigbang.com) South Korea Rental & Officetel Property Listings
🏠 Property & Deal Types	One-room studios (원룸), Officetels (오피스텔), Villas (빌라) · Monthly Rent (월세), Jeonse (전세), Short-term (단기)
🧲 100% Agent Lead Gen	Every listing includes agentName, agentOffice, agentPhone, agentType, and agentAddress
🌐 Bilingual Output	Korean fields + optional English translations (salesTypeEn, serviceTypeEn, roomTypeEn, floorEn)
📈 Scale & Pagination	1,000+ results geographic pagination with automatic multi-ring geohash grid expansion
⚡ Prefill Speed	~15–30 seconds for 100 enriched listings over standard Apify Proxy
🛡️ Deduplication	Automatic cross-tile and cross-district deduplication by itemId
📦 Bulk Export	JSON, CSV, Excel (XLSX), JSON Lines, XML, HTML, REST API, Make, Zapier, n8n, Google Sheets

---

🔎 Why scrape Zigbang?

Zigbang (직방) is South Korea's premier mobile-first real-estate platform for one-room studios (원룸), officetels (오피스텔), and urban villas (빌라) across Seoul, Gyeonggi-do, Busan, Incheon, Daegu, and Daejeon. Every listing contains rich pricing data (quoted in Korean 만원 units alongside exact KRW equivalents), exclusive and contract floor areas (m² and 평 / pyeong), subway proximity, built-in appliances, high-resolution photos, and the licensed real-estate broker (공인중개사) who posted it.

Because Zigbang is a Korean-only, map-tile interface with no bulk download option, collecting this inventory manually is slow and error-prone. This Zigbang scraper and Zigbang data extractor turns the map into a structured, bilingual data feed:

• Build Korean real-estate agent & brokerage lead lists — extract agentName, agentOffice, agentPhone, agentType, and agentAddress with ~100% fill rate across active Seoul and metro brokerages.
• Monitor 월세 (monthly rent) and 전세 (jeonse deposit) trends — track deposit-to-rent ratios, maintenance fees (maintenanceCost), and price per pyeong across Gangnam, Mapo, Songpa, Yongsan, Bundang, and Haeundae.
• Power expat relocation & student housing portals — use includeEnglish: true plus depositKRW and rentKRW to display Korean rental inventory to international clients, students, and corporate transferees.
• Train Automated Valuation Models (AVMs) — combine exact GPS coordinates (lat, lng), nearby subway stations (subways[]), floor levels, building approval dates (approveDate), and room layouts (roomTypeEn).

---

✨ Key features of this Zigbang scraper

• ✅ Built-in dropdown of 22 top Korean districts & stations — launch immediately with one click across Gangnam-gu (강남구), Yeoksam-dong (역삼동), Mapo-gu (마포구), Hongdae (홍대입구역), Yongsan (용산구), Itaewon (이태원동), Yeouido (여의도동), Jamsil (잠실동), Bundang (성남시 분당구), and Haeundae (부산 해운대구).
• ✅ Custom Korean location geocoding (searchQueries) — type any Korean district (구), neighborhood (동), subway station (역), or university name; the actor geocodes the center point and sweeps surrounding map tiles.
• ✅ Unlocked 1,000+ geographic ring expansion — starts at the exact search center and radiates outward in concentric geohash rings. If a high maxItems target (e.g., 1,000+) exceeds the initial gridRadius, the scraper automatically expands outer rings (ring 2..4) and fallback districts until your target is reached.
• ✅ Dual-unit pricing & area normalization — outputs traditional Korean units (deposit & rent in 만원, areaPyeong in 평) right next to international units (depositKRW, rentKRW, areaM2, contractAreaM2).
• ✅ Complete broker contact extraction — captures the licensed agent's name, brokerage office title, phone number, role, and street address on every listing.
• ✅ English translation layer (includeEnglish) — translates 월세 → Monthly rent, 전세 → Jeonse (lump-sum deposit), 오피스텔 → Officetel, 분리형원룸 → Separated studio, and floor levels (반지하 → semi-basement, 옥탑 → rooftop).

---

🎯 High-value use cases

Industry / Team	How Teams Use This Zigbang Data Extractor
🧲 B2B Lead Generation & PropTech Sales	Build verified contact databases of active Korean real-estate agencies (agentOffice, agentName, agentPhone, agentAddress) by district.
🌏 Expat Relocation & Corporate Housing	Source English-translated studios and officetels near major business hubs (Gangnam, Yeouido, Jongno, Yongsan, Pangyo/Bundang).
📊 Real Estate Market & Jeonse Analysts	Track monthly shifts in jeonse deposits vs. monthly rents across Seoul's 25 districts (시군구) and neighborhoods (동).
🏦 Financial & Mortgage Research	Analyze deposit exposure, maintenance-cost inflation, and multi-unit residential supply around Seoul Metro subway lines.
🤖 AI Assistants & Housing Search Apps	Feed structured, geo-referenced Korean rental listings with photo arrays (images[]) and subway connections into AI search tools.

---

📥 Input parameters

All parameters are optional. Leaving location inputs empty automatically collects a diverse dataset from 16 major districts across Seoul, Gyeonggi, Incheon, Busan, and Daejeon.

Parameter	Type	Default / Prefill	Description
popularAreas	array<string>	[]	Select from 22 popular South Korean districts, neighborhoods, and subway hubs (e.g., 강남구, 마포구, 홍대입구역, 부산 해운대구).
searchQueries	array<string>	[]	Custom Korean location names (any 구, 동, subway station, or landmark) to geocode and scrape.
salesTypes	array<string>	["월세", "전세"]	Rental contract types to include: 월세 (Monthly rent), 전세 (Jeonse deposit), 단기 (Short-term rent).
depositMin / depositMax	integer	null	Filter by minimum/maximum security deposit in 만원 (1 = 10,000 KRW; e.g., 1000 = 10,000,000 KRW).
rentMin / rentMax	integer	null	Filter by minimum/maximum monthly rent in 만원 (e.g., 100 = 1,000,000 KRW/month).
includeEnglish	boolean	true	Append English translations (salesTypeEn, serviceTypeEn, roomTypeEn, floorEn) to every record.
maxItems	integer	0 (default) / 100 (prefill)	Maximum listings to save (0 = unlimited, or set 100, 1000, 5000, etc.).
geohashPrecision	integer	5	Map tile precision: 5 ≈ 4.9 km tile (recommended), 6 ≈ 1.2 km tile.
gridRadius	integer	1	Initial tile rings around each location (0 = center tile, 1 = 3×3 grid, 2 = 5×5, 3 = 7×7). Auto-expands when maxItems requires more coverage.
maxConcurrency	integer	10	Parallel detail-enrichment requests (1–30).
propertyUrls	array<string>	[]	Direct Zigbang listing URLs (https://www.zigbang.com/home/oneroom/items/50507317) to scrape directly.
itemIds	array<string>	[]	Direct numeric Zigbang listing IDs.
geohashes	array<string>	[]	Advanced: query specific geohash map tiles directly (e.g., ["wydm6", "wydm7"]).
proxyConfiguration	object	{ "useApifyProxy": true }	Apify Proxy configuration (enabled by default).

Example 1 — Fast 100-Listing Sample (Prefill)

{
  "popularAreas": [],
  "salesTypes": ["월세", "전세"],
  "includeEnglish": true,
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Example 2 — Bulk 1,200+ Seoul Listings (Gangnam, Mapo, Songpa, Yongsan)

{
  "popularAreas": ["강남구", "서초구", "마포구", "송파구", "용산구"],
  "salesTypes": ["월세", "전세", "단기"],
  "rentMax": 200,
  "depositMax": 30000,
  "includeEnglish": true,
  "maxItems": 1200,
  "gridRadius": 1,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Example 3 — Scrape Specific Subway Stations or Exact Listing URLs

{
  "searchQueries": ["홍대입구역", "역삼동", "건대입구역"],
  "propertyUrls": [
    "https://www.zigbang.com/home/oneroom/items/50507317"
  ],
  "maxItems": 500
}

---

📤 Output schema & field reference

Every listing is normalized into a single flat JSON object containing property identifiers, dual-unit pricing, dimensions, building specs, administrative addresses, GPS coordinates, nearby subways, photos, and licensed agent contact details.

Sample JSON output

{
  "itemId": 50507317,
  "url": "https://www.zigbang.com/home/oneroom/items/50507317",
  "salesType": "월세",
  "salesTypeEn": "Monthly rent",
  "serviceType": "오피스텔",
  "serviceTypeEn": "Officetel",
  "roomType": "쓰리룸",
  "roomTypeEn": "Three-room",
  "deposit": 10000,
  "rent": 550,
  "depositKRW": 100000000,
  "rentKRW": 5500000,
  "maintenanceCost": 30,
  "areaM2": 88.39,
  "contractAreaM2": 189.88,
  "areaPyeong": 26.74,
  "floor": "6",
  "floorEn": "6",
  "totalFloors": "20",
  "roomDirection": "W",
  "bathroomCount": "2",
  "elevator": true,
  "parkingAvailable": "주차 가능",
  "parkingCount": "총 주차 대수 497대",
  "moveinDate": "즉시 입주 가능",
  "approveDate": "2002.10.23",
  "options": ["에어컨", "세탁기", "인덕션", "옷장", "신발장", "싱크대"],
  "residenceType": "오피스텔",
  "title": "타워팰리스 해당면적 최저가 실매물 입니다.",
  "description": "안녕하세요 태원부동산입니다 ...",
  "address": "서울특별시 강남구 도곡동",
  "sido": "서울특별시",
  "sigungu": "강남구",
  "dong": "도곡동",
  "jibunAddress": "강남구 도곡동 467",
  "lat": 37.4880777,
  "lng": 127.05348,
  "subways": [
    { "name": "도곡역", "lines": "3호선,수인분당선" },
    { "name": "매봉역", "lines": "3호선" }
  ],
  "agentName": "안병근",
  "agentOffice": "주식회사태원부동산중개",
  "agentPhone": "025674944",
  "agentType": "대표공인중개사",
  "agentAddress": "서울특별시 강남구 테헤란로68길 34 1층 101호(대치동)",
  "viewCount": 14,
  "status": "open",
  "thumbnail": "https://ic.zigbang.com/ic/items/50507317/1.jpg",
  "images": [
    "https://ic.zigbang.com/ic/items/50507317/1.jpg",
    "https://ic.zigbang.com/ic/items/50507317/2.jpg"
  ],
  "updatedAt": "2026-10-27 10:10:15",
  "scrapedAt": "2026-11-10T02:50:00.000Z"
}

💰 Pricing, Area & Property Classification Fields

Field	Type	Coverage	Description
itemId	integer	🟢 High (100%)	Unique Zigbang listing ID (primary deduplication key).
url	string	🟢 High (100%)	Direct URL to the listing on zigbang.com.
salesType / salesTypeEn	string	🟢 High (100%)	Korean contract type (월세, 전세, 단기) and English label (Monthly rent, Jeonse (lump-sum deposit), Short-term rent).
serviceType / serviceTypeEn	string	🟢 High (100%)	Property type (원룸, 오피스텔, 빌라) and English label (One-room, Officetel, Villa / low-rise).
roomType / roomTypeEn	string	🟢 High (100%)	Unit layout (오픈형원룸, 분리형원룸, 투룸, 쓰리룸) and English translation (Open studio, Separated studio, Two-room, Three-room).
deposit / depositKRW	number	🟢 High (100%)	Security deposit in 만원 (10,000 KRW units) and exact absolute KRW.
rent / rentKRW	number	🟢 High (100%)	Monthly rent in 만원 and exact absolute KRW (0 on pure 전세 listings).
maintenanceCost	number | null	🟢 High (~95%)	Monthly building management fee (관리비) in 만원.
areaM2 / areaPyeong	number	🟢 High (100%)	Exclusive net floor area (전용면적) in square meters (m²) and Korean 평 (pyeong).
contractAreaM2	number | null	🟡 Conditional (~65%)	Gross/contract area (계약면적) in m² when reported for the building.

🏗️ Building Specs, Location & Subway Fields

Field	Type	Coverage	Description
floor / floorEn / totalFloors	string	🟢 High (100%)	Unit floor level (number or 저/중/고/반지하/옥탑), English translation, and total building floors.
roomDirection	string | null	🟢 High (~95%)	Window orientation (S, SE, E, W, N, etc.).
bathroomCount	string | null	🟢 High (~98%)	Number of bathrooms in the unit.
elevator	boolean | null	🟢 High (100%)	true if the building has an elevator.
parkingAvailable / parkingCount	string | null	🟢 High (~90%)	Parking availability text and total building parking spaces (when reported).
moveinDate / approveDate	string | null	🟢 High (~95%)	Available move-in date and building completion/approval date.
options	array<string>	🟢 High (~95%)	Included appliances & furniture (에어컨, 냉장고, 세탁기, 인덕션, 옷장, etc.).
address / jibunAddress	string	🟢 High (100%)	Administrative address and lot-number (지번) address.
sido / sigungu / dong	string	🟢 High (100%)	Province/City (시도), District (시군구), and Neighborhood (읍면동).
lat / lng	number	🟢 High (100%)	Exact WGS84 latitude and longitude coordinates.
subways	array<object>	🟢 High (~92%)	Nearby subway stations with station name and lines.

📞 Real Estate Agent Lead & Media Fields

Field	Type	Coverage	Description
agentName	string	🟢 High (100%)	Name of the listing broker (공인중개사).
agentOffice	string	🟢 High (100%)	Registered real-estate brokerage office name.
agentPhone	string	🟢 High (100%)	Direct telephone number of the listing agent/office.
agentType	string	🟢 High (~99%)	Broker license/role classification (e.g., 대표공인중개사, 소속공인중개사).
agentAddress	string	🟢 High (~99%)	Full street address of the real-estate agency office.
title / description	string	🟢 High (100%)	Listing headline and full broker description text.
thumbnail / images	string / array	🟢 High (~99%)	Primary thumbnail URL and array of all full-resolution property photos.
viewCount / status	integer / string	🟢 High (100%)	Listing view counter and availability status (open).
updatedAt / scrapedAt	string	🟢 High (100%)	Listing last-updated timestamp and UTC extraction timestamp.

---

🔁 Deep geographic pagination & 1,000+ scale

Unlike traditional portals that paginate with ?page=2, Zigbang indexes inventory spatially across geohash map tiles:

1. Center-first concentric rings: Each location query is geocoded to (lat, lng) and expanded into concentric geohash rings (ring 0 = center tile first, then ring 1 = 3×3 grid, ring 2 = 5×5 grid, etc.) so low maxItems runs always return listings closest to your target point.
2. Automatic ring expansion for 1,000+ runs: When you request maxItems: 1000 (or higher), if the initial gridRadius tiles do not contain enough unique listing IDs, the scraper automatically expands outward up to ring 4 (81 tiles per center) and includes over-fetch buffering so every detail record is populated up to your exact maxItems goal.
3. Parallel detail enrichment: Unique itemId values are enriched concurrently (maxConcurrency: 10 by default), delivering ~400–1,000 rich records in 1–3 minutes.

---

⚙️ How to run via API

Python SDK Example

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run = client.actor("haketa/zigbang-scraper").call(run_input={
    "popularAreas": ["강남구", "마포구", "용산구"],
    "salesTypes": ["월세", "전세"],
    "rentMax": 150,
    "includeEnglish": True,
    "maxItems": 500,
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"[{item['serviceTypeEn']}] {item['address']} | Deposit: {item['deposit']}만 / Rent: {item['rent']}만 | Agent: {item['agentName']} ({item['agentPhone']})")

Node.js SDK Example

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });

const run = await client.actor('haketa/zigbang-scraper').call({
    searchQueries: ['역삼동', '홍대입구역', '성남시 분당구'],
    salesTypes: ['월세', '전세'],
    maxItems: 1000,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Extracted ${items.length} unique Korean rental listings.`);

REST API (cURL) Example

curl -X POST "https://api.apify.com/v2/acts/haketa~zigbang-scraper/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "popularAreas": ["강남구", "서초구", "송파구", "마포구"],
    "salesTypes": ["월세", "전세"],
    "includeEnglish": true,
    "maxItems": 1000
  }'

---

🇰🇷 Korean real-estate terminology & unit conversion guide

If your analytics or product team works internationally, here is how Zigbang's core Korean real-estate concepts map to standard global metrics in the exported dataset:

Korean Term	Field(s)	English Meaning & Conversion Formula
월세 (Wolse)	salesType: "월세"	Monthly rent with a security deposit (deposit + monthly rent).
전세 (Jeonse)	salesType: "전세"	Lump-sum key-money deposit lease with 0 monthly rent (deposit only; returned at lease end).
단기 (Dangi)	salesType: "단기"	Short-term rental (flexible month-to-month or furnished short stay with low deposit).
만원 (Man-won)	deposit, rent, maintenanceCost	10,000 KRW unit. Multiply by 10,000 for exact KRW (already pre-calculated in depositKRW and rentKRW).
평 (Pyeong)	areaPyeong, areaM2	Traditional Korean floor-area unit (1 평 ≈ 3.3058 m² or 35.58 sq ft). Both areaM2 and areaPyeong are included.
전용면적 vs. 계약면적	areaM2, contractAreaM2	Exclusive net unit area (areaM2) vs. gross contract area including shared hallways/lobby (contractAreaM2).
오피스텔 (Officetel)	serviceType: "오피스텔"	Multi-story live/work studio or apartment building popular near subway stations.
원룸 / 투룸 / 쓰리룸	roomType, roomTypeEn	Studio (One-room), 1-bedroom/2-room (Two-room), and 2-bedroom/3-room (Three-room) layouts.
공인중개사	agentName, agentOffice, agentPhone	Licensed Korean real-estate broker and registered brokerage agency.

---

💡 Best practices for proptech & lead generation teams

• Deduplicate brokerages by agentPhone or agentOffice: When building a B2B contact database of Seoul real-estate agencies, scrape 1,000–2,000 listings across your target districts (sigungu) and group by agentPhone + agentOffice to rank the most active listing brokers by inventory volume.
• Use neighborhood (동) or station (역) queries for hyper-local density: Combine popularAreas with specific stations in searchQueries (such as 성수역, 판교역, 신논현역, 서울대입구역) and geohashPrecision: 6 for fine-grained station-area pricing.
• Filter out outliers with depositMax and rentMax: Setting budget ceilings at source keeps your dataset focused on your exact target segment (e.g., student/young-professional studios vs. luxury Gangnam three-room officetels).

---

⚠️ Honest limitations

• Rental inventory focus (월세, 전세, 단기): Zigbang's one-room/officetel/villa map feed covers rental and jeonse listings rather than apartment purchase (매매) transactions.
• Korean location names for custom searchQueries: While popularAreas offers English labels in the dropdown, custom free-text searchQueries should be entered in Korean (e.g., 강남구, 연남동, 잠실역) for accurate geocoding.

---

❓ Frequently asked questions

What does 만원 mean in the deposit and rent fields?

In South Korea, real-estate prices are quoted in 만원 (man-won), where 1 만원 = 10,000 KRW (roughly $7.20 USD). For example, deposit: 1000 and rent: 80 means a 10,000,000 KRW deposit and 800,000 KRW monthly rent. For convenience, the actor also computes depositKRW (10000000) and rentKRW (800000) on every record.

Can non-Korean speakers use the exported dataset?

Yes. With includeEnglish: true (enabled by default), key classification fields (salesTypeEn, serviceTypeEn, roomTypeEn, floorEn) are translated into English, and areas are provided in both square meters (areaM2) and pyeong (areaPyeong).

How do I collect 1,000+ listings in one run?

Simply set maxItems: 1000 (or 0 for unlimited) and pick one or more areas in popularAreas (or leave popularAreas empty to sweep 16 top metro districts). The scraper automatically expands its tile grid to fulfill 1,000+ unique listings.

Do I need Korean residential proxies?

Standard Apify Proxy ({ "useApifyProxy": true }) works out of the box with high speed and reliability.

Can I combine popularAreas, searchQueries, propertyUrls, and itemIds in one run?

Yes. All four targeting inputs can be used simultaneously. Every discovered listing ID is merged into a single deduplicated set before detail enrichment, guaranteeing zero duplicate listings in your dataset.

What happens if I run the actor with an empty input {}?

When launched with {} (no areas, queries, URLs, or explicit limit), the actor automatically samples 100 listings across 16 major South Korean districts so you get an instant, diverse preview of the dataset.

---

🔗 Related Asian & global real-estate scrapers

• Kakao Map Scraper — South Korea local businesses, POIs, addresses, and phone numbers.
• PropertyGuru Real Estate Scraper — Southeast Asia property listings and agent contacts.
• 99.co Singapore Real Estate Scraper — Singapore condo and HDB rental/sale listings.
• Domain.com.au Property Scraper — Australia real-estate listings and agency leads.

---

📋 Changelog

• v1.2 (2026-11) — Unlocked 1,000+ deep geographic pagination (removed the 100-item ceiling when maxItems > 100 is passed on default/no-filter runs, added automatic concentric geohash ring expansion ring 2..4 when maxItems exceeds the initial gridRadius, expanded default Korean metro coverage to 16 districts, and added a 15% ID buffer so detail runs hit exact maxItems targets).
• v1.1 (2026-10) — Updated to Zigbang's current property tile endpoint, added center-first ring ordering for high relevance on small runs, and ASCII-safe proxy session tagging for Korean search queries.
• v1.0 (2026-09) — Initial release with Korean location geocoding, geohash tile sweeping, agent contact extraction, and English translation fields.