reviewed_by: rd: tmonk pm: James

實價登錄（tw.gov.moi.land~ref~plvr）

版本：2026-05 最後更新：2026-05-29 維護：歐噴資料（data.openfun.tw） 授權：CC-BY 歐噴資料庫, 行政院內政部地政司 原始資料授權：政府資料開放授權條款－第1版

資料集概述

本資料集收錄內政部地政司公告的不動產成交案件實價登錄資料，涵蓋不動產買賣、預售屋買賣及不動產租賃三種類型。資料來源為 plvr.land.moi.gov.tw，歐噴每週更新。適合用來查詢特定地區不動產成交行情、租賃市場價格、特定門牌的成交紀錄等問題。

資料來源

項目 說明
原始來源 行政院內政部地政司（實價登錄開放資料下載）
原始授權 政府資料開放授權條款－第1版
歐噴取得方式 定期下載
更新頻率 每週更新
涵蓋範圍 全台 22 縣市，民國 104 年 S3 起（約 2015 年）至今

資料規模

項目 數值
總筆數 約 602 萬筆（2026-05-28）
不動產買賣 約 473 萬筆
不動產租賃 約 73 萬筆
預售屋買賣 約 56 萬筆
縣市數 22 縣市

交易類型

資料集分為三種類型（type 欄位），各有不同的欄位填寫情形：

type 值 說明 特有欄位
不動產買賣 一般成屋買賣（含土地） 主建物面積、附屬建物面積、陽台面積
預售屋買賣 預售屋簽約登錄 建案名稱、棟及號；建築完成年月通常為空
不動產租賃 租賃成交申報 出租型態、有無管理員、、租賃期間、附屬設備、租賃住宅服務、有無附傢俱

欄位說明

type

實價登錄類型（keyword，篩選器）：不動產買賣、預售屋買賣、不動產租賃。各類型的可用欄位不同，查詢前應明確指定。

season

申報季別（keyword，篩選器），格式為 {民國年}S{季}，如 114S1（民國 114 年第 1 季）。

city / 鄉鎮市區

縣市與行政區（keyword，篩選器）。city 如 臺北市；鄉鎮市區 如 大安區。city_code 為內政部原始英文代碼（a~z）。

土地位置建物門牌

土地地號或建物門牌（text，_name）。支援全文搜尋（?q=信義路四段）。純土地交易無門牌，顯示為地段地號（如「崇仰段四小段675-1地號」）。

交易(租賃)年月日.日期

西元日期格式（date），為歐噴將原始民國格式（交易(租賃)年月日）轉換所得。可用 [gte]/[lte] 篩選日期區間。

總價(額)元

成交總金額（number）。買賣類為成交總價，租賃類為月租金（非年租或合約總額）。

單價元平方公尺

每平方公尺單價（number）。所有面積欄位均為㎡，換算坪數請除以 3.3058。

建物(移轉)總面積平方公尺

建物登記總面積（㎡），含主建物＋附屬建物＋陽台。主建物面積、附屬建物面積、陽台面積 為拆分明細，部分早期資料為 null。

建物現況格局-房 / -廳 / -衛

格局欄位（number，篩選器）。可用 ?建物現況格局-房=3 篩選特定房型。

重要欄位說明

價格欄位

  • 總價(額)元：買賣類為成交總金額（元），租賃類為月租金（元）。
  • 單價元平方公尺：每平方公尺單價。面積單位全為平方公尺，換算坪數請除以 3.3058。

面積欄位

  • 建物(移轉)總面積平方公尺：建物登記總面積，含主建物＋附屬建物＋陽台。
  • 主建物面積、附屬建物面積、陽台面積：拆分明細，部分早期資料為 null。
  • 土地(移轉)面積平方公尺：土地移轉面積；純建物交易可能為 0。

日期欄位

  • 交易(租賃)年月日：原始民國格式文字（例如 1140115）。
  • 交易(租賃)年月日.日期：歐噴轉換後的西元日期（date 型別），可直接用 [gte]/[lte] 篩選區間。

位置欄位

  • city：縣市名稱（keyword），可精確篩選，例如 臺北市。
  • 鄉鎮市區：行政區（keyword），例如 大安區。
  • 土地位置建物門牌：text 型別，支援全文搜尋（?q=）。部分土地交易無門牌，顯示為地段地號。

季別欄位

  • season：格式為 {民國年}S{季}，例如 114S1（民國 114 年第 1 季）。

資料特性與限制

申報制度與準確性

實價登錄為義務申報制，依法申報者不代表完全無誤。個別案件可能有申報錯誤（面積、價格填寫有誤），不宜以單一筆資料作為精確依據，建議參考同地段多筆資料的均值。

預售屋資料的特殊性

預售屋在簽約時即申報，此時建物尚未完工，因此 建築完成年月、主建物面積、附屬建物面積、陽台面積 等欄位通常為空。

地號資料

部分交易為純土地移轉（無建物），土地位置建物門牌 欄位顯示為地段地號（例如「崇仰段四小段675-1地號」），無法用門牌搜尋。

縣市筆數分布（2026-05-28）

縣市 筆數
新北市 1,024,393
桃園市 877,620
臺中市 870,139
高雄市 693,729
臺南市 513,318
臺北市 496,273
其餘 16 縣市 合計約 546,075

更新頻率與版本記錄

版本 更新日期 說明
初版 2026-05-28 建立知識文件（依 API 實際資料格式與查詢驗證）

相關資料集

資料集 說明 關聯
tw.openfun~entity~geo 行政區代碼對照 行政區代碼 欄位可對應到完整地名

使用範例

查詢特定縣市近期不動產買賣

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~plvr/records?city=臺北市&type=不動產買賣&per_page=20"

查詢特定行政區租屋行情

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~plvr/records?city=臺中市&鄉鎮市區=西屯區&type=不動產租賃&建物現況格局-房=2&per_page=20"

各縣市不動產買賣筆數統計

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~plvr/agg?group_by=city&type=不動產買賣"

AI 使用指引

AI agent 使用指引（含篩選語法、日期區間查詢、面積換算、各類型欄位差異）見 skill.md。