公司與事件
公告資訊
提供台股公司的公告與揭露事件資料，適合用於事件追蹤、研究流程與訊號整合。
GET
/v2/datasets/issuer-announcementsOverview#
公告資訊 API 提供公司對外揭露公告資料，適合用於事件追蹤、披露監控與研究流程。
此 endpoint 為 productized public route，查詢參數與回應契約以 backend runtime 為準。
- 追蹤單一公司的公告歷史
- 建立重大揭露事件時間線
- 搭配價格與財務資料做事件對照分析
- 作為監控與研究流程的官方披露來源
Request#
使用此 endpoint 時，建議：
Query Parameters#
| 欄位 | 型別 | Required | 說明 |
|---|---|---|---|
| ticker | string | yes | 股票代碼，用於查詢單一公司公告資料。 |
| date_from | string | no | 查詢起始日期（YYYY-MM-DD）。 |
| date_to | string | no | 查詢結束日期（YYYY-MM-DD）。 |
| category | string | no | 公告分類過濾。 |
| limit | integer | no | 回傳筆數限制。 |
| offset | integer | no | 分頁偏移。 |
| sort_by | string | no | 排序欄位，固定為 announcement_date。 |
| sort_order | string | no | 排序方向：asc 或 desc。 |
Response Shape#
回應為 canonical envelope 格式，頂層包含 api_version、endpoint、dataset、query、meta、envelope。
{
"api_version": "v2",
"endpoint": "/v2/datasets/issuer-announcements",
"request_id": "req_9af2d5b1c321",
"plan_id": "pro",
"dataset": "issuer_announcements",
"query": {
"ticker": "2330",
"date_from": "2026-04-01",
"date_to": "2026-04-22",
"category": "financial",
"limit": 20,
"offset": 0,
"sort_by": "announcement_date",
"sort_order": "desc"
},
"meta": {
"rows_returned": 1
},
"envelope": {
"api_version": "v2",
"dataset": "issuer_announcements",
"release_date": "2026-04-22",
"request_context": {
"ticker": "2330",
"as_of_date": "2026-04-22",
"family": "issuer_official_news",
"dataset_view": "issuer_announcements_v1"
},
"data": [
{
"ticker": "2330",
"announcement_date": "2026-04-22",
"category": "financial",
"title": "公告本公司董事會通過第一季財務報告",
"source_url": "https://mops.twse.com.tw/..."
}
],
"quality": {
"freshness_state": "fresh",
"freshness_as_of": "2026-04-22",
"completeness_ratio": 1,
"quality_status": "ready"
},
"lineage": {
"source_role": "canonical",
"selected_source": "mops_official"
},
"error": {
"error_code": null,
"error_message": null,
"blocking_gate": null
}
}
}Field 說明#
| 欄位路徑 | 型別 | 說明 |
|---|---|---|
| dataset | string | 資料集識別，固定為 issuer_announcements。 |
| query.ticker | string | 本次查詢使用的股票代碼。 |
| meta.rows_returned | integer | 回傳資料筆數。 |
| envelope.data[].ticker | string | 股票代碼。 |
| envelope.data[].announcement_date | string | 公告日期。 |
| envelope.data[].category | string|null | 公告分類。 |
| envelope.data[].title | string|null | 公告標題。 |
| envelope.data[].source_url | string|null | 來源連結。 |
| envelope.lineage.source_role | string | 來源角色（canonical）。 |
Usage Notes / 使用建議#
- 此頁為 productized endpoint，請勿與 legacy 回應格式混用。
- 若要做事件整合分析，可搭配 `/v2/datasets/events` 與 `/v2/datasets/structured-events`。
- 若需要較高頻價格對照，建議搭配 TWSE/TPEx 日線價格 endpoint。
Plan Requirement#
- Free（限制）
- Developer
- Pro
- Enterprise