realestatelisted

# data-go-kr — 국토교통부 아파트 실거래가 Fetch a 법정동's apartment transactions for one 계약년월. Clean columns include `deal_date`, `apt_name`, `exclusive_area` (m²), `floor`, `region_code`, `dong`, `jibun`, `build_year` -- and, by operation: `deal_amount` (거래금액, **만원**) for sale/presale, or `deposit`/ `monthly_rent` (보증금·월세, **만원**) for rent. | operation | 데이터 | |---|---| | `apt_trade` | 아파트 매매 | | `apt_trade_detail` | 아파트 매매 + 도로명주소 | | `apt_rent` | 아파트 전월세 (보증금·월세) | | `apt_presale` | 아파트 분양권전매 | ## Prerequisite ``` pipx install data-go-kr # or: pip install data-go-kr ``` A data.go.kr **decoding** key must be configured (env `DATA_GO_KR_API_KEY` or `~/.config/data-go-kr/credentials.json`), and each apartment dataset (service 1613000) applied for (활용신청) on that account -- the four are separate 활용신청. ## Running ``` data-go-kr realestate <operation> <LAWD_CD> --deal-ym YYYYMM [--json] ``` - `<operation>`: `apt_trade` / `apt_trade_detail` / `apt_rent` / `apt_presale`. - `<LAWD_CD>`: the **5-digit 법정동 시군구코드** (예 종로구 `11110`, 강남구 `11680`) -- the front 5 digits of the 행정표준코드 법정동 code. - `--deal-ym`: 계약년월, `YYYYMM`. ## Procedure 1. **Get the region and month.** Map the user's district to its 5-digit LAWD_CD (ask if unsure; do not guess a code). Take the 계약년월. 2. **Pick the operation.** 매매 -> `apt_trade`; 전월세 -> `apt_rent`; 분양권 -> `apt_presale`; need the road address -> `apt_trade_detail`. 3. **Run.** ```bash data-go-kr realestate apt_trade 11110 --deal-ym 202401 ``