---
reviewed_by:
  rd: tmonk
  pm:
---
# 台灣商標註冊資料 — `tw.gov.tipo~ref~trademark-reg`

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

---

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

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

最簡查詢範例：curl -H "Authorization: Bearer YOUR_TOKEN" "https://data.openfun.tw/api/v1/datasets/tw.gov.tipo~ref~trademark-reg/records?q=台積電&per_page=10"

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

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

授權標注：使用此資料產出的內容需標注「資料來源：歐噴資料庫（data.openfun.tw）／經濟部智慧財產局」

---

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

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

- 「某品牌名稱有沒有在台灣申請商標？目前狀態如何？」
- 「某公司（依統一編號）持有哪些商標？」
- 「某商標的專用截止日期是什麼時候？」
- 「某商標涵蓋哪些尼斯商品/服務類別？」
- 「某商標的代理人或審查員是誰？」

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

- 「某商標目前是否仍有效？」→ 需自行判斷 `專用截止日期` 是否已過；資料集保留歷史記錄，不標示是否失效
- 「純圖形商標（無文字）叫什麼名字？」→ `商標名稱` 欄位可能為空，無法以關鍵字搜尋

---

## 資料來源與更新頻率

| 項目 | 說明 |
|------|------|
| 原始來源 | 經濟部智慧財產局 |
| 授權 | 政府資料開放授權條款 1.0 |
| 更新頻率 | 每兩週 |
| 涵蓋範圍 | 全台商標申請記錄 |
| 總筆數 | 約 1,066,970 筆 |

---

## 欄位說明

| 欄位名稱（API 參數） | 型別 | 說明 |
|-------------------|------|------|
| `申請案號` | keyword（_id） | 主鍵，智財局受理時給予的唯一案號 |
| `商標名稱` | text（_name） | 商標文字名稱；全文搜尋：`?q=關鍵字` 或 `?q[商標名稱]=關鍵字` |
| `註冊/審定號` | keyword | 核准後的審定或註冊號碼 |
| `商標種類` | keyword | 固定值：`商標`、`團體商標`、`證明標章`、`團體標章`；可精確篩選 |
| `商標設計` | text | 色彩與型態描述，如 `(墨色)(平面)` |
| `申請日期` | date | 向智財局提出申請的日期（YYYY-MM-DD） |
| `審查人` | keyword | 智財局審查員姓名；可精確篩選或用 agg 統計 |
| `註冊公告日期` | date | 核准刊登公報的日期（YYYY-MM-DD） |
| `專用截止日期` | date | 商標專用權到期日（YYYY-MM-DD） |
| `文字描述` | text | 附加文字說明（如聲明不主張某文字的商標權） |
| `代理人[].中文姓名` | text | 申請代理人姓名（陣列，可複數） |
| `商品類別[]` | keyword | 尼斯分類類別號碼，如 `"35"`（陣列，可複數） |
| `商標權人[].中文名稱` | text | 商標權利人中文名稱（陣列，可複數） |
| `商標權人[].英文名稱` | text | 商標權利人英文名稱 |
| `商標權人[].統編` | keyword | 台灣公司統一編號（外國公司通常為 null） |
| `商標權人[].中文地址` | text | 商標權利人地址（外國申請人記錄國名） |
| `商標權人[].行政區代碼` | keyword | 行政區代碼（外國申請人通常為 null） |

---

## API 呼叫範例

**Records URL：** `https://data.openfun.tw/api/v1/datasets/tw.gov.tipo~ref~trademark-reg/records`

### 範例 1：查詢品牌名稱是誰登記的

```bash
# 查「上班不要看」的商標權人
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.tipo~ref~trademark-reg/records?q[商標名稱]=上班不要看&per_page=10"

# 查「百靈果」的商標權人
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.tipo~ref~trademark-reg/records?q[商標名稱]=百靈果&per_page=10"

# 查「股癌」的商標權人
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.tipo~ref~trademark-reg/records?q[商標名稱]=股癌&per_page=10"
```

用途：查詢特定品牌名稱的商標是由哪家公司或哪位個人持有。
回應中 `商標權人[].中文名稱` 為持有人名稱，`商標權人[].統編` 為台灣公司統一編號（個人持有者此欄位為 null）。

實際查詢結果（2026-06-11）：
- 「上班不要看」→ 商標權人：陸伍伍參伍娛樂股份有限公司（統編 42835952），台北市
- 「百靈果」→ 商標權人：綠洲道德有限公司，新北市
- 「股癌」→ 商標權人：謝孟恭（個人，無統編），台北市

---

### 範例 2：依商標名稱全文搜尋

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.tipo~ref~trademark-reg/records?q[商標名稱]=台積電&per_page=10"
```

用途：搜尋包含「台積電」的商標名稱。

---

### 範例 3：依公司統一編號查詢該公司持有的所有商標

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.tipo~ref~trademark-reg/records?商標權人.統編=22099131&per_page=20"
```

用途：精確查詢特定台灣公司（依統一編號）所持有的全部商標。

---

### 範例 4：依申請案號直接查單筆

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.tipo~ref~trademark-reg/records/099880177"
```

用途：已知申請案號，直接取得該商標完整資料。

---

### 範例 5：篩選特定商標種類

```bash
# 只查「證明標章」
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.tipo~ref~trademark-reg/records?商標種類=證明標章&per_page=20"
```

---

### 分頁查詢

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.tipo~ref~trademark-reg/records?page=2&per_page=20"
```

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

---

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

**Agg URL：** `https://data.openfun.tw/api/v1/datasets/tw.gov.tipo~ref~trademark-reg/agg`

可分組的欄位（`filter: true`）：`商標種類`、`審查人`

### 各商標種類的筆數分布

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.tipo~ref~trademark-reg/agg?group_by=商標種類"
```

### 各審查員負責件數

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.tipo~ref~trademark-reg/agg?group_by=審查人"
```

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.gov.tipo~ref~trademark-reg-category`](../tw.gov.tipo~ref~trademark-reg-category/skill.md) | 尼斯分類對照表 | 解讀 `商品類別` 欄位的類別號碼含義 |
| [`tw.gov.fia.eip~ref~business-tax`](../tw.gov.fia.eip~ref~business-tax/skill.md) | 營業稅籍資料 | 以 `商標權人.統編` 查詢商標權利人的公司詳細資料 |

---

## 注意事項與限制

1. **商標失效不會從資料集移除**：`專用截止日期` 已過的商標仍保留在資料集中，查詢結果需自行判斷有效性。
2. **純圖形商標**：`商標名稱` 可能為空，無法以文字搜尋，需用申請案號查詢。
3. **外國申請人**：`商標權人.統編` 通常為 null，`行政區代碼` 也通常為 null，`中文地址` 記錄國名。
4. **申請案號 vs 註冊/審定號**：公開資料常見的「商標註冊號」對應 `註冊/審定號` 欄位，不是 `申請案號`。

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Records URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.tipo~ref~trademark-reg/records` |
| Agg URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.tipo~ref~trademark-reg/agg` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 取得 Token | 免費申請：https://data.openfun.tw/user |
| 全文搜尋 | `?q=關鍵字`（商標名稱） |
| 欄位指定搜尋 | `?q[商標名稱]=關鍵字` |
| 精確篩選 | `?商標種類=商標`、`?商標權人.統編=12345678` |
| 分頁 | `?page=1&per_page=20` |
| 可 agg 欄位 | `商標種類`、`審查人` |
| Records 回應 | JSON，含 `total`、`page`、`per_page`、`records[]` |
| Agg 回應 | JSON，含 `total_records`、`total_groups`、`groups[].key`、`groups[].stats.count` |