---
reviewed_by:
  rd: Ronny
  pm: Zoe
---
# `tw.gov.moi~ref~party` — 政黨資訊網政黨資料

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

---

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

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

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

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

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

授權標注：使用此資料產出的內容需標注「資料來源：歐噴資料庫（data.openfun.tw）／內政部政黨資訊網」

---

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

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

- 「中華民國有多少個合法政黨？」（見 Portal 資料集頁面，含廢止與自行解散）
- 「目前還在運作的政黨有哪些？」（用 `政黨狀態=一般` 篩選）
- 「某政黨的負責人、成立日期、地址、官網？」
- 「最近新登記的政黨有哪些？」（依 `備案日期` 排序）

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

- 「政黨歷年得票數」（請查中選會選舉資料）
- 「政黨黨員人數」（原始資料未提供）
- 「政黨之間的合縱連橫」（不含關係欄位）
- 「政黨目前的董事長/負責人名冊、主事務所詳細登記資料」→ 依政黨法第9條，政黨完成備案後**必須**向法院辦理法人登記；法院端的詳細登記資料請查 [`tw.gov.judicial~ref~foundation-doc`](../tw.gov.judicial~ref~foundation-doc/skill.md)（以 `類別=3` 篩選政黨）

---

## 欄位說明

| 欄位名稱 | 型別 | 說明 |
|---------|------|------|
| `政黨編號` | keyword（_id） | 政黨編號（內政部核發） |
| `名稱` | text（_name） | 政黨名稱 |
| `政黨狀態` | keyword（篩選器） | `一般` / `廢止備案` / `自行解散` 等 |
| `負責人` | text | 主席或負責人姓名 |
| `成立日期` | date | 政黨成立日 |
| `備案日期` | date | 向內政部備案日 |
| `主事務所地址` | text | 登記地址 |
| `通訊地址` | text | 通訊地址 |
| `通訊電話` | text | 聯絡電話 |
| `法人設立登記日期` | date | 政黨法人登記日 |
| `法人變更登記日期` | date | 最近一次變更登記日 |
| `政黨官網` | text | 官方網站 URL |
| `url` | text | 政黨資訊網上對應之頁面 URL |
| `章程` | text | 章程 PDF URL |
| `備註` | text | 自由文字備註 |

---

## 查詢範例

### 範例 1：列出目前有效政黨

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.moi~ref~party/records?政黨狀態=一般&per_page=100"
```

### 範例 2：以名稱搜尋政黨

```bash
# 全文搜尋
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.moi~ref~party/records?q=綠黨&per_page=10"
```

### 範例 3：依政黨狀態統計

```bash
# 各狀態分布
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.moi~ref~party/agg?group_by=政黨狀態"
```

### 範例 4：查特定政黨

```bash
# 民主進步黨（政黨編號 16）
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.moi~ref~party/records/16"

# 中國國民黨（政黨編號 1）
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.moi~ref~party/records/1"
```

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

1. **名稱可能略有差異**：政黨曾改名（如「時代力量」前身、「親民黨」等）；建議用 `q=` 模糊搜尋而非精確比對 `名稱`。
2. **以選舉時使用之名稱對照**：政治獻金、候選人資料可能使用簡稱（如「民眾黨」對應「台灣民眾黨」），需多試幾個關鍵字。
3. **狀態為「廢止備案」與「自行解散」的政黨**：歷史紀錄會保留在本資料集中。

### 範例 6：精確連結法院登記資料（透過 `法人編號.政黨編號`）

`tw.gov.judicial~ref~foundation` 的政黨（類別=3）記錄含有 `法人編號.政黨編號` 欄位，其值對應本資料集的 `政黨編號`，由系統自動比對產生，**不需要模糊比對名稱**。

**步驟 1：從法院資料找到對應政黨的法人紀錄**

```bash
# 用政黨編號直接篩選（如民進黨政黨編號=16）
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.judicial~ref~foundation/records?法人編號.政黨編號=16&類別=3"
```

**步驟 2：取得最新公告文號，查詳細登記內容**

```bash
# 以步驟 1 回傳的最新公告文號查 foundation-doc
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.judicial~ref~foundation-doc/records/{最新公告文號}"
```

**注意**：政黨法於 2017-12-06 生效，因此**只有 2017-12-06 之後有過法院登記異動的政黨**才有法院端紀錄。國民黨、民進黨等老政黨若 2017 年後無異動，可能不在 `tw.gov.judicial~ref~foundation` 中；此時請改以名稱搜尋（`q=`）確認是否有記錄。

---

## API 呼叫範例

### 列出最近新登記的政黨

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.moi~ref~party/records?_sort=備案日期:desc&per_page=20"
```

