---
reviewed_by:
  rd: tmonk
  pm:
---
# 立法委員歷屆名單 — `tw.gov.ly~ref~legislator-by-term-name`

> **給 AI 閱讀的使用指引。**
> 人類可在 https://data.openfun.tw/datasets/tw.gov.ly~ref~legislator-by-term-name 看到同份內容的網頁版。
> 詳細資料知識見 [knowledge.md](knowledge.md)。

---

## ⚠️ 開始之前（AI agent 必讀，摘要也請保留這段）

資料集 slug：tw.gov.ly~ref~legislator-by-term-name
API 端點：https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-by-term-name/records
認證方式（必填）：HTTP Header  Authorization: Bearer {token}

最簡查詢範例：curl -H "Authorization: Bearer YOUR_TOKEN" "https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-by-term-name/records?per_page=20"

**Token 是必要條件，沒有 Token 就無法查資料。**
如果使用者沒有 Token，請停止並告訴使用者：「請先前往 https://data.openfun.tw/user 免費申請帳號與 API Token，取得後告訴我，我再幫您查詢。」

禁止抓取 HTML 頁面（本平台有 bot 保護，WebFetch 讀 HTML 頁面會失敗）。

授權標注：使用此資料產出的內容需標注「資料來源：歐噴資料庫（data.openfun.tw）／立法院」

---

## 資料來源與更新頻率

