分類與結構

公司分類

提供 deterministic 公司分類與題材映射資料，適合分群分析與跨資料集分類對齊。

GET/v2/datasets/theme-taxonomy

Overview#

公司分類 API 提供 deterministic 的公司分類與題材映射資料，來源為 `issuer_classification_map` 與 `issuer_classification_taxonomy`。

這個 endpoint 屬於已對外開放的 live route，可用於產業分群、主題篩選與跨資料集分類對齊。

依 ticker 取得公司當期 sector/industry/theme 分類。
建立題材分群清單，作為篩選與監控條件。
與價格或財務資料串接，建立分類維度的橫截面分析。

Request#

至少需要提供一個 filter（ticker、market、sector、industry、theme_primary 任一），未提供時會回傳 `missing_required_filter`。

Query Parameters#

欄位	型別	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。

Response Shape#

回應採 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"
      }
    ]
  }
}

Field 說明#

欄位路徑	型別	說明
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	來源角色。

Usage Notes / 使用建議#

此主題對外路由為 `/v2/datasets/theme-taxonomy`。
若只查主題關鍵字入口，建議搭配 `/v2/search?type=theme`。
若條件查不到資料，通常回傳 200 + 空資料集合，不代表 endpoint 不可用。

Plan Requirement#

Route：/v2/datasets/theme-taxonomy
實際可用範圍與配額以控制台方案顯示為準

請求與回應

請求範例

curl --request GET \
  --url "https://api.twmarketdata.com/v2/datasets/theme-taxonomy?ticker=2330&limit=20" \
  --header "X-API-Key: your_api_key_here"

狀態碼

成功回傳公司分類資料

JSON

{
  "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"
      }
    ]
  }
}

Overview#

公司分類 API 提供 deterministic 的公司分類與題材映射資料，來源為 `issuer_classification_map` 與 `issuer_classification_taxonomy`。

這個 endpoint 屬於已對外開放的 live route，可用於產業分群、主題篩選與跨資料集分類對齊。

依 ticker 取得公司當期 sector/industry/theme 分類。

建立題材分群清單，作為篩選與監控條件。

與價格或財務資料串接，建立分類維度的橫截面分析。

Query Parameters#

欄位	型別	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。

Response Shape#

回應採 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" } ] } }

Field 說明#

欄位路徑	型別	說明
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	來源角色。