### 批次查多個政黨

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.moi~ref~party/records?_ids=1,16,260"
```

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.gov.judicial~ref~foundation`](../tw.gov.judicial~ref~foundation/skill.md) | 法人主索引 | 政黨（類別=3）含 `法人編號.政黨編號` 欄位，可精確對應本資料集的 `政黨編號`，不需模糊比對名稱 |
| [`tw.gov.judicial~ref~foundation-doc`](../tw.gov.judicial~ref~foundation-doc/skill.md) | 法人詳細登記資料 | 查政黨在法院端的詳細登記（類別=3），含主事務所、負責人名冊、歷次變更 |
| [`tw.gov.cec~ref~candidates`](../tw.gov.cec~ref~candidates/skill.md) | 中選會候選人資料 | 候選人所屬政黨可對照本資料集 |
| [`tw.openfun~bulk~campaign-finance`](../tw.openfun~bulk~campaign-finance/skill.md) | 政治獻金申報 | `擬參選人／政黨` 欄位中政黨類紀錄可對照 |
| [`tw.gov.cec~ref~election-event`](../tw.gov.cec~ref~election-event/skill.md) | 歷次投票事件 | 政黨參與歷屆選舉時序對照 |

---

## 注意事項與限制

1. **包含歷史已解散政黨**：資料集中相當比例為「廢止備案」或「自行解散」；分析現況時請以 `政黨狀態=一般` 過濾。
2. **本資料集（內政部）與法院登記資料（司法院）為互補來源**：本資料集記錄備案狀態與政黨基本資料；法院端（`tw.gov.judicial~ref~foundation-doc`，類別=3）記錄每次設立/變更的詳細登記公告。兩者可透過 `tw.gov.judicial~ref~foundation` 的 `法人編號.政黨編號` 欄位精確對應本資料集的 `政黨編號`（不需模糊比對名稱）。惟法院資料僅涵蓋 **2017-12-06（政黨法生效日）之後**有過異動的政黨，老政黨若無 2017 年後異動則不在其中。
3. **負責人只記錄現任**：`負責人` 欄位為當前資訊，歷史負責人變動不在本資料集追蹤。若需查某政黨歷次黨主席／負責人的異動紀錄，請改用 [`tw.gov.judicial~ref~foundation`](../tw.gov.judicial~ref~foundation/skill.md) 搜尋該政黨的法人編號與公告文號，再至 [`tw.gov.judicial~ref~foundation-doc`](../tw.gov.judicial~ref~foundation-doc/skill.md) 查每一次登記公告的完整內容（含負責人欄位的歷程）。
4. **部分舊政黨資料不全**：早期已廢止政黨可能只有名稱與政黨編號，其他欄位為空。
5. **`成立日期` 可能早於民國**：如中國國民黨成立於 1893-11-24，遠早於民國成立。
6. **「成立」與「登記」是不同的**：`成立日期` 是政黨自行宣告成立的日期，`備案日期` 是向內政部完成登記的日期，兩者可能相差數十年甚至更久。若使用者問「最近成立的政黨」或「最早成立的政黨」，請先說明此差異，並詢問他們想依哪個日期排序——通常「最近新成立」依 `備案日期` 較有意義，「歷史最悠久」則依 `成立日期` 但需注意部分政黨宣稱的成立年代可能早於中華民國。

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Records URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.moi~ref~party/records` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 總筆數 | 見 Portal 資料集頁面 |
| 主鍵 | `政黨編號`（keyword） |
| 篩選器欄位 | `政黨狀態` |
| 更新頻率 | 每日 |
| 來源 | 內政部政黨資訊網 |
| 用途 | 政黨基本資料對照、JOIN key |