APIFuseAPIFuse
문서서비스플레이그라운드상태
로그인회원가입

Service

한국 아파트 매매 실거래가

한국, 데이터베타
Playground에서 시험API 레퍼런스 열기

Overview

사람이 읽을 수 있는 한국 시군구 이름으로 정규화된 국토교통부 아파트 매매 신고를 검색하거나, 지역·월 전체 결과 집합의 기술통계를 계산합니다.

Status

정상

100.00%30일 가동률평균 응답308ms

2026-09-262026-10-112026-10-25

Setup

Auth mode
Managed key
Credentials
  • korea-apt-sale-price scope가 허용된 managed key
Sandbox
미제공

APIs

행을 선택하면 해당 API의 레퍼런스로 이동합니다.

MethodAPIPathSummary
POST/v1/korea-apt-sale-price/search-transactionsReturns apartment sale declarations for a Korean sigungu and YYYY-MM month. Use when the caller needs individual reported transactions or wants to page through a month with next_cursor. Do NOT use for min/max/median/mean price or area statistics over a whole month — use korea-apt-sale-price:summarize-region-market instead. The optional apartment_name match is applied within each returned page, so total_count is null when it is used. Prices are normalized to integer KRW. Returns items and summary (returned_count, total_count, has_more, next_cursor).
POST/v1/korea-apt-sale-price/summarize-region-marketLoads the complete apartment sale result set for one Korean sigungu and YYYY-MM month in a single request, then returns the transaction count and descriptive price and area statistics. Use when the caller wants aggregate counts or min/max/median/mean figures for a region-month. Do NOT use to list or page through individual transactions — use korea-apt-sale-price:search-transactions instead. Months with more than 2,000 reported transactions cannot be summarized and fail with UPSTREAM_PAGE_LIMIT; this operation does not predict prices or estimate property value. Returns transaction_count, price_krw, area_sqm, and apartments_distinct.

Related guides

  • sandbox key를 발급받고 첫 예약 생성까지 진행합니다.

  • 파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.

  • 예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.

  • 서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.

아파트 매매 거래 검색
지역 아파트 매매 시장 요약
빠른 시작
Managed key
개요
에러 모델