TW Market Data LogoTW Market Data

AI agent？先讀 /llms.txt 取得全站索引。

公司與事件

公司新聞

公司新聞

參考來源: TWMD·方案: pro·計費: 2 點·GET /v2/datasets/company-news

公司新聞是台灣市場資料集,來源為 TWMD,由 TW Market Data 以 GET /v2/datasets/company-news 提供。

總覽

公司新聞——後端 meta 未提供 grain,故此處不述。

欄位型別說明
tickerstring
marketstring
published_atstring
headlinestring
summarynull
content_urlstring
languagestring
metadata_onlyboolean
source_attribution_requiredboolean

範例回應

此為本端點的真實回應。資料列位於 "envelope.data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。

{  "api_version": "v2",  "endpoint": "/v2/datasets/company-news",  "request_id": "req_d9fc3d83537d",  "plan_id": "enterprise",  "dataset": "company_news",  "query": {    "ticker": "2601",    "date_from": null,    "date_to": null,    "source_name": null,    "keyword": null,    "limit": 50  },  "meta": {    "rows_returned": 8,    "metadata_only": true,    "internal_only": true,    "production_exposure": false,    "public_exposure": false,    "source_attribution_required": true,    "allowed_filters": [      "ticker",      "date_from",      "date_to"    ],    "allowlist_fields": [      "ticker",      "market",      "published_at"    ],    "safe_usage_notes": [      "not_investment_advice",      "metadata_only",      "source_attribution_required"    ],    "mandatory_contract_fields_present": [      "api_version",      "data",      "data_as_of"    ],    "plan": "enterprise",    "row_limit": 100000,    "is_limited": false  },  "not_investment_advice": true,  "envelope": {    "api_version": "v2",    "dataset": "company_news",    "dataset_version": "v2.0.0-preview",    "release_version": "v2.2026-06-18T18:17:45.preview",    "release_date": "2026-06-18T18:17:45",    "data_as_of": "2026-06-18T18:17:45",    "request_context": {      "ticker": "2601",      "as_of_date": "2026-06-18T18:17:45",      "family": "issuer_official_news",      "field_group_type": "derived",      "dataset_view": "company_news_v1"    },    "data": [      {        "ticker": "2601",        "market": "TW",        "published_at": "2026-06-18T18:17:45",        "headline": "公告本公司第六屆薪酬委員會當選名單",        "summary": null,        "content_url": "https://mopsov.twse.com.tw/mops/web/ajax_t05sr01_1",        "source_name": "mops_official",        "provider": "mops_official",        "source_role": "canonical",        "language": "zh-TW",        "lineage": {          "as_of_date": "2026-06-18",          "record_index": 31,          "fallback_chain": [],          "selected_source": "mops_official",          "canonical_row_id": 1        },        "created_at": "2026-06-18T16:19:49.181508",        "updated_at": "2026-08-05T07:40:18.819417",        "not_investment_advice": true,        "metadata_only": true,        "source_attribution_required": true      },      {        "ticker": "2601",        "market": "TW",        "published_at": "2026-06-18T18:17:11",        "headline": "公告本公司第三屆提名委員會當選名單",        "summary": null,        "content_url": "https://mopsov.twse.com.tw/mops/web/ajax_t05sr01_1",        "source_name": "mops_official",        "provider": "mops_official",        "source_role": "canonical",        "language": "zh-TW",        "lineage": {          "as_of_date": "2026-06-18",          "record_index": 30,          "fallback_chain": [],          "selected_source": "mops_official",          "canonical_row_id": 1        },        "created_at": "2026-06-18T16:19:49.181508",        "updated_at": "2026-08-05T07:40:18.819417",        "not_investment_advice": true,        "metadata_only": true,        "source_attribution_required": true      }    ],    "quality": {      "freshness_state": "fresh",      "freshness_as_of": "2026-06-18T18:17:45",      "completeness_ratio": 1,      "quality_status": "ready"    },    "lineage": {      "source_role": "canonical",      "selected_source": "company_news",      "fallback_chain": [],      "policy_notes": [        "company news productized table serving path",        "contract-aligned filters: ticker/date_from/date_to/source_name/keyword/limit",        "metadata-only allowlist fields only"      ]    },    "error": {      "error_code": null,      "error_message": null,      "dataset": "company_news",      "request_id": "read-api-464f78c9acfb",      "blocking_gate": null    }  }}

擷取自 2026-07-20 的線上 API。

本頁顯示原始中文值；英文頁會以標記取代，以維持全英文。

出處

以下欄位會隨資料一併回傳,記錄這一列的來源。它們屬於出處而非本資料集要講的事實,因此列在這裡而不進欄位表。

source_nameprovidersource_rolelineagecreated_atupdated_atnot_investment_advice

相關資料集

可與本資料集對齊的其他資料集。每組都標出可用來 join 的欄位,規劃跨表查詢時不必自己猜。

快速開始

  1. 把你的金鑰放進 X-API-Key 標頭。
  2. 加上查詢參數（symbol、日期區間、limit）。
  3. 送出請求並讀取 envelope.data 陣列。
curl "https://api.twmarketdata.com/v2/datasets/company-news?symbol=2330" \  -H "X-API-Key: sk_live_..."

篩選參數

參數必填型別說明
symbol是string股票代碼，例如 2330。
start_date否string (YYYY-MM-DD)查詢起始日期。
end_date否string (YYYY-MM-DD)查詢結束日期。
limit否integer回傳筆數上限。

Python 範例

第一個呼叫：

import requests resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/company-news",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json()["envelope"]["data"])

帶日期區間篩選：

import requests # The full verified example — the same call with every supported filter set.resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/company-news",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["envelope"]["data"]:    print(row)

OpenAPI

此端點為 GET /v2/datasets/company-news。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。

備註與限制

  • knowledge_time_field 為 published_at,且後端標記為非 point-in-time safe;後端 meta 未提供 grain 與欄位清單,故不列欄位表。