---
reviewed_by:
  rd: yo
  pm:
---
# 產業別代碼對照表 — `tw.com.twse~ref~industry`

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

---

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

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

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

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

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

授權標注：使用此資料產出的內容需標注「資料來源：歐噴資料庫（data.openfun.tw）／台灣證券交易所」

---

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

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

- 「TWSE 產業別代碼 `24` 對應的產業名稱是什麼？」（→ 半導體業）
- 「『半導體業』的產業別代碼是多少？」
- 「TWSE 共有哪些產業別分類？」（共 36 筆）

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

- 「某產業別下有哪些上市公司？」（應查 `tw.com.twse~ref~listed?產業別=24`）
- 「代碼 `91` 是什麼產業？」（`91` 是存託憑證／DR 標記、不在本表內，見下方注意事項）
- 「公司的股價或財務數據」（本資料集無此資料）

---

## 資料來源與更新頻率

| 項目 | 說明 |
|------|------|
| 原始來源 | 臺灣證券交易所 ISIN 查詢系統－產業別分類（https://isin.twse.com.tw/isin/class_i.jsp?kind=1） |
| 授權 | 政府資料開放授權條款 OGDL-Taiwan-1.0 |
| 更新頻率 | 不定期（產業分類調整時更新） |
| 涵蓋範圍 | TWSE 產業別 2 碼代碼 |
| 總筆數 | 36 筆 |

---

## 欄位說明

> API 查詢時使用「欄位名稱」作為 query 參數名稱。

| 欄位名稱 | 型別 | 說明 |
|---------|------|------|
| `代碼` | keyword（_id） | 2 碼產業別代碼，含前導零（如 `01`、`24`）。可精確篩選 |
| `產業別` | text（_name） | 產業別名稱（如「半導體業」）。可全文搜尋 |

---

## API 呼叫範例

**Records URL：** `https://data.openfun.tw/api/v1/datasets/tw.com.twse~ref~industry/records`

### 範例 1：取得完整代碼↔名稱對照表

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.com.twse~ref~industry/records?per_page=100"
```

用途：一次取得全部 36 筆代碼與名稱，建成本地對照字典後批次解讀公司資料的 `產業別`。

### 範例 2：用代碼查產業名稱

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.com.twse~ref~industry/records?代碼=24"
```

用途：把公司資料裡的 `產業別=24` 解讀為「半導體業」。

### 範例 3：用名稱反查代碼

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.com.twse~ref~industry/records?q=半導體"
```

用途：先取得代碼，再去 `tw.com.twse~ref~listed?產業別=代碼` 撈該產業的公司。

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.com.twse~ref~listed`](../tw.com.twse~ref~listed/skill.md) | 上市公司基本資料 | 以 `產業別` 代碼對照本表取得名稱 |
| [`tw.com.tpex~ref~otc`](../tw.com.tpex~ref~otc/skill.md) | 上櫃公司 | `產業別` 代碼皆可由本表對照 |
| [`tw.com.tpex~ref~emerging`](../tw.com.tpex~ref~emerging/skill.md) | 興櫃公司 | `產業別` 代碼皆可由本表對照 |
| [`tw.gov.mof~ref~industry-tax`](../tw.gov.mof~ref~industry-tax/skill.md) | 財政部稅務行業分類 | 不同分類體系，勿與 TWSE 產業別混用 |

---

## 注意事項與限制

1. TWSE 產業別**非**財政部稅務行業分類，兩套代碼不可互通。
2. 本資料集為代碼對照表，非公司清單；查某產業的公司請用 `tw.com.twse~ref~listed?產業別=XX`。
3. **代碼 `91` 不在本表**：上市公司資料（`tw.com.twse~ref~listed`）有使用 `91`，實測該批公司全為**存託憑證（簡稱以 `-DR` 結尾）**，即 `91` 是存託憑證／DR 標記而非 ISIN 產業分類，故不在本表（共 36 筆）。上櫃、興櫃資料的代碼則皆可對照。
4. 代碼為含前導零的 2 碼字串（`01`…`38`，非連續，缺 07、34）。

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Records URL | `https://data.openfun.tw/api/v1/datasets/tw.com.twse~ref~industry/records` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 取得 Token | 免費申請：https://data.openfun.tw/user |
| 全文搜尋 | `?q=半導體`（對 `產業別`） |
| 精確篩選 | `?代碼=24` |
| 分頁 | `?page=1&per_page=100`（全表僅 36 筆，一頁可取完） |
| 總筆數 | 36 |