Korean Real Estate Transaction Data (한국 부동산 실거래가)

Fetches official real estate transaction data from Korea's Ministry of Land, Infrastructure and Transport (국토교통부) via the data.go.kr Open API. Get every apartment sale, jeonse contract, and monthly rent record reported in South Korea since 2006.

Why use this Actor?

• Official government data — not scraped, not estimated. These are actual transaction records reported to the Korean government.
• No proxy needed — data.go.kr is accessible worldwide. No additional proxy costs.
• 12 API endpoints in one Actor — apartments, officetels, row houses, single-family homes, land, commercial properties, presale rights, and factory/warehouse.
• 20 years of data — records from January 2006 to the present month.
• Batch queries — search multiple regions and date ranges in a single run.

What data is available?

Property Type	Sale (매매)	Jeonse/Rent (전월세)
Apartment (아파트)	✅	✅
Officetel (오피스텔)	✅	✅
Row House (연립다세대)	✅	✅
Single House (단독다가구)	✅	✅
Land (토지)	✅	-
Commercial (상업업무용)	✅	-
Presale Rights (분양입주권)	✅	-
Factory/Warehouse (공장창고등)	✅	-

How much does it cost?

This Actor uses pay-per-event pricing. You are charged per result item returned. No platform usage fees — you only pay for the data you get.

No proxy costs. The data.go.kr API is freely accessible from any location.

You need a free API key from data.go.kr (see setup instructions below).

How to get an API key

1. Go to data.go.kr
2. Create a free account
3. Search for "국토교통부 아파트매매 실거래자료"
4. Click "활용신청" (Apply for usage)
5. Your API key will be issued within 1-2 hours (automatic approval)

Input parameters

Parameter	Required	Description
serviceKey	✅	Your data.go.kr API key
propertyType	No	Property type (default: 아파트)
tradeType	No	Trade type: 매매 or 전월세 (default: 매매)
regionCode	No	5-digit region code (default: 11650 = Seoul Seocho-gu)
yearMonth	*	Single month query (YYYYMM)
startYearMonth	*	Start of date range (YYYYMM)
endYearMonth	*	End of date range (YYYYMM)
regionCodes	No	Multiple region codes for batch queries

* Provide either yearMonth OR both startYearMonth and endYearMonth.

Example output (apartment sale)

{
    "dealAmount": "85,000",
    "buildYear": "2015",
    "year": "2026",
    "month": "1",
    "day": "15",
    "legalDong": "서초동",
    "apartmentName": "래미안서초에스티지S",
    "exclusiveArea": "84.97",
    "lotNumber": "1500",
    "regionCode": "11650",
    "floor": "12",
    "dealType": "중개거래",
    "brokerLocation": "서초구",
    "sellerType": "개인",
    "buyerType": "개인",
    "_regionCode": "11650",
    "_queryMonth": "202601",
    "_propertyType": "아파트",
    "_tradeType": "매매"
}

Each record includes: transaction price, property name, area (m²), floor, construction year, location, deal type (brokered vs. direct), and cancellation status.

Region codes (LAWD_CD)

Find all codes at www.code.go.kr. Common Seoul districts:

Code	Region
11110	Seoul Jongno-gu (서울 종로구)
11440	Seoul Mapo-gu (서울 마포구)
11500	Seoul Gangseo-gu (서울 강서구)
11560	Seoul Yeongdeungpo-gu (서울 영등포구)
11650	Seoul Seocho-gu (서울 서초구)
11680	Seoul Gangnam-gu (서울 강남구)
11710	Seoul Songpa-gu (서울 송파구)
41135	Gyeonggi Bundang-gu (경기 분당구)
41465	Gyeonggi Hwaseong-si (경기 화성시)
26110	Busan Jung-gu (부산 중구)

Use cases

• Real estate market analysis — track price trends by district, property type, and time period
• Investment research — compare transaction volumes and prices across regions
• Academic research — study housing market dynamics with 20 years of data
• Data journalism — analyze real estate trends with official government figures
• PropTech applications — build dashboards and tools on top of reliable transaction data

FAQ

Q: How do I get a data.go.kr API key? A: Create a free account at data.go.kr, search for "국토교통부 아파트매매 실거래자료", and click "활용신청". Your key is issued automatically within 1-2 hours.

Q: Can I search multiple regions at once? A: Yes. Use the regionCodes parameter with comma-separated codes (e.g., 11650,11680,11710 for Seocho, Gangnam, and Songpa). The Actor queries each region and month combination.

Q: What's the difference between this and the Naver Land Scraper? A: This Actor returns completed transactions (actual sale/jeonse prices reported to the government). The Naver scraper returns current listings (asking prices on the market). Combine both for market analysis — asking price vs. actual transaction price.

Q: How much data does a typical run return? A: Varies by region and time period. Seoul Gangnam-gu typically has 200-500 apartment transactions per month. A 12-month query for one district returns 2,400-6,000 records.

Q: Are cancelled transactions included? A: Yes. Cancelled transactions (해제) are included with a cancellation flag. This is useful for analyzing deal fall-through rates.

Q: Does the API key have a usage limit? A: Development keys allow 10,000 requests/day. For heavy batch queries, apply for a production key (100,000/day) through data.go.kr.

Integration with Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

# Get Gangnam apartment transactions for 2025
run = client.actor("aligned_kettledrum/kr-real-estate-transaction").call(
    run_input={
        "serviceKey": "YOUR_DATA_GO_KR_KEY",
        "propertyType": "아파트",
        "tradeType": "매매",
        "regionCode": "11680",
        "startYearMonth": "202501",
        "endYearMonth": "202512",
    }
)

# Analyze with pandas
import pandas as pd
items = list(client.dataset(run["defaultDatasetId"]).iterate_items())
df = pd.DataFrame(items)

# Clean and convert prices (만원 → 억원)
df["price"] = df["dealAmount"].str.replace(",", "").astype(int) / 10000
print(f"Transactions: {len(df)}")
print(f"Avg price: {df['price'].mean():.1f}억원")
print(f"Most traded complex: {df['apartmentName'].value_counts().head(5)}")

Notes

• Deal amounts are in units of 만원 (₩10,000). "85,000" = 850,000,000 KRW (~$600K USD).
• The government API returns XML which is automatically parsed to clean JSON.
• All Korean field names are translated to English keys. Unmapped fields keep their original names.
• API rate limit: 10,000 requests/day (development key), 100,000/day (production key).
• Data volume: Seoul Gangnam-gu typically has 200-500 apartment transactions per month.