---
reviewed_by:
  rd: Ronny
  pm:
---
# 公職人員財產申報資料 — `tw.gov.cy~bulk~property-declaration`

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

---

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

資料集 slug：tw.gov.cy~bulk~property-declaration
資料類型：**bulk**（靜態檔案下載，不支援 records/agg API 查詢）
檔案根目錄：`https://bulk.data.openfun.tw/tw.gov.cy~bulk~property-declaration/`
認證方式（必填）：HTTP Header `Authorization: Bearer {token}`

最簡下載範例：
```bash
# 下載索引檔（所有申報的摘要清單）
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://bulk.data.openfun.tw/tw.gov.cy~bulk~property-declaration/list.csv" \
  -o list.csv
```

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

> ⚠️ **此資料集不支援線上篩選查詢。** 請下載 `list.csv` 後在本機處理，或下載個別 JSON 檔取得完整申報內容。

授權標注：使用此資料產出的內容需標注「資料來源：歐噴資料庫（data.openfun.tw）／監察院廉政專刊」

---

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

以下問題，這份資料集**可以回答**（需下載後自行處理）：

- 「某位公職人員申報了哪些不動產？」
- 「某位立委或議員的存款申報金額是多少？」
- 「某人在哪些機關任職時申報了財產？歷次申報紀錄是什麼？」
- 「某人的信託財產由哪家銀行受託？」
- 「某人在申報期間有哪些股票交易？（見 變動財產申報）」

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

- 「這位官員的實際財富有多少？」→ 申報書只包含申報門檻以上的項目，且市值以申報日為準，不反映現值
- 「某公職人員有沒有申報違規？」→ 本資料集只有申報內容，違規與調查結果不在其中
- 「簡任九職等以下一般公務員的財產」→ 本法只適用特定層級（簡任第十職等以上、上校以上、民意代表等）
- 「中央與地方選舉的政治獻金」→ 請查 `tw.openfun~bulk~campaign-finance`

---

## 檔案結構

```
bulk.data.openfun.tw/tw.gov.cy~bulk~property-declaration/
├── list.csv                          ← 所有申報的摘要索引
└── data-json/
    └── {姓名}/
        └── {申報日}-{服務機關}-{職稱}-{id}.json   ← 個別申報的完整 JSON
```

### list.csv 欄位

| 欄位 | 說明 |
|------|------|
| `id` | 申報唯一識別碼（用於組成 JSON 檔名） |
| `出版日` | 廉政專刊出版日期 |
| `姓名` | 申報人姓名 |
| `服務機關` | 申報時任職的機關名稱 |
| `職稱` | 申報時的職稱 |
| `申報日` | 申報日期（非廉政專刊出版日） |
| `種類` | `財產申報` / `信託財產申報` / `變動財產申報` / `信託財產管理或處分指示通知` |

---

## 使用範例

### 範例 1：下載索引，找特定人的申報記錄

```bash
# 1. 下載索引
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://bulk.data.openfun.tw/tw.gov.cy~bulk~property-declaration/list.csv" \
  -o list.csv

# 2. 本機篩選（以王金平為例）
grep "王金平" list.csv

# 3. 取得特定申報的完整 JSON（用 申報日-服務機關-職稱-id 組出路徑）
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://bulk.data.openfun.tw/tw.gov.cy~bulk~property-declaration/data-json/王金平/2015-11-23-立法院-院長-廉政專刊第100期-2.json" \
  -o record.json
```

### 範例 2：用 Python 分析

```python
import csv, urllib.request

TOKEN = "YOUR_TOKEN"

# 下載 list.csv
req = urllib.request.Request(
    "https://bulk.data.openfun.tw/tw.gov.cy~bulk~property-declaration/list.csv",
    headers={"Authorization": f"Bearer {TOKEN}"}
)
with urllib.request.urlopen(req) as r:
    rows = list(csv.DictReader(r.read().decode("utf-8").splitlines()))

# 篩選特定人的財產申報
records = [r for r in rows if r["姓名"] == "王金平" and r["種類"] == "財產申報"]
print(f"共 {len(records)} 筆")
```

### 範例 3：查股票交易明細（變動財產申報）

```bash
# 1. 從 list.csv 找變動財產申報記錄
grep "變動財產申報" list.csv | grep "某人姓名"

# 2. 下載對應 JSON（內含國內上市股票交易明細）
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://bulk.data.openfun.tw/tw.gov.cy~bulk~property-declaration/data-json/{姓名}/{申報日}-{服務機關}-{職稱}-{id}.json"
```

JSON 中 `國內上市` 欄位每筆含：`名稱`（股票）、`所有人`、`股數`、`變動時之價額`、`變動時間`、`變動原因`、`trade_direction`（`buy`/`sell`）。

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.gov.ly~ref~legislator-bioid`](../tw.gov.ly~ref~legislator-bioid/skill.md) | 立法委員識別碼 | 連結立委姓名到標準識別碼，避免同名混淆 |
| [`tw.gov.cec~ref~candidates`](../tw.gov.cec~ref~candidates/skill.md) | 中選會候選人資料 | 交叉查詢議員候選人的財產申報 |
| [`tw.openfun~bulk~campaign-finance`](../tw.openfun~bulk~campaign-finance/skill.md) | 政治獻金申報 | 同屬陽光法案系列，搭配使用可分析政治人物資金流 |

---

## 注意事項與限制

1. **申報日 vs 出版日**：篩選「某年度申報」應用 `申報日`，不要用 `出版日`（廉政專刊出版通常比申報晚數月）。法定定期申報期間為每年 **11 月 1 日至 12 月 31 日**，所以大量申報日會落在 11～12 月。
2. **申報內容不等於完整財產**：現金、存款、有價證券、債權、債務、事業投資的門檻為每類合計 **100 萬元**；珠寶古董等每件 **20 萬元**。低於門檻不須申報。不動產全部申報（無門檻）。有價證券以**申報日收盤價**計算，不反映現值。境外財產亦須申報。
3. **四種申報種類各自獨立**：一般財產申報（`財產申報`）、信託財產（`信託財產申報`）、股票交易（`變動財產申報`）是獨立申報，同一人同一年份可能有多筆不同種類。
4. **`總金額` 在變動財產申報通常為空**：完整金額需從各子清單（`存款`、`不動產:土地` 等）自行加總。金額單位為**新台幣元**。
5. **本資料集以縣市議員以上公職人員為主**：廉政專刊公告的是依法須上網公告的人員（立委、縣市議員以上），其他層級雖依法申報，但可能僅列冊供查閱、未在廉政專刊出現。
6. **姓名可能有同名問題**：用姓名篩選時，務必比對 `服務機關` 與 `職稱` 確認是否為同一人。
7. **配偶子女只有姓名**：`配偶子女` 欄位只記錄稱謂與姓名，其財產已依法彙整在申報人名下（各子清單的「所有人」欄位會標示本人/配偶/子女）。

---

## 快速參考

| 項目 | 說明 |
|------|------|
| 索引檔 | `https://bulk.data.openfun.tw/tw.gov.cy~bulk~property-declaration/list.csv` |
| JSON 路徑 | `https://bulk.data.openfun.tw/tw.gov.cy~bulk~property-declaration/data-json/{姓名}/{申報日}-{服務機關}-{職稱}-{id}.json` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 取得 Token | 免費申請：https://data.openfun.tw/user |
| 總筆數 | 32,054 筆（2026-06 時） |
| 涵蓋期間 | 1993 年 ～ 2026 年（持續更新） |
| 授權標注 | 資料來源：歐噴資料庫（data.openfun.tw）／監察院廉政專刊 |