Korea Real Estate Transactions — 국토부 실거래가

Fetch official Korean real estate transaction records from the Ministry of Land, Infrastructure and Transport (국토교통부) public API. Covers apartment, villa (연립/다세대), and officetel buy and rent deals by region and time period. Perfect for real estate analysis, housing market research, property price tracking, and investment data pipelines in South Korea.

---

Features

• 6 property types: Apartment buy/rent, Villa buy/rent, Officetel buy/rent
• Region filtering: Specify any number of 5-digit region codes (법정동 코드)
• Multi-month queries: Query multiple year-months in a single run
• Automatic pagination: Fetches all pages per region/month combination
• Retry logic: 3 retries with exponential backoff on network errors
• XML fallback: Handles endpoints that return XML instead of JSON
• PPE billing: Pay only for records actually returned

---

Input

Field	Type	Required	Description
service_key	string	Yes	API key from data.go.kr. Obtain by registering and requesting access to the RTMSDataSvc APIs.
property_type	string	Yes	One of: apartment_buy, apartment_rent, villa_buy, villa_rent, officetel_buy, officetel_rent
region_codes	string[]	Yes	5-digit legal-district codes. Examples: Seoul=11, Gangnam-gu=11680, Jongno-gu=11110. Lookup codes at code.go.kr.
deal_months	string[]	Yes	Year-months to query in YYYYMM format. E.g. ["202408", "202409"]
max_results	integer	No	Maximum records to return (default: 1000)

How to get an API key

1. Visit data.go.kr and create a free account
2. Search for "국토교통부 아파트매매 실거래 자료" (or the relevant dataset)
3. Click "활용신청" (Apply for use) — approval is usually instant
4. Copy your serviceKey from the "마이페이지 > 개발계정" tab

---

Output

Each record contains:

Field	Type	Description
property_type	string	Input property type (e.g. apartment_buy)
region_code	string	5-digit region code
deal_year_month	string	YYYYMM of the deal
name	string	Building/complex name (단지명)
area_sqm	float	Exclusive area in sqm (전용면적)
floor	integer	Floor number
deal_amount_krw	integer	Transaction price in KRW (매매가, comma-stripped)
deal_date	string	ISO date YYYY-MM-DD
address	string	Legal address (지번)
rent_type	string	"전세" or "월세" (rent records only)
deposit_krw	integer	Deposit amount in KRW (rent records only)
monthly_rent_krw	integer	Monthly rent in KRW (월세 records only)

Example output (apartment_buy)

{
  "property_type": "apartment_buy",
  "region_code": "11680",
  "deal_year_month": "202408",
  "name": "래미안퍼스티지",
  "area_sqm": 84.97,
  "floor": 12,
  "deal_amount_krw": 2850000000,
  "deal_date": "2024-08-05",
  "address": "개포동 1217",
  "rent_type": null,
  "deposit_krw": null,
  "monthly_rent_krw": null
}

Example output (apartment_rent)

{
  "property_type": "apartment_rent",
  "region_code": "11110",
  "deal_year_month": "202409",
  "name": "경희궁자이",
  "area_sqm": 59.9,
  "floor": 7,
  "deal_amount_krw": null,
  "deal_date": "2024-09-12",
  "address": "교북동 10",
  "rent_type": "전세",
  "deposit_krw": 700000000,
  "monthly_rent_krw": 0
}

---

Pricing (Pay-Per-Event)

Event	Price	When charged
Actor start	$0.001	Once per run
Per transaction record	$0.001	Per record pushed to dataset

Fetching 1,000 apartment buy records ≈ $1.001 total.

---

Notes

• Region codes are the first 5 digits of the 10-digit 법정동 코드. Use 11 for all of Seoul (slower, large result set).
• The public API rate-limits aggressively. The Actor automatically retries on transient failures.
• Some endpoints return XML regardless of _type=json parameter — the Actor handles both formats transparently.
• Data is updated by the Ministry of Land approximately monthly; very recent transactions may not yet appear.

Keywords: South Korea real estate, 국토부, apartment transactions, property market, 실거래가, land registry, housing market