---
reviewed_by:
  rd: yo
  pm: Zoe
---
# `tw.gov.cec~ref~party` — 中選會政黨（不分區立委）參選資料

> **給 AI 閱讀的資料集說明。**
> 人類可在 https://data.openfun.tw/datasets/tw.gov.cec~ref~party 看到同份內容的網頁版。
> 詳細資料知識見 [knowledge.md](knowledge.md)。

---

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

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

最簡查詢範例：`curl -H "Authorization: Bearer YOUR_TOKEN" "https://data.openfun.tw/api/v1/datasets/tw.gov.cec~ref~party/records?per_page=100"`

**Token 是必要條件，沒有 Token 就無法查資料。**
如果使用者沒有 Token，請先請使用者前往 https://data.openfun.tw/user 申請。

禁止抓取 HTML 頁面（本平台有 bot 保護）。

授權標注：使用此資料產出的內容需標注「資料來源：歐噴資料庫（data.openfun.tw）／中央選舉委員會」

---

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

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

- 「第 11 屆立委選舉有哪些政黨參選不分區？號次、提名人數、當選席次？」
- 「某政黨歷屆不分區提名與當選席次變化」（用 `政黨名稱.政黨代碼` 串接）
- 「某屆立委不分區各政黨分到幾席？」
- 「某屆有幾個政黨推派不分區名單？」

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

- 「政黨票得票數／得票率」（本資料集只有提名數與當選席次；得票數請查 [`tw.gov.cec~txn~party-votes`](../tw.gov.cec~txn~party-votes/skill.md)）
- 「區域立委、總統或地方選舉的政黨資料」（本資料集僅立委不分區政黨票）
- 「政黨基本資料（成立日、負責人）」（請查 [`tw.gov.moi~ref~party`](../tw.gov.moi~ref~party/skill.md)）
- 「個別候選人」（請查 [`tw.gov.cec~ref~candidates`](../tw.gov.cec~ref~candidates/skill.md)）

---

## 欄位說明

| 欄位名稱 | 型別 | 說明 |
|---------|------|------|
| `識別碼` | keyword（_id） | 格式 `{選舉代碼}:{政黨代碼}`，例 `ELC-L0-7:73` |
| `選舉代碼` | keyword（篩選器、ref: [tw.gov.cec~ref~election-event](../tw.gov.cec~ref~election-event/skill.md)） | 對應 election-event 的 `vote_id`。自 `ELC-L0-7`（第 7 屆，2008）起，每屆立委選舉新增；目前涵蓋的代碼清單請用 `agg?group_by=選舉代碼` 查詢 |
| `政黨名稱` | text | 參選時登記名稱。⚠️ 為當屆申報名，與政黨代碼解析出的正式名稱可能不同 |
| `政黨名稱.政黨代碼` | keyword（篩選器、ref: tw.gov.moi~ref~party） | 政黨編號（整數），跨屆比較的穩定鍵。例 `1` 國民黨、`16` 民進黨、`350` 民眾黨 |
| `號次` | keyword | 政黨在該屆政黨票上的號次（僅當屆有效，跨屆不可比） |
| `推薦人數` | integer | 該屆登記的不分區提名（順位）人數，即名單長度 |
| `當選席次` | integer | 該屆獲分配之不分區席次；各屆全部政黨合計為 34，未過門檻者為 0 |

---

## 識別碼格式

`{選舉代碼}:{政黨代碼}`

範例 `ELC-L0-7:73`：
- `ELC-L0-7` = 第 7 屆立委選舉（對應 election-event 的 vote_id）
- `73` = 政黨代碼（對應 tw.gov.moi~ref~party 的政黨編號）

---

## 本資料集涵蓋哪些屆次

立委不分區政黨資料**自第 7 屆（2008）立委選舉起**，每屆新立委選舉就新增一批。

```bash
# 目前涵蓋的選舉代碼（屆次）清單
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.cec~ref~party/agg?group_by=選舉代碼"
```

選舉代碼格式為 `ELC-L0-{屆次}`（如 `ELC-L0-7` = 第 7 屆立委選舉）。各選舉代碼對應的屆次與投票日，JOIN [`tw.gov.cec~ref~election-event`](../tw.gov.cec~ref~election-event/skill.md) 取得（該表為選舉清單的權威來源）。

---

## 查詢範例

### 範例 1：查某屆所有參選政黨

```bash
# 某屆立委不分區全部參選政黨（以第 11 屆為例）
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.cec~ref~party/records?選舉代碼=ELC-L0-11&per_page=100"
```

