realestatelisted

# datagokr — 국토교통부 아파트 실거래가 Fetch a 시군구's apartment transactions for one 계약년월. Clean columns include `deal_date`, `apt_name`, `exclusive_area` (m²), `floor`, `lawd_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 pydatagokr # or: pip install pydatagokr ``` **Never print the key value** (the `DATAGOKR_API_KEY` env var or `credentials.json`) to output, logs, or a summary -- if you need to check which form it is (encoding vs decoding), ask the user. A data.go.kr **decoding** key must be configured (env `DATAGOKR_API_KEY` or `~/.config/pydatagokr/credentials.json`), and each apartment dataset (service 1613000) applied for (활용신청) on that account -- the four are separate 활용신청. ## Running ``` datagokr 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. **Resolve the region code.** Turn the 시군구 name into its LAWD_CD with the offline resolver -- `datagokr lawd 종로구` -> `11110` (add a 시도 when the name is ambiguous, e.