reviewed_by: rd: tmonk pm: James
立法委員歷屆名單（tw.gov.ly~ref~legislator-by-term-name）
版本：2026-05 最後更新：2026-05-29 維護：歐噴資料（data.openfun.tw） 授權：CC-BY 4.0 International 原始資料授權：政府開放資料授權條款－第1版（OGDL-Taiwan-1.0）
資料集概述
本資料集收錄立法院第 2 屆至第 11 屆立法委員名單，每筆記錄代表「某位委員在某一屆的任職紀錄」，包含黨籍、選區、委員會、學經歷、就職及離職資訊。同一位委員若跨多屆連任，在本資料集中會有多筆記錄。
資料來源
| 項目 | 說明 |
|---|---|
| 原始來源 | 立法院（資料集頁面） |
| 原始授權 | 政府開放資料授權條款－第1版（OGDL-Taiwan-1.0） |
| 歐噴取得方式 | API 拉取 |
| 更新頻率 | 每日 |
| 涵蓋範圍 | 第 2 屆至第 11 屆立法委員，共 1,656 筆（2026-05-29 查詢） |
資料特性與限制
資料結構：一屆一筆
每筆記錄是「屆次 × 委員」的組合，不是唯一的委員個人。同一位委員連任三屆就會有三筆記錄，id 格式為 {屆次}-{姓名}（如 9-王金平）。
若需要以「委員個人」為單位查詢（跨屆匯整），應使用關聯資料集 tw.gov.ly~ref~legislator-bioid（共 772 筆）。
涵蓋範圍
第 2 屆至第 11 屆，共 10 屆；第 1 屆無資料。各屆筆數不同，主要反映選制變革（第 3 至 6 屆立委席次較多）。 | 屆次 | 筆數 | 備註 | |------|------|------| | 第 2 屆 | 165 | | | 第 3 屆 | 171 | | | 第 4 屆 | 228 | | | 第 5 屆 | 231 | | | 第 6 屆 | 238 | 席次最多 | | 第 7 屆 | 128 | 113 席選制改制後 | | 第 8 屆 | 124 | | | 第 9 屆 | 128 | | | 第 10 屆 | 120 | | | 第 11 屆 | 123 | 現任，2024-02-01 就職 |
leaveFlag 的語意
leaveFlag="是" 代表該屆任期內提前離職（如辭職、去職、死亡），而非「已不在立法院」。leaveFlag="否" 包含兩種情況：任期正常屆滿、或現任仍在任。全資料集中有 150 筆 leaveFlag="是"。
選區名稱隨屆次變動
areaName 共有 100 種不同值，因為選制與行政區劃調整（如縣市合併），選區名稱在不同屆次有所不同。跨屆比較選區時須注意名稱可能不一致。
委員會欄位格式
committee 為陣列，每個元素格式為 第X屆第Y會期：委員會名稱，記錄該委員在該屆各會期的委員會歸屬。
欄位說明
id
屆次與姓名的組合識別碼，格式為 {屆次}-{姓名}（如 11-丁學忠）。為本資料集的 _id（唯一鍵）。
bioId
委員在立法院系統的個人唯一編號，跨屆固定不變。指向關聯資料集 tw.gov.ly~ref~legislator-bioid。
term
立法院屆次，整數，可精確篩選（filter:true）。範圍：2–11。
name
委員中文姓名，全文索引（text），可用關鍵字搜尋。
ename
委員英文姓名，全文索引（text）。
sex
性別，值為 男 或 女（keyword），可精確篩選。全資料集：男 1,235 筆、女 421 筆。
party
黨籍名稱（keyword），可精確篩選。全資料集共 12 種黨籍，主要為中國國民黨（748 筆）、民主進步黨（645 筆）、親民黨（95 筆）。
party.id
政黨編號，指向 tw.gov.moi~ref~party 資料集。
partyGroup
黨團名稱（keyword），通常與 party 相同，但無黨籍委員可能加入特定黨團。
areaName
選區名稱（keyword），可精確篩選。包含地區選區（如「臺北市第1選舉區」）、全國不分區（全國不分區 或 全國不分區及僑居國外國民，依屆次而異）。
committee
歷屆會期所屬委員會，陣列格式，每筆值格式為 第X屆第Y會期：委員會名稱。
onboardDate
就職日期（date），格式 YYYY-MM-DD。
degree
學歷，陣列格式（text, multi），可能為空陣列。
experience
經歷，陣列格式（text, multi），可能為空陣列。
picUrl
照片網址（keyword），指向立法院官網的委員照片 URL。
leaveFlag
是否於任期內提前離職（keyword），值為 是 或 否，可精確篩選。
leaveDate
離職日期（date），格式 YYYY-MM-DD；leaveFlag="否" 時為 null。
leaveReason
離職原因（keyword），如 辭職；leaveFlag="否" 時為空字串。
更新頻率與版本記錄
| 版本 | 更新日期 | 說明 |
|---|---|---|
| 初版 | 2026-05-29 | 建立知識文件（依 API 實際資料格式與查詢驗證） |
相關資料集
| 資料集 | 說明 | 關聯 |
|---|---|---|
tw.gov.ly~ref~legislator-bioid |
委員個人基本資料（跨屆匯整，772 筆） | bioId 欄位指向此資料集；需以委員為單位查詢時使用 |
tw.gov.moi~ref~party |
政黨基本資料 | party.id 欄位指向此資料集 |
使用範例
查詢現任（第 11 屆）立委
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-by-term-name/records?term=11&per_page=20"查詢某黨現任立委
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-by-term-name/records?term=11&party=民主進步黨&per_page=20"統計現任各黨人數
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-by-term-name/agg?group_by=party&term=11"AI 使用指引
AI agent 使用指引（含欄位篩選語法、agg 統計、跨屆委員查詢流程）見 skill.md。
驗證清單
| 事實陳述 | 來源檔案 | 驗證狀態 |
|---|---|---|
| 總筆數 1,656 筆 | api-schema-sample.md | ✅ 已驗證（2026-05-29 API 查詢） |
| 涵蓋第 2 屆至第 11 屆，共 10 屆 | api-schema-sample.md | ✅ 已驗證 |
| 第 11 屆 123 筆，2024-02-01 就職 | api-schema-sample.md | ✅ 已驗證 |
| 各黨籍分布（KMT 748、DPP 645 等） | api-schema-sample.md | ✅ 已驗證 |
| 性別分布（男 1,235、女 421） | api-schema-sample.md | ✅ 已驗證 |
| leaveFlag 分布（否 1,506、是 150） | api-schema-sample.md | ✅ 已驗證 |
| areaName 共 100 種不同值 | api-schema-sample.md | ✅ 已驗證 |
| legislator-bioid 資料集存在，772 筆 | api-schema-sample.md | ✅ 已驗證（API 查詢確認） |