| 項目 | 說明 |
|------|------|
| 原始來源 | 立法院（[資料集頁面](https://data.ly.gov.tw/getds.action?id=16)） |
| 授權 | 政府開放資料授權條款－第1版（OGDL-Taiwan-1.0） |
| 更新頻率 | 每日 |
| 涵蓋範圍 | 第 2 屆至第 11 屆立法委員 |
| 總筆數 | 1,656 筆（2026-05-29 查詢） |

---

## 這份資料集能回答什麼問題

以下問題，這份資料集**可以回答**：

- 「第 11 屆立法委員有哪些人？各自屬於哪個黨？」
- 「某位委員在哪幾屆擔任立委？分別在哪個選區？」
- 「某選區歷屆立委名單為何？」
- 「現任（第 11 屆）有哪些民主進步黨女性立委？」
- 「某委員在哪些委員會服務過？」
- 「有哪些委員在任期內提前離職？原因是什麼？」

以下問題，這份資料集**無法回答**：

- 「某委員跨屆的個人完整資料（合併後的版本）」（需使用 `tw.gov.ly~ref~legislator-bioid`）
- 「立委的投票紀錄或提案紀錄」（本資料集不含議事行為資料）
- 「第 1 屆立法委員名單」（本資料集無第 1 屆資料）

---

## 重要注意事項（查詢前必讀）

**每筆記錄是「屆次 × 委員」的組合，不是委員個人。**

- 同一位委員連任多屆，就會有多筆記錄，`id` 格式為 `{屆次}-{姓名}`（如 `9-王金平`）
- 跨屆匯整委員個人資料請用 `tw.gov.ly~ref~legislator-bioid`（以 `bioId` 關聯）

---

## 欄位說明

| 欄位名稱（API 參數） | 型別 | 說明 |
|---------------------|------|------|
| `id` | keyword（_id） | 屆次與姓名組合的唯一識別碼 |
| `bioId` | keyword（ref: tw.gov.ly~ref~legislator-bioid） | 立委的唯一識別碼 |
| `term` | integer（篩選器） | 立法院屆次 |
| `name` | text（_name） | 委員中文姓名 |
| `ename` | text | 委員英文姓名 |
| `sex` | keyword（篩選器） |  |
| `party` | keyword（篩選器） |  |
| `party.id` | keyword（ref: tw.gov.moi~ref~party） |  |
| `partyGroup` | keyword |  |
| `areaName` | keyword（篩選器） |  |
| `committee` | text（多值） | 歷屆會期所屬委員會 |
| `onboardDate` | date |  |
| `degree` | text（多值） |  |
| `experience` | text（多值） |  |
| `picUrl` | keyword |  |
| `leaveFlag` | keyword（篩選器） |  |
| `leaveDate` | date |  |
| `leaveReason` | keyword |  |

### 關鍵欄位補充說明

| 欄位 | 型別 | 重要說明 |
|------|------|---------|
| `id` | keyword（_id） | 主鍵，格式 `{屆次}-{姓名}`，如 `11-丁學忠` |
| `bioId` | keyword | 委員跨屆唯一識別碼，關聯 `tw.gov.ly~ref~legislator-bioid` |
| `term` | integer（篩選器） | 立法院屆次（2–11）；`?term=11` 取現任 |
| `name` | text（_name） | 委員中文姓名；指定欄位搜尋：`?q[name]=王金平` |
| `party` | keyword（篩選器） | 黨籍名稱；`?party=民主進步黨` |
| `sex` | keyword（篩選器） | 性別：`男` 或 `女`；`?sex=女` |
| `areaName` | keyword（篩選器） | 選區名稱，需完整名稱精確比對；跨屆名稱可能不同 |
| `leaveFlag` | keyword（篩選器） | 任期內是否提前離職：`是` 或 `否`；`"否"` 不代表現任 |
| `committee` | text（multi） | 各會期委員會，格式：`第X屆第Y會期：委員會名稱` |

---

## API 呼叫範例

**Records URL：** `https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-by-term-name/records`

### 範例 1：查詢現任（第 11 屆）立法委員

```bash
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"
```

用途：取得第 11 屆所有立委（共 123 筆）。

---

### 範例 2：查詢特定黨籍的現任立委

```bash
# 第 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&party=民主進步黨&per_page=20"
```

用途：同時篩選屆次與黨籍，可再加 `sex=女` 縮小至特定性別。

---

### 範例 3：用姓名搜尋委員（跨屆）

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-by-term-name/records?q[name]=王金平&per_page=20"
```

用途：`q[name]=` 只比對姓名欄位，找出該委員各屆的任職記錄。

---

### 範例 4：查詢某選區的歷屆立委

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-by-term-name/records?areaName=臺北市第1選舉區&per_page=20"
```

用途：`areaName` 是 keyword 欄位，需完整名稱精確比對。注意：選區名稱隨屆次可能有所不同。

---

### 範例 5：查詢任期內提前離職的委員

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-by-term-name/records?leaveFlag=是&per_page=20"
```

用途：取得所有曾提前離職的任職記錄（含 `leaveDate` 和 `leaveReason`）。

---

### 範例 6：取得某筆委員記錄（已知 id）

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-by-term-name/records/11-丁學忠"
```

用途：`id` 格式為 `{屆次}-{姓名}`，直接取得單筆完整記錄。

---

### 分頁查詢

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-by-term-name/records?page=1&per_page=20"
```

回應中 `"total"` 欄位是符合條件的總筆數。

---

## 統計聚合（/agg 端點）

**Agg URL：** `https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-by-term-name/agg`

### 各屆次的立委筆數

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-by-term-name/agg?group_by=term"
```

### 各黨籍的歷屆立委總筆數

```bash
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"
```

### 現任（第 11 屆）各黨立委人數

```bash
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"
```

用途：先過濾屆次，再用 agg 統計各黨人數，一次取得全部黨籍分布。

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.gov.ly~ref~legislator-bioid`](../tw.gov.ly~ref~legislator-bioid/skill.md) | 委員個人基本資料（跨屆匯整，772 筆） | 用 `bioId` 欄位對照，取得委員的跨屆完整資料 |
| [`tw.gov.moi~ref~party`](../tw.gov.moi~ref~party/skill.md) | 政黨基本資料 | 用 `party.id` 欄位對照政黨詳細資訊 |

---

## 注意事項與限制

1. **第 1 屆無資料**：本資料集從第 2 屆開始，無第 1 屆立委資料。
2. **一委員多筆記錄**：連任多屆的委員會有多筆記錄，`id` 格式為 `{屆次}-{姓名}`，需透過 `bioId` 關聯才能彙整個人資料。
3. **`leaveFlag="否"` 不代表「現任」**：也可能是已屆滿離任的前屆委員，需同時篩選 `term` 才能確認現任。
4. **選區名稱跨屆不一致**：選區名稱因選制與行政區劃調整而有所變動，跨屆選區比較需注意名稱差異。
5. **`areaName` 精確比對**：`areaName` 是 keyword 欄位，篩選時需輸入完整選區名稱。

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Records URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-by-term-name/records` |
| Agg URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-by-term-name/agg` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 取得 Token | https://data.openfun.tw/user |
| 全文搜尋（姓名） | `?q[name]=委員姓名` |
| 篩選屆次 | `?term=11` |
| 篩選黨籍 | `?party=民主進步黨` |
| 篩選選區 | `?areaName=臺北市第1選舉區`（需完整名稱） |
| 篩選性別 | `?sex=女` |
| 篩選離職狀態 | `?leaveFlag=是` 或 `?leaveFlag=否` |
| 取單筆 | `/records/{屆次}-{姓名}` |
| 分頁 | `?page=1&per_page=20` |
| Records 回應 | JSON，含 `total`、`page`、`per_page`、`records[]` |
| Agg 回應 | JSON，含 `total_records`、`total_groups`、`groups[].key`、`groups[].stats.count` |