AI agent？先讀 /llms.txt 取得全站索引。
公司與事件
上市櫃公司 ESG（TESG）評分——永續綜合評分及其環境、社會與公司治理三大構面，彙整自官方揭露。
GET /v2/datasets/esg-tesgesg-tesg 為推導型資料集：TESG 綜合評分與其環境／社會／治理三構面分數，由官方企業永續揭露彙整計算而得，非以單一原始數字發布。lineage 欄位標明每個分數的推導來源，評等可稽核而非黑箱。每家公司每個評估期間一列。
| 欄位 | 型別 | 說明 |
|---|---|---|
symbol | string | 股票代碼。 |
period | string | 評估期間（如 2025）。 |
tesg_score | number | TESG 綜合評分。 |
environment_score | number | 環境構面分數。 |
social_score | number | 社會構面分數。 |
governance_score | number | 公司治理構面分數。 |
source_role | string | 正規來源角色（derived_twse_tesg）。 |
| 列數 | 10,088 |
| 涵蓋起訖 | 2026-06-05（單日快照） |
| 分級 | 衍生 |
此為本端點的真實回應。資料列位於 "data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "dataset_id": "esg_tesg", "request_context": { "scope": "esg_tesg_official_open_ghg_only", "coverage_type": "official_open_current_snapshot_only", "filters": { "ticker": null, "market": null, "report_year": null, "as_of_date": null, "subfamily": null, "metric_name": null, "disclosure_status": null, "source_family": null, "limit": 50 }, "min_as_of_date": "2026-06-05", "max_as_of_date": "2026-06-05" }, "quality": { "row_count": 50, "ticker_count": 9, "sensitive_fields_exposed": false }, "lineage": { "source_providers": [ "twse_official" ], "source_roles": [ "esg_tesg_official_open" ], "source_families": [ "twse_ghg" ] }, "error": null, "data": [ { "ticker": "1101", "market": "TWSE", "report_year": 2024, "as_of_date": "2026-06-05", "subfamily": "ghg_carbon_disclosure", "metric_name": "scope1_assurance", "metric_value": "是", "metric_unit": null, "disclosure_status": "disclosed", "source_provider": "twse_official", "source_role": "esg_tesg_official_open", "source_family": "twse_ghg", "lineage": { "row_index": 0, "source_url": "https://openapi.twse.com.tw/v1/opendata/t187ap46_L_1", "source_column": "範疇一取得驗證" }, "data_gaps": [], "not_investment_advice": true }, { "ticker": "1101", "market": "TWSE", "report_year": 2024, "as_of_date": "2026-06-05", "subfamily": "ghg_carbon_disclosure", "metric_name": "scope1_emissions_tco2e", "metric_value": "39544430.9992", "metric_unit": "噸CO2e", "disclosure_status": "disclosed", "source_provider": "twse_official", "source_role": "esg_tesg_official_open", "source_family": "twse_ghg", "lineage": { "row_index": 0, "source_url": "https://openapi.twse.com.tw/v1/opendata/t187ap46_L_1", "source_column": "範疇一排放量(噸CO2e)" }, "data_gaps": [], "not_investment_advice": true } ], "data_count": 50, "known_gaps": [ "official_open_current_snapshot_only", "ghg_only_initial_baseline", "no_paid_commercial_tesg_parity_claim" ], "warnings": [ "not_investment_advice" ], "not_investment_advice": true, "envelope": { "dataset_id": "esg_tesg", "scope": "esg_tesg_official_open_ghg_only", "row_count": 50 }}擷取自 2026-07-20 的線上 API。
本頁顯示原始中文值；英文頁會以標記取代，以維持全英文。
curl "https://api.twmarketdata.com/v2/datasets/esg-tesg?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 | 回傳筆數上限。 |
第一個呼叫：
import requests resp = requests.get( "https://api.twmarketdata.com/v2/datasets/esg-tesg", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json()["data"])帶日期區間篩選：
import requests # The full verified example — the same call with every supported filter set.resp = requests.get( "https://api.twmarketdata.com/v2/datasets/esg-tesg", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]: print(row)此端點為 GET /v2/datasets/esg-tesg。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。