Cookies 使用設定
我們使用必要 cookies 維持登入與安全，並使用分析 cookies 改善產品體驗。不會用於廣告追蹤。了解更多
分類與結構
提供 deterministic 公司分類與題材映射資料，適合分群分析與跨資料集分類對齊。
/v2/datasets/theme-taxonomy公司分類 API 提供 deterministic 的公司分類與題材映射資料，來源為 `issuer_classification_map` 與 `issuer_classification_taxonomy`。
這個 endpoint 屬於已對外開放的 live route，可用於產業分群、主題篩選與跨資料集分類對齊。
至少需要提供一個 filter（ticker、market、sector、industry、theme_primary 任一），未提供時會回傳 `missing_required_filter`。
| 欄位 | 型別 | Required | 說明 |
|---|---|---|---|
| ticker | string | no | 股票代碼。 |
| market | string | no | 市場代碼（例如 TWSE、TPEx）。 |
| sector | string | no | 產業大類篩選。 |
| industry | string | no | 產業細分類篩選。 |
| theme_primary | string | no | 主題分類篩選。 |
| limit | integer | no | 回傳筆數限制（1..1000）。 |
| offset | integer | no | 分頁偏移。 |
| sort_by | string | no | 排序欄位：as_of_date 或 ticker。 |
| sort_order | string | no | 排序方向：asc 或 desc。 |
回應採 canonical envelope，頂層包含 query/meta，分類資料位於 envelope.data。
資料為 deterministic 映射結果，不包含 AI 推論分數或主觀標註欄位。
{ "api_version": "v2", "endpoint": "/v2/datasets/theme-taxonomy", "request_id": "req_theme_1a2b3c4d", "plan_id": "developer", "dataset": "theme_taxonomy", "query": { "ticker": "2330", "market": null, "sector": null, "industry": null, "theme_primary": null, "limit": 20, "offset": 0, "sort_by": "as_of_date", "sort_order": "desc" }, "meta": { "rows_returned": 1 }, "envelope": { "dataset": "theme_taxonomy", "ticker": "2330", "as_of_date": "2026-04-22", "release_date": "2026-04-22", "data": [ { "ticker": "2330", "market": "TWSE", "as_of_date": "2026-04-22", "sector": "半導體業", "industry": "晶圓代工", "subindustry": null, "theme_primary": "AI基礎設施", "theme_secondary": "高效能運算", "classification_source": "issuer_classification_map+issuer_classification_taxonomy", "provider": "twse_official", "source_role": "canonical" } ] }}| 欄位路徑 | 型別 | 說明 |
|---|---|---|
| dataset | string | 固定為 theme_taxonomy。 |
| query | object | 本次查詢條件。 |
| meta.rows_returned | integer | 回傳資料筆數。 |
| envelope.data[].ticker | string | 股票代碼。 |
| envelope.data[].market | string | 市場代碼。 |
| envelope.data[].as_of_date | string | 分類資料日期。 |
| envelope.data[].sector | string|null | 產業大類。 |
| envelope.data[].industry | string|null | 產業細類。 |
| envelope.data[].theme_primary | string|null | 主題主分類。 |
| envelope.data[].theme_secondary | string|null | 主題次分類。 |
| envelope.data[].classification_source | string|null | 分類映射來源識別。 |
| envelope.data[].source_role | string|null | 來源角色。 |
此 API 屬於 TW Market Data 資料集目錄。 查看資料集總覽