KB Land Scraper — South Korea Property Data & KB 시세 API 🏠🇰🇷

🎉 Pull Korea's bank-grade KB 시세 valuations and apartment-complex data — clean JSON, no account, pay only per result

Built for proptech teams, market analysts, investors, and data engineers who need reliable Korean real estate data

---

📋 Overview

Tap into Korea's most trusted property valuations. This actor turns KB Land (kbland.kr) — the real estate platform run by Korea's largest bank — into clean, structured datasets: apartment complexes, official KB 시세 valuations (sale / jeonse / monthly), regional price markers, jeonse ratios, and recent transaction prices.

Why teams choose this actor:

• ✅ Official KB valuations: the same 시세 numbers Korean banks use for mortgage lending — sale, jeonse, and monthly, with high/low bands
• ⚡ Two speeds, one tool: cheap regional price markers for whole-market sweeps, or full complex detail when you need every field
• 🎯 60+ data points per complex: spec, unit types, regulations, GPS, recent deal price, floor, and date
• 💰 Pay-per-result pricing: no charge until your input validates — only pay for records you actually receive
• 💎 No account, no API key: paste a map viewport or a complex serial and run — no login to kbland.kr required
• ✨ Clean exports: JSON, CSV, or Excel straight from the dataset

---

✨ Features

• 🗺️ Regional price markers: average sale/jeonse prices, price-per-pyeong, jeonse ratio, and monthly change per district (동/구)
• 🇰🇷 Whole-country sweep: auto-tile every province (시도) in one run
• 🏢 Full complex detail: name, type, build year, households, floors, parking, heating, builder, FAR/BCR
• 🏦 Official KB 시세: sale/jeonse/monthly valuations with high/low bands and AI-valuation flag
• 🤝 Recent deal price: most recent actual transaction price, floor, and date
• 📊 Jeonse-ratio analytics: the lease-to-price ratio that drives Korean rental investment
• 📐 Unit-type breakdown: per-floorplan areas (supply / exclusive / contract), rooms, baths, household counts
• ⚖️ Regulatory flags: speculation-zone and adjustment-area markers
• 🌐 Map-ready geodata: WGS84 latitude/longitude on every record
• 📷 Optional photos: pull complex images on demand

---

🎬 Quick Start

Pick a mode, point it at a viewport (overview) or a complex serial (detail), and run. Results land in the dataset within seconds.

curl -X POST "https://api.apify.com/v2/acts/sian.agency~kbland-property-scraper/runs?token=YOUR_TOKEN" \
-H 'Content-Type: application/json' \
-d '{"scrapeMode": "overview", "searchMode": "byBbox", "bboxes": ["37.488,127.041,37.560,127.110"]}'

---

🚀 Getting Started (3 Simple Steps)

Step 1: Choose a mode

Overview for regional KB price markers (cheap, whole-market) or Detail for full complex records with KB 시세.

Step 2: Set your target

Paste a map viewport (swLat,swLng,neLat,neLng) for overview, or apartment-complex serial numbers (단지기본일련번호) for detail.

Step 3: Run and export

Click Start and export your dataset as JSON, CSV, or Excel.

That's it! In under a minute, you'll have:

• District-level KB price markers across your viewport
• Full apartment-complex records with official valuations
• Clean, analysis-ready data with GPS coordinates

---

📥 Input Configuration

Field	Type	Required	Description
scrapeMode	string	No	overview (regional markers) or detail (full complex)
searchMode	string	No	byBbox / bySido (overview) or bySerial (detail)
bboxes	array	No	Map viewports swLat,swLng,neLat,neLng (overview)
complexSerials	array	No	Apartment-complex serials 단지기본일련번호 (detail)
level	integer	No	Map zoom level for marker granularity (default 15)
priceStatus	string	No	1 KB 시세 or 2 actual transactions
withPhotos	boolean	No	Include complex photos in detail mode
filters	object	No	Advanced KB Land filter keys (verbatim)
maxResults	integer	No	Max records per run

Example — overview by viewport:

{
  "scrapeMode": "overview",
  "searchMode": "byBbox",
  "bboxes": ["37.488,127.041,37.560,127.110"]
}

Example — detail by complex serial:

{
  "scrapeMode": "detail",
  "searchMode": "bySerial",
  "complexSerials": ["2030"]
}

---

📤 Output

Results are saved to the Apify dataset with 60+ fields including:

Field	Type	Description
propertyTitle	string	Apartment complex name (단지명)
sale_price_avg_krw	number	Average KB sale valuation (KRW)
jeonse_price_avg_krw	number	Average KB jeonse valuation (KRW)
recent_deal_price_krw	number	Most recent actual transaction price (KRW)
jeonse_ratio	number	Jeonse-to-sale ratio (전세가율 %)
sale_price_per_pyeong_krw	number	Average sale price per pyeong (overview)
build_year	number	Year the complex was completed
households_total	number	Total households
dong_name	string	Neighborhood / dong
latitude / longitude	number	WGS84 coordinates
unit_types	array	Per-floorplan area / room / bath breakdown
url	string	KB Land page link