### 範例 2：查某政黨歷屆參選紀錄

```bash
# 民進黨（政黨代碼 16）歷屆不分區參選
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.cec~ref~party/records?政黨名稱.政黨代碼=16&per_page=100"
```

### 範例 3：取全部資料（量小，可一次取回）

```bash
# 全部資料（資料量小，一次取回；若未來筆數超過單頁上限再分頁）
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.cec~ref~party/records?per_page=100"
```

### 範例 4：統計（各屆參選政黨數）

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.cec~ref~party/agg?group_by=選舉代碼"
```

### 範例 5：找不到對應時的處理建議

1. **政黨名稱差異**：`政黨名稱` 為當屆申報名稱，跨年代比較請改用 `政黨名稱.政黨代碼`（對應 tw.gov.moi~ref~party 的政黨編號），編號穩定、名稱會變。
2. **只有立委不分區**：本資料集不含區域立委、總統、地方選舉；查不到時可能是選舉類型不在涵蓋範圍。
3. **選舉代碼格式**：請與 [`tw.gov.cec~ref~election-event`](../tw.gov.cec~ref~election-event/skill.md) 的 `vote_id` 對照確認。本資料集自 `ELC-L0-7`（第 7 屆）起，隨屆次新增；目前涵蓋清單以 `agg?group_by=選舉代碼` 為準。

---

## 注意事項與限制

1. **沒有得票數**：本資料集只有提名人數（`推薦人數`）與當選席次（`當選席次`）。政黨票**得票數**在 [`tw.gov.cec~txn~party-votes`](../tw.gov.cec~txn~party-votes/skill.md)，以該表 `不分區政黨識別碼` 串本表 `識別碼`；不分區票的選舉人數／廢票在 [`tw.gov.cec~txn~votes-geo`](../tw.gov.cec~txn~votes-geo/skill.md)（選區代碼=`不分區`）。
2. **「推薦人數」≠「當選席次」**：前者是名單長度，後者是實際分配席次，勿混用。
3. **各屆當選席次合計恆為 34**：對應立法院全國不分區及僑居國外國民立委席次數；可用此核對資料完整性。
4. **資料量小**：每屆十餘個政黨，`per_page=100` 通常一次取回；筆數隨屆次成長，超過單頁上限再分頁。
5. **政黨名稱跨屆不一致**：同一政黨可能改名或登記不同名稱，跨屆務必用 `政黨名稱.政黨代碼`。

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.gov.cec~txn~party-votes`](../tw.gov.cec~txn~party-votes/skill.md) | 政黨票得票數 | 該表 `不分區政黨識別碼` 引用本表 `識別碼`（`{選舉代碼}:{政黨代碼}`） |
| [`tw.gov.cec~txn~votes-geo`](../tw.gov.cec~txn~votes-geo/skill.md) | 不分區票投票概況 | 選舉人數／投票數／廢票（選區代碼=`不分區`） |
| [`tw.gov.cec~ref~election-event`](../tw.gov.cec~ref~election-event/skill.md) | 歷次投票事件 | `選舉代碼` 引用其 `vote_id` |
| [`tw.gov.moi~ref~party`](../tw.gov.moi~ref~party/skill.md) | 政黨基本資料 | `政黨名稱.政黨代碼` 引用其政黨編號 |
| [`tw.gov.cec~ref~candidates`](../tw.gov.cec~ref~candidates/skill.md) | 候選人資料 | 同樣以 `選舉代碼` 串接，可比對同屆個別候選人 |

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Records URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.cec~ref~party/records` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 涵蓋範圍 | 立委不分區政黨，自第 7 屆（2008）起，每屆新增 |
| 總筆數 | 見 Portal 資料集頁面（隨屆次增加） |
| 目前涵蓋屆次 | 以 `agg?group_by=選舉代碼` 查詢 |
| 主鍵 | `識別碼`（`{選舉代碼}:{政黨代碼}`） |
| 篩選器欄位 | `選舉代碼`、`政黨名稱.政黨代碼` |
| 跨屆比較鍵 | `政黨名稱.政黨代碼`（對應 tw.gov.moi~ref~party 政黨編號） |
| 更新頻率 | 每有新一屆立委選舉即新增一批 |
| 來源 | 中選會選舉資料庫（db.cec.gov.tw） |
| 用途 | 立委不分區政黨提名與當選席次；可與選舉事件、政黨做 JOIN |