# R114 Korea Apartment Price & Jeonse API – 부동산114 아파트 시세·실거래가 (`k-data-lab/r114-scraper`) Actor

South Korea apartment price API from R114 (부동산114), no login: sale & jeonse valuation per unit type, 10-year weekly price history, real transaction deals, jeonse ratio & gap, district complex lists, presale calendar. 아파트 시세·실거래가·분양. 50 complexes free/month.

- **URL**: https://apify.com/k-data-lab/r114-scraper.md
- **Developed by:** [K-Data Lab](https://apify.com/k-data-lab) (community)
- **Categories:** Real estate, AI, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 단지 r114 시세 (complex with r114 prices)s

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## R114 Korea Apartment Price & Jeonse API – 부동산114 아파트 시세·실거래가

> 🇺🇸 **South Korea apartment price API, no login:** give an apartment complex name (e.g. `은마`), an R114 complex code or a Korean district (e.g. `강남구 대치동`) and get R114's sale and jeonse valuation per unit type, up to 10 years of weekly price history, real transaction deals, jeonse ratio and gap, as JSON/CSV/Excel. The default input (3 complexes) runs in about 4 seconds and is inside the free monthly quota. [English summary ↓](#english-summary)

**부동산114(r114.com)의 R114 아파트 시세를 단지·평형별로 한 번에 받아 보세요.** 평형마다 매매·전세 시세, **최대 10년치 주간 시세 추이**, 실거래가 목록(매매·전세·월세, 계약일·층·취소 여부), 전세가율·갭, 동·구·시도 평당가 비교, 단지 정보(세대수·입주·용적률·주차·난방·평면도)를 JSON · CSV · Excel로 줍니다. **구·동 전체 단지 시세 목록**, **시군구 R114 주간 시세(59㎡·84㎡)**, **분양 청약 일정과 평형별 분양가**도 가져옵니다. 로그인도, 브라우저도 필요 없습니다.

| | |
|---|---|
| 💰 **가격** | 단지 1개 (모든 평형·10년 주간 시세·실거래 포함) **$0.004** (약 6원) = $4 / 1,000단지 (약 5,600원) · 지역 단지 목록 $0.0008 / 줄 · 지역 시세 $0.001 / 지역 · 분양 $0.002 / 단지 |
| 🎁 **무료** | 매달 단지 50개 + 단지 목록 500줄 + 지역 300개 + 분양 50개 무료. 기본 입력(단지 3개) 첫 실행은 실행 시작 $0.005만 듭니다 (Apify 무료 플랜 월 $5 크레딧으로 충분) |
| ⚡ **속도** | 단지 3개 = 약 4초, 분당구 단지 40개 (평형 292줄) = 약 2분 30초, 대치동 전체 132줄 = 약 12초, 전국 시군구 269개 = 약 20초 |
| 🔓 **로그인** | 필요 없음 (부동산114 웹에서 로그아웃 상태로 보이는 공개 정보만) |

> 비공식(unofficial) 도구입니다. Not affiliated with, endorsed or sponsored by 부동산114 / R114 / HDC랩스.

#### 🏠 무엇을 가져오나요?

| 모드 | 한 줄 = | 주요 필드 |
|---|---|---|
| **단지 시세** (`complexes`, 기본값) | 단지의 평형 1개 | R114 매매·전세 시세, 시세 기준일, 1주·1개월·3개월·1년 변동률, 전세가율, 갭, 공급 평당가, **주간 시세 추이 (최대 520주)**, 최근 매매·전세·월세 실거래, 1년 거래 건수, **실거래 목록**, 단지·동·구·시도 평당가 비교, 세대수, 입주 연월, 용적률·건폐율, 주차, 난방, 현관 구조, 평면도·배치도 |
| **지역 단지 목록** (`area`) | 구·동 안의 단지 × 대표 평형 | 매매·전세 시세, 실거래가, 전세가율, 갭, 실거래 평당가, 월세 수익률, 세대수, 입주, 재건축 단계(정비구역·안전진단·추진위·조합·착공) |
| **지역 시세** (`regions`) | 시도·시군구·읍면동 1곳 | 평균 아파트 실거래가, 시군구는 **R114 주간 시세 59㎡·84㎡**·지난주 시세·주간 변동률·규제지역 여부 |
| **분양 청약 일정** (`presale`) | 분양 단지 1개 | 청약 상태, 모집공고·청약 시작·1순위·2순위·당첨자 발표·계약 일정, **평형별 분양가**·평당가·방·욕실, 세대수, 시행사, 입주 예정월, 조감도 |

가격 단위는 모두 **만원**입니다 (`439000` = 43억 9천만 원).

#### 🔎 단지를 고르는 3가지 방법

1. **단지명 검색**: `["은마", "헬리오시티"]`. 같은 이름의 단지가 먼저 오고, 부산·대구의 동명 단지도 함께 나옵니다 (`address`로 구분).
2. **단지 코드·URL**: `["A01011352800003"]` 또는 `["https://r114.com/prop/A01011352800003"]`. 결과의 `complexCode`를 다시 넣으면 매주 같은 단지를 모니터링할 수 있습니다.
3. **지역**: `["강남구 대치동", "성남시 분당구", "서울 중구"]`. 세대수가 큰 단지부터 `maxComplexes`개까지 상세 시세를 줍니다.

#### 💡 왜 이 액터인가요?

- **Apify Store의 유일한 부동산114 액터**입니다 (2026-11 기준 "r114", "부동산114"로 검색해도 다른 액터가 없습니다).
- **10년치 주간 시세 추이가 기본 포함**: 평형마다 R114 주간 매매·전세 시세를 최대 520주까지, 추가 요금 없이.
- **KB시세와 다른 두 번째 시세**: R114 시세는 KB시세와 산정 방식이 달라 값이 다릅니다. [KB부동산 스크래퍼](https://apify.com/k-data-lab/kbland-scraper)와 함께 쓰면 두 시세를 나란히 비교할 수 있습니다.
- **구·동 전체를 한 번에**: 대치동 132줄을 12초, 약 $0.1에. 전세가율·갭·월세 수익률·재건축 단계가 바로 들어 있어 갭투자·재건축 스크리닝에 좋습니다.
- **분양 캘린더**: 청약 일정과 평형별 분양가를 같은 액터에서.
- **저렴하고 투명한 가격**: 결과가 있는 단지만 과금, 매달 무료 분량, 최대 비용을 정하면 그 금액에서 깔끔하게 멈춥니다.

#### 📥 입력 예시

은마 시세 (기본값, 버튼 한 번으로 바로 실행):

```json
{ "mode": "complexes", "searchKeywords": ["은마"], "maxComplexes": 3 }
```

분당구 84㎡만, 매매 실거래만, 최근 2년 주간 시세:

```json
{ "mode": "complexes", "regions": ["성남시 분당구"], "maxComplexes": 20,
  "exclusiveAreas": ["84"], "dealTypes": ["매매"], "historyWeeks": 104 }
```

대치동 300세대 이상 단지 목록 (갭·전세가율 스크리닝):

```json
{ "mode": "area", "regions": ["강남구 대치동"], "minHouseholds": 300, "propertyTypes": ["아파트"] }
```

서울 시군구 R114 주간 시세:

```json
{ "mode": "regions", "regionLevel": "sigungu", "regionFilter": ["서울"] }
```

경기도 청약 예정·진행 단지와 분양가:

```json
{ "mode": "presale", "regionFilter": ["경기"], "presaleStatus": ["UPCOMING", "IMMINENT", "OPEN"] }
```

#### 📤 출력 예시

**단지 시세** (은마 전용 84㎡, `priceHistory`·`deals`는 앞 2개만 표시):

```json
{
  "type": "unit-type",
  "complexCode": "A01011352800003",
  "complexName": "은마",
  "propertyType": "아파트",
  "url": "https://r114.com/prop/A01011352800003",
  "address": "서울특별시 강남구 대치동 316",
  "moveInMonth": "1979-12",
  "households": 4424,
  "buildings": 28,
  "parkingPerHousehold": 1.13,
  "heating": "지역난방",
  "entranceType": "복도식",
  "floorAreaRatio": 197,
  "unitTypeCount": 2,
  "exclusiveArea": 84.43,
  "supplyPyeong": 34.8,
  "unitHouseholds": 1750,
  "salePrice": 439000,
  "jeonsePrice": 85625,
  "priceDate": "2026-10-30",
  "jeonseRatio": 19.5,
  "gapPrice": 353375,
  "saleChange1m": 0.69,
  "saleChange1y": 9.24,
  "priceHistory": [
    { "date": "2026-10-30", "salePrice": 439000, "jeonsePrice": 85625 },
    { "date": "2026-10-23", "salePrice": 438750, "jeonsePrice": 85375 }
  ],
  "complexPricePerPyeong": 10290,
  "dongPricePerPyeong": 7472,
  "sigunguPricePerPyeong": 8690,
  "lastSaleDealPrice": 343000,
  "lastSaleDealDate": "2026-10-06",
  "lastSaleDealFloor": 3,
  "dealSaleCount1y": 17,
  "lastJeonseDealPrice": 60000,
  "dealJeonseCount1y": 167,
  "dealCountTotal": 5237,
  "deals": [
    { "date": "2026-10-06", "dealType": "매매", "price": 343000, "floor": 3, "supplyArea": 115.54, "dealMethod": "중개거래", "cancelled": false },
    { "date": "2026-10-03", "dealType": "매매", "price": 340000, "floor": 3, "supplyArea": 115.54, "dealMethod": "중개거래", "cancelled": false }
  ],
  "source": "search",
  "sourceValue": "은마"
}
```

**지역 단지 목록** (대치동):

```json
{ "type": "area-row", "complexName": "래미안대치팰리스1단지", "dong": "대치동", "households": 1278, "moveInMonth": "2015-09",
  "exclusiveArea": 84.99, "salePrice": 444500, "jeonsePrice": 205375, "jeonseRatio": 46.2, "gapPrice": 239125,
  "lastSaleDealPrice": 430000, "dealPricePerPyeong": 13030, "monthlyRentYield": 0.6084, "complexCode": "A01011352800112" }
```

**지역 시세** (분당구):

```json
{ "type": "region", "level": "sigungu", "regionName": "분당구", "parentRegion": "성남시", "sido": "경기도", "avgDealPrice": 181032,
  "r114Price84": 169652, "r114PricePrevWeek84": 169121, "r114WeeklyChangeRate84": 0.31,
  "r114Price59": 118771, "r114WeeklyChangeRate59": 0.37, "regulated": "규제지역", "priceDate": "2026-10-30", "regionCode": "4113500000" }
```

**분양** (평형 1개만 표시):

```json
{ "type": "presale", "complexName": "광교 자연앤 센트레빌(A17BL)", "presaleStatusLabel": "청약 임박",
  "announcementDate": "2026-10-30", "subscriptionStart": "2026-11-09", "firstPriorityDate": "2026-11-10",
  "winnerAnnouncementDate": "2026-11-17", "contractStart": "2026-12-21", "households": 600, "developer": "경기주택도시공사",
  "expectedMoveInMonth": "2029-10", "minSalePrice": 66120, "maxSalePrice": 94890,
  "unitTypes": [{ "type": "A", "exclusiveArea": 59.9, "households": 43, "salePrice": 67750, "salePricePerPyeong": 2788, "rooms": 3, "bathrooms": 2 }] }
```

#### 💰 가격 (Pay per event)

| 이벤트 | Free · Bronze | Silver | Gold · Platinum · Diamond | 매달 무료 |
|---|---|---|---|---|
| 단지 R114 시세 (`complex`, 모든 평형·주간 시세 추이·실거래 포함) | $0.004 (약 6원) | $0.0035 | $0.003 | 50개 |
| 지역 단지 목록 줄 (`area-row`) | $0.0008 (약 1원) | $0.0007 | $0.0006 | 500줄 |
| 지역 시세 (`region`) | $0.001 (약 1.4원) | $0.0009 | $0.0008 | 300개 |
| 분양 단지 (`presale`, 분양가·청약 일정 포함) | $0.002 (약 3원) | $0.0018 | $0.0015 | 50개 |
| 실행 시작 (`apify-actor-start`) | $0.005 (약 7원) | | | |

- 예: 분당구 상위 40개 단지 (평형 292줄) = 무료 분량 안이면 $0.005, 무료를 다 쓴 뒤에는 $0.165 (약 230원).
- 예: 대치동 전체 단지 목록 132줄 = 약 $0.11 (약 150원), 전국 시군구 269개 = 약 $0.27 (약 380원).
- 단지 요금은 **단지당 한 번**만 매깁니다. 평형이 7개인 단지도 $0.004입니다.
- 실행마다 \*\*최대 비용(Max total charge)\*\*을 정하면 그 금액에서 깔끔하게 멈춥니다. 원화는 $1 = 1,400원 기준 대략값입니다.

#### 🎯 이런 분께 좋아요

- **부동산 투자·분석**: 관심 단지의 R114 시세·실거래가를 매주 시트로 쌓아 갭과 전세가율을 추적하고, KB시세와 비교.
- **갭투자·재건축 스크리닝**: 구·동 전체 단지를 전세가율, 갭, 월세 수익률, 재건축 단계로 걸러 보기.
- **프롭테크·리서치**: 시군구 R114 주간 시세와 변동률로 상승·하락 지역 대시보드.
- **분양·청약 정보 서비스**: 청약 일정과 평형별 분양가를 매일 갱신.
- **AI 에이전트**: "은마 84㎡ 부동산114 시세랑 최근 실거래 알려줘" 같은 질문에 Apify MCP로 바로 답하기.

#### 🔌 API · 연동

```bash
curl -X POST "https://api.apify.com/v2/acts/k-data-lab~r114-scraper/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"mode":"complexes","searchKeywords":["은마"],"maxComplexes":3}'
```

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("k-data-lab/r114-scraper").call(run_input={
    "mode": "area", "regions": ["강남구 대치동"], "minHouseholds": 300,
})
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(row["complexName"], row["salePrice"], row["jeonseRatio"], row["gapPrice"])
```

Make · n8n · Zapier · Google Sheets 연동, 예약 실행(Schedules), 웹훅도 Apify 콘솔에서 바로 쓸 수 있습니다.

#### 🤖 AI 에이전트에서 쓰기 (Use it from AI agents · MCP)

Give Claude, ChatGPT, Cursor, VS Code or n8n a ready-made `r114-scraper` tool through [Apify's MCP server](https://mcp.apify.com): the agent reads the input schema, runs this actor and gets the dataset back. AI 에이전트가 입력 항목을 읽고 직접 실행해 결과를 받아 옵니다.

- 이 액터만 (this actor only): `https://mcp.apify.com?tools=actors,docs,k-data-lab/r114-scraper`
- Example agent prompts: *"What is the R114 sale and jeonse price of Eunma (은마) 84㎡ and its recent deals?"* → `{"searchKeywords":["은마"],"exclusiveAreas":["84"],"maxComplexes":1}` · *"List every apartment complex in Daechi-dong, Gangnam with jeonse ratio and gap"* → `{"mode":"area","regions":["강남구 대치동"]}` · *"Weekly apartment price change for every Seoul district"* → `{"mode":"regions","regionFilter":["서울"]}` · *"Upcoming apartment presale (청약) in Gyeonggi"* → `{"mode":"presale","regionFilter":["경기"]}`
- Agents: send district and complex names in Korean (Hangul), e.g. `강남구` not `Gangnam-gu`. Prices are in 만원 (10,000 KRW).
- 한국 데이터 MCP 서버도 있습니다: [Korea Data MCP Server](https://apify.com/k-data-lab/korea-data-mcp-server)

#### ❓ 자주 묻는 질문

**R114 시세와 KB시세가 왜 다른가요?** 두 회사가 서로 다른 방식으로 시세를 산정하기 때문입니다. 예를 들어 은마 전용 84㎡는 2026-10-30 기준 R114 매매 시세가 43억 9천만 원, KB 일반가가 35억 4천만 원이었습니다. 실거래가(`deals`)는 국토교통부 신고 자료라 두 사이트가 같습니다.

**시세가 비어 있는 평형이 있어요.** 부동산114가 시세를 내지 않는 평형입니다. 임대 단지(주공 임대 등), 일부 오피스텔, 세대수가 아주 적은 평형이 그렇습니다. 실거래·단지 정보는 그대로 나옵니다. 주간 시세가 빈 주는 건너뛰고 가장 최근 값이 있는 주를 씁니다.

**얼마나 자주 바뀌나요?** R114 시세는 매주 금요일 기준으로 갱신됩니다 (`priceDate`로 기준일 확인). 주 1회 예약 실행이면 충분합니다. 실거래는 신고되는 대로 추가됩니다.

**검색어 하나로 몇 개 단지가 나오나요?** 부동산114 검색창이 보여 주는 만큼(보통 10~20개)입니다. 더 많은 단지는 `regions`(구·동)로 가져오세요.

**지역 이름은 어떻게 쓰나요?** `강남구`, `강남구 대치동`, `성남시 분당구`, `서울 중구`, 10자리 법정동코드 모두 됩니다. `중구`처럼 여러 곳에 있는 이름은 시도를 붙여 달라는 안내와 함께 건너뜁니다 (`RUN_SUMMARY`에서 확인).

**매물(호가)이나 중개사 연락처도 나오나요?** 아니요. 부동산114가 직접 내는 시세, 공개 실거래, 단지 정보, 분양 공고만 다룹니다. 개별 매물, 중개사 정보, 커뮤니티 글, 회원 정보는 가져오지 않습니다.

**결과가 없거나 실패하면 과금되나요?** 결과가 있는 단지·줄만 과금됩니다 (실행 시작 $0.005 제외). 입력별 상태(OK · NOT_FOUND · INVALID_INPUT)는 키-값 저장소의 `RUN_SUMMARY`에 남습니다.

**데이터를 어디에 써도 되나요?** 이 도구는 부동산114 웹에서 누구나 볼 수 있는 공개 정보를 대신 모아 줄 뿐입니다. 시세 데이터의 권리는 부동산114에 있으니 재판매·대량 재배포 전에는 부동산114 이용약관을 확인하세요. 요청은 동시 3개 이하로 천천히 보냅니다.

#### 🧰 K-Data Lab의 다른 액터

- [KB부동산 시세 스크래퍼 (KB Land API)](https://apify.com/k-data-lab/kbland-scraper): 평형별 KB시세(하한·일반·상한), 매물 수, 20년 시세 추이, 지역 시세
- [Korea Data MCP Server](https://apify.com/k-data-lab/korea-data-mcp-server): AI 에이전트용 한국 데이터 (K-pop 차트, KB부동산 시세)
- [통합 음원차트 스크래퍼 (Korean Music Charts API)](https://apify.com/k-data-lab/korean-music-chart-scraper): 멜론·지니·벅스·FLO·VIBE 순위를 곡마다 한 줄로
- [멜론 차트·곡·앨범 스크래퍼 (Melon Chart API)](https://apify.com/k-data-lab/melon-scraper): 멜론 TOP100·HOT100·장르 차트와 좋아요 수
- [지니뮤직 차트·곡·앨범 스크래퍼 (Genie Music Chart API)](https://apify.com/k-data-lab/genie-scraper): 지니 TOP200과 곡별 재생수·청취자수
- [벅스 차트·곡 스크래퍼 (Bugs Music Chart API)](https://apify.com/k-data-lab/bugs-scraper): 벅스 실시간·장르·과거 차트와 곡 크레딧
- [FLO 차트·곡 스크래퍼 (FLO Music Chart API)](https://apify.com/k-data-lab/flo-scraper): FLO 차트 순위와 차트 점수
- [VIBE 차트·곡 스크래퍼 (VIBE Music Chart API)](https://apify.com/k-data-lab/vibe-scraper): 네이버 VIBE TOP300, 연령·성별 차트, 과거 차트
- [Agoda Scraper](https://apify.com/k-data-lab/agoda-scraper): 아고다 호텔 가격, 객실 요금, 리뷰
- [Google Play Scraper API](https://apify.com/k-data-lab/google-play-scraper): 구글 플레이 앱 정보와 리뷰
- [Google Ads Transparency & Ad Library Scraper](https://apify.com/k-data-lab/google-ad-library-scraper): 경쟁사가 집행하는 구글 광고 전체
- [Amazon ASIN Rating & Review Count Scraper](https://apify.com/k-data-lab/amazon-asin-rating-scraper): 아마존 19개 마켓 ASIN 별점·리뷰 수
- [Amazon Seller Central Review Scraper](https://apify.com/k-data-lab/amazon-seller-central-review-scraper): 내 셀러 센트럴 계정의 리뷰 전체

#### 💬 문의

빠진 필드나 틀린 값이 있으면 **Issues** 탭에 남겨 주세요. 당일에 답변드립니다.

***

#### English summary

**R114 (부동산114) Scraper API**: get Korean apartment prices from r114.com, one of Korea's oldest real-estate data portals, without login. For each apartment or officetel complex (search by name, R114 complex code/URL, or district) you get one row per unit type with **R114's own sale and jeonse valuation**, its date and 1-week / 1-month / 3-month / 1-year change rates, jeonse ratio, gap (sale − jeonse), price per pyeong compared with the neighbourhood, district and province, **up to 10 years of weekly price history** (included in the price), real transactions (sale, jeonse, monthly rent; date, floor, cancellations), 12-month deal counts and complex specs (households, move-in, floor-area ratio, parking, heating, floor plans). Three more modes: **district-wide complex lists** (every complex in a 구/동 with valuation, latest deal, jeonse ratio, gap, rental yield and reconstruction milestones), **regional prices** (average deal price per province/district/neighbourhood plus R114 weekly 59㎡/84㎡ prices and weekly change per district) and the **presale (분양) calendar** with subscription dates and list prices per unit type. Prices are in 만원 (10,000 KRW). $0.004 per complex (all unit types, history and deals included), $0.0008 per district-list row, $0.001 per region, $0.002 per presale complex; 50 complexes, 500 list rows, 300 regions and 50 presale complexes free every month.

**FAQ (English)**

- **How do I get R114 apartment prices as an API?** Call `k-data-lab/r114-scraper` with `{"searchKeywords":["은마"]}` or `{"complexIds":["A01011352800003"]}` through the Apify API (examples above), or from Make, n8n, Zapier or an AI agent via the Apify MCP server.
- **Why do R114 prices differ from KB prices?** The two companies value apartments differently. Use our [KB Land scraper](https://apify.com/k-data-lab/kbland-scraper) to compare both side by side; real transactions are the same government data on both.
- **Does it return listings or realtor contacts?** No. Only R114's published valuations, public transaction records, complex specs and presale notices.
- **Is it official?** No. It is an unofficial tool, not affiliated with R114 / 부동산114 / HDC Labs. It reads the same public data a logged-out visitor sees.

Tags: 부동산114, r114, r114 api, 부동산114 시세, 아파트 시세, 아파트 시세 조회, 실거래가, 전세가율, 갭투자, 재건축, 분양, 청약 일정, 분양가, 시세 추이, korea real estate api, korean apartment prices, south korea apartment price api, seoul apartment prices, jeonse price, korea housing price data, korean real estate transactions, south korea property data

# Actor input Schema

## `mode` (type: `string`):

complexes(기본값) = 단지·평형별 R114 시세, 주간 시세 추이, 실거래가, 단지 정보. area = 지역(구·동)의 모든 단지를 시세 요약과 함께 한 줄씩 (가볍고 저렴). regions = 시도·시군구·읍면동 평균 실거래가 + R114 주간 시세(59㎡·84㎡, 주간 변동률). presale = 분양 청약 일정·분양가·납부 일정. (English: complexes = per-unit-type R114 sale/jeonse valuation, weekly price history and real transaction deals for each apartment complex; area = every complex in a Korean district, one cheap row each; regions = average prices per province/district/neighbourhood; presale = new-apartment subscription calendar and list prices.)

## `searchKeywords` (type: `array`):

부동산114 검색창처럼 단지명·브랜드로 찾습니다. 예: 은마, 래미안, 헬리오시티. 검색어마다 부동산114가 보여 주는 상위 결과(보통 10~20개)까지, 같은 이름이 먼저 옵니다. complexes 모드 전용. (English: apartment complex name keywords in Korean, e.g. \["은마"] for Eunma, \["헬리오시티"] for Helio City; complexes mode only.)

## `complexIds` (type: `array`):

부동산114 단지 코드(예: A01011352800003) 또는 단지 페이지 주소(예: https://r114.com/prop/A01011352800003). 결과의 complexCode를 다시 넣으면 정기 모니터링에 쓸 수 있습니다. complexes 모드 전용. (R114 complex codes or URLs.)

## `regions` (type: `array`):

시군구 또는 읍면동. 예: 강남구 대치동, 성남시 분당구, 마포구, 서울 중구. 같은 이름이 여러 곳이면 시도를 앞에 붙여 주세요(예: 서울 중구). 10자리 법정동코드도 됩니다. complexes 모드에서는 세대수 큰 단지부터 최대 단지 수만큼 상세 시세를, area 모드에서는 모든 단지를 한 줄씩 줍니다. (English: Korean district or neighbourhood names in Hangul, e.g. \["강남구 대치동"] for Daechi-dong, Gangnam-gu, \["성남시 분당구"] for Bundang; romanised names are not matched.)

## `propertyTypes` (type: `array`):

아파트, 오피스텔 중에서 고릅니다. 기본값: 둘 다. 예: \["아파트"]. (English: 아파트 = apartment, 오피스텔 = officetel. Send the Korean values.)

## `maxComplexes` (type: `integer`):

complexes 모드에서 가져올 최대 단지 수(1~1000). 결과는 단지의 평형마다 한 줄입니다(예: 평형 3개 = 3줄). 예: 10. (English: max complexes in complexes mode; one output row per unit type. Keep it small (3) for a cheap first run.)

## `historyWeeks` (type: `integer`):

평형마다 R114 주간 매매·전세 시세 추이를 최근 몇 주까지 넣을지(0~520, 약 10년). 0이면 넣지 않습니다(변동률 필드는 그대로 계산). 예: 52 = 최근 1년. (English: weeks of R114 weekly sale/jeonse price history per unit type, 0–520 = up to 10 years; included in the complex price.)

## `maxDeals` (type: `integer`):

평형마다 최근 실거래(매매·전세·월세)를 몇 건까지 넣을지(0~5000). 0이면 목록은 빼고 최근 실거래 요약 필드만 남깁니다. 예: 20. (English: max real transaction records (sale, jeonse, monthly rent) per unit type, 0–5000.)

## `dealTypes` (type: `array`):

실거래 목록에 넣을 거래 종류. 기본값: 매매, 전세, 월세. 예: \["매매"]. (English: 매매 = sale, 전세 = jeonse (lump-sum deposit lease), 월세 = monthly rent. Send the Korean values.)

## `exclusiveAreas` (type: `array`):

특정 평형만 원할 때 전용면적(㎡)을 넣습니다(±3㎡). 비워 두면 모든 평형. 예: \["59", "84"]. (English: keep only unit types with this exclusive area in ㎡, ±3㎡, e.g. \["84"]. Empty = all.)

## `minHouseholds` (type: `integer`):

area 모드에서 이 세대수 미만인 단지는 뺍니다. 0이면 모두. 예: 300. (English: area mode only, skip complexes with fewer households.)

## `maxResults` (type: `integer`):

area, regions, presale 모드에서 가져올 최대 줄 수(1~10000). 예: 200. (English: max rows in area, regions and presale modes.)

## `regionLevel` (type: `string`):

sido = 시도 17곳, sigungu = 시군구 약 270곳(R114 주간 시세 59㎡·84㎡ 포함), dong = 읍면동(지역 필터 필요). 기본값: sigungu. (English: sido = 17 provinces, sigungu = ~270 districts incl. R114 weekly 59㎡/84㎡ prices, dong = neighbourhoods, needs regionFilter.)

## `regionFilter` (type: `array`):

regions 모드: 이 시도·시군구만(예: 서울, 강남구, 성남시 분당구; dong 단위에서는 필수). presale 모드: 주소에 이 단어가 들어간 분양 단지만(예: 서울, 경기, 수원). 비워 두면 전국. (English: regions mode = only these provinces/districts in Korean, e.g. \["서울"], \["강남구"]; presale mode = address contains this word. Empty = nationwide.)

## `presaleStatus` (type: `array`):

UPCOMING = 청약 예정, IMMINENT = 청약 임박, OPEN = 청약 중, CLOSED = 마감(최근 공고). 기본값: 예정·임박·청약 중. (English: UPCOMING, IMMINENT, OPEN (subscription open now), CLOSED.)

## `includePresaleDetails` (type: `boolean`):

켜면 단지마다 평형별 분양가, 1순위·2순위·당첨자 발표·계약 일정, 시행사·시공사, 입주 예정월을 넣습니다. 기본값: 켬. (English: add list price per unit type, subscription/winner/contract dates, developer and move-in month.)

## `proxyConfiguration` (type: `object`):

보통은 필요 없습니다(직접 연결, 막히면 자동으로 Apify Proxy 사용). 기본값 그대로 두면 됩니다. (English: not needed; leave the default.)

## Actor input object example

```json
{
  "mode": "complexes",
  "searchKeywords": [
    "은마"
  ],
  "complexIds": [],
  "regions": [],
  "propertyTypes": [
    "아파트",
    "오피스텔"
  ],
  "maxComplexes": 3,
  "historyWeeks": 52,
  "maxDeals": 20,
  "dealTypes": [
    "매매",
    "전세",
    "월세"
  ],
  "exclusiveAreas": [],
  "minHouseholds": 0,
  "maxResults": 200,
  "regionLevel": "sigungu",
  "regionFilter": [],
  "presaleStatus": [
    "UPCOMING",
    "IMMINENT",
    "OPEN"
  ],
  "includePresaleDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `unitTypes` (type: `string`):

No description

## `area` (type: `string`):

No description

## `regions` (type: `string`):

No description

## `presale` (type: `string`):

No description

## `all` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "complexes",
    "searchKeywords": [
        "은마"
    ],
    "maxComplexes": 3
};

// Run the Actor and wait for it to finish
const run = await client.actor("k-data-lab/r114-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "complexes",
    "searchKeywords": ["은마"],
    "maxComplexes": 3,
}

# Run the Actor and wait for it to finish
run = client.actor("k-data-lab/r114-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "complexes",
  "searchKeywords": [
    "은마"
  ],
  "maxComplexes": 3
}' |
apify call k-data-lab/r114-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,k-data-lab/r114-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/ySZ9ArroLHL8kNzjz/builds/yt2A7c9dfe3Pneoi9/openapi.json