Example record (detail):

{
  "id": "2030",
  "source": "detail",
  "propertyTitle": "건진",
  "category": "아파트",
  "dong_name": "목동",
  "recent_deal_price_krw": 270000000,
  "is_ai_valuation": true,
  "build_year": 1994,
  "households_total": 18,
  "latitude": 37.5371,
  "longitude": 126.8688,
  "currency": "KRW",
  "url": "https://kbland.kr/map?xy=37.5371,126.8688,17&단지기본일련번호=2030"
}

---

💼 Use Cases & Examples

1. Korea Property Market Research

Analysts mapping price trends across Seoul, Busan, and beyond.

Input: A city or province viewport in overview mode Output: District-level average sale/jeonse prices, price-per-pyeong, and monthly change Use: Build heatmaps and track regional momentum.

2. KB Valuation Benchmarking

Lenders and proptech teams comparing asking prices to official KB 시세.

Input: Complex serials in detail mode Output: Sale/jeonse valuations with high/low bands and recent deal prices Use: Flag over- or under-priced listings against the bank benchmark.

3. Jeonse-Ratio Investment Screening

Investors hunting high jeonse-ratio complexes (low cash outlay).

Input: A target district viewport Output: Jeonse ratio (전세가율) per region Use: Rank neighborhoods by leverage potential.

4. Proptech Data Feeds

Apps and dashboards needing fresh Korean valuation data.

Input: Scheduled runs over your coverage area Output: Clean JSON ready to ingest Use: Power valuation widgets, alerts, and comparables.

5. Comparables & Appraisal

Appraisers gathering recent transactions and complex specs.

Input: Complex serials in detail mode Output: Recent deal price/floor/date, build year, FAR/BCR, unit types Use: Assemble defensible comparables fast.

---

🔗 Integration Examples

JavaScript/Node.js

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('sian.agency/kbland-property-scraper').call({
  scrapeMode: 'detail',
  searchMode: 'bySerial',
  complexSerials: ['2030'],
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);

Python

from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')

run = client.actor('sian.agency/kbland-property-scraper').call(
    run_input={'scrapeMode': 'overview', 'searchMode': 'byBbox',
               'bboxes': ['37.488,127.041,37.560,127.110']}
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)

cURL

curl -X POST 'https://api.apify.com/v2/acts/sian.agency~kbland-property-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"scrapeMode": "detail", "searchMode": "bySerial", "complexSerials": ["2030"]}'

Automation Workflows (N8N / Zapier / Make)

1. Trigger: Schedule or webhook
2. HTTP Request: Call the actor API
3. Process: Handle JSON results
4. Action: Save, notify, or transform

---

📊 Performance & Pricing

FREE Tier (Try It Now)

• 25 records per run — full feature access, same quality
• No credit card required
• Perfect for testing and small projects

PAID Tier (Production Ready)

• Unlimited records per run
• Faster throughput, no caps
• Pay-per-result: only charged for records you receive

💰 Transparent pay-per-result — the cheap overview event drives the headline price; detail enrichment is a separate per-record event.

🔗 View current pricing

---

❓ Frequently Asked Questions

Q: How many records can I get? A: FREE tier: 25 per run. PAID tier: unlimited.

Q: What is KB 시세? A: KB 시세 is the official market valuation published by KB (Kookmin Bank) — the benchmark Korean banks use for mortgage lending. This actor returns sale, jeonse, and monthly valuations with high/low bands.

Q: What's the difference between overview and detail mode? A: Overview crawls cheap regional price markers across a map area. Detail pulls a full apartment complex (60+ fields) including the KB 시세 valuation.

Q: Where do I find a complex serial number? A: It's the 단지기본일련번호 in the kbland.kr complex URL. You can also run overview first to scope regions.

Q: What output formats are available? A: JSON, CSV, and Excel — export directly from the Apify dataset.

Q: Do I need a kbland.kr account? A: No. No account, login, or API key is required.

Q: Is this legal? A: Yes — only publicly available data is collected. See the legal section below.

---

🐛 Troubleshooting

No records in overview mode

• Check your bbox format: swLat,swLng,neLat,neLng (south-west corner first)
• Widen the viewport or lower the level value for coarser districts

Empty detail record

• Confirm the complex serial (단지기본일련번호) is valid and numeric
• Some very small complexes have partial KB valuation data

Hit the FREE cap

• FREE runs stop at 25 records — upgrade to PAID for unlimited output

---

⚖️ Is it legal to scrape data?

Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the platform has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

You can also read Apify's blog post on the legality of web scraping.

Trademark notice: This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by KB Kookmin Bank, KB Land (kbland.kr), or any of their subsidiaries. "KB", "KB Land", "KB 시세", and all related marks are the property of their respective owners and are used here for descriptive and identification purposes only.

---

🤝 Support

Join our active support community

• For issues or questions, open an issue in the actor's repository
• Check SIÁN Agency Store for more automation tools
• 📧 apify@sian-agency.online

---

Built by SIÁN Agency | More Tools