臺灣證券交易所 OpenAPI

這一頁講的是 API，不是公開資訊觀測站：本頁實測的是臺灣證券交易所 OpenAPI（openapi.twse.com.tw）的「上市公司基本資料」資料表——一個網址就取回全部上市公司，回應是 JSON。公開資訊觀測站（MOPS）是另一個入口，內容多得多（財報、重大訊息原文、股東會資料），但新版首頁要靠 JavaScript 載入，本站還沒有實際查詢（見公司與組織分類頁）。

適用任務

想確認「這家公司是不是上市公司、什麼時候上市、登記的基本資料和其他來源對不對得上」時用它：

• 對方說自己是上市公司：用公司代號或統一編號在表裡找（上櫃、興櫃不在這張表）。這張表是某一天的快照，最近才上市或下市的公司，要再到公開資訊觀測站確認。
• 拿到統一編號，想知道對應的股票代號、簡稱、英文簡稱與公司網址。
• 整批取得上市公司的統一編號、成立日期、實收資本額與簽證會計師事務所，和經濟部商工登記對照。
• 找出「外國企業註冊地國」不是台灣的上市公司（例如註冊在開曼群島的 KY 股）。

不適合的情況：想看財報、重大訊息原文或股東會資料，回到公開資訊觀測站；公司不是上市公司（上櫃、興櫃或沒有公開發行）時，這張表找不到它，但這不代表公司不存在。只想查一家公司又不想處理 1.4 MB 的檔案，用觀測站的網頁比較直接。

輸入與前提

• 輸入：不需要輸入查詢值。資料表網址是 https://openapi.twse.com.tw/v1/opendata/t187ap03_L，伺服器每次回傳整張表，要自己用公司代號或統一編號找出要的那一筆。
• 技術前提：需要能送出 HTTPS GET 請求並處理 JSON 的工具。回應約 1.4 MB（2026-10-07 實測 1,430,061 bytes），用瀏覽器打開可以看，但要篩選最好用程式或試算表；官方規格另列 CSV 格式（本站未測）。規格（Swagger 2.0，https://openapi.twse.com.tw/v1/swagger.json）裡這張表沒有任何查詢參數，也沒有金鑰或登入的定義。
• 使用規定：證交所使用條款寫明，網站內容未經事前書面同意不得重製、散布等，「但臺灣證券交易所已授權『政府資料開放平臺』提供公眾使用之本網站資料，不在此限」；引用或轉載時「請以適當方式清楚註明資料來源，並確保資料完整性」，不得任意增刪。OpenAPI 規格的說明文字也連到使用條款與政府資料開放授權條款。
• 費用與帳號：免費，不需要註冊。
• 語言：繁體中文，連欄位名稱都是中文（例如「營利事業統一編號」）。

輸出解讀

2026-10-07 取回的表有 1,095 筆，每一筆的「出表日期」都是 1151005（民國 115 年 10 月 5 日）。以台積電那一筆為例：

上市公司基本資料的重要欄位

欄位	實測值	怎麼讀
出表日期	1151005	這份表產生的日期（民國年 7 碼）。查詢當天是 2026-10-07，表是 10 月 5 日的：資料是某一天的快照，不是即時資料。同一天下午再取時已換成 10 月 6 日的表（見〈失敗或限制〉）。
公司代號／公司簡稱	2330／台積電	股票代號與簡稱。
營利事業統一編號	22099131	用來和商工登記、稅籍資料串接的鑰匙。
外國企業註冊地國	－	「－」代表不是外國企業。整張表有 102 筆不是「－」：KY（開曼群島）96、BM 3、TH 2、SG 1。
成立日期／上市日期	19870221／19940905	這兩欄是西元 8 碼，出表日期卻是民國 7 碼，同一份表混用兩種格式。成立日期和經濟部商工登記的設立日期（1987-02-21）相同，和財政部稅籍的設立日期（1987-03-21）不同。
實收資本額	259323700670	和商工登記的實收資本額相同。
產業別	24	是代碼，不是產業名稱；這張表裡沒有代碼對照。
簽證會計師事務所	勤業眾信聯合會計師事務所	查核財報的事務所。另有兩欄簽證會計師姓名，本站不轉載。
董事長、總經理、發言人、代理發言人	有值（自然人姓名）	本站只用來確認是同一家公司，不轉載、不拿姓名去查別的資料庫。

這些資料不能證明什麼：上市只代表股票在證交所掛牌交易，不代表公司財務健全或某個推銷者真的代表這家公司；基本資料是公司申報後整理的結果，最新變更要以公開資訊觀測站的公告為準。

操作示例

以下請求都在 2026-10-07 03:45–03:46（台灣時間）實際送出，完整網址可以直接重做（不含任何查詢值）：

1. 取回整張上市公司基本資料：
   https://openapi.twse.com.tw/v1/opendata/t187ap03_L
   HTTP 200、1,430,061 bytes、1.64 秒，JSON 陣列 1,095 筆。用 curl 存檔再找台積電：

   curl -sS 'https://openapi.twse.com.tw/v1/opendata/t187ap03_L' -o listed.json

   接著用試算表或程式，在「營利事業統一編號」欄找 22099131，或在「公司代號」欄找 2330。
2. 限制案例：伺服器不幫你篩選。在網址後面加上 ?公司代號=2330，回應仍是整份 1,095 筆，和不加參數時逐位元相同。
3. 限制案例：打錯資料表代號。把 t187ap03_L 打成 t187ap03_X，回應是 HTTP 200、1,006 bytes 的 HTML，頁面上只有一張 404 圖片。程式只看狀態碼會以為成功，要確認回應的 Content-Type 是 application/json。

每一個請求的完整網址、送出時間（UTC）、回應標頭與回應檔的 SHA-256，都記在測試紀錄與本站保存的證據清單裡；回應裡的自然人姓名與電子郵件信箱在證據檔中已遮罩。同一天 04:08，另一個 AI 代理用上面三個網址重做，三個回應都和原測試逐位元相同（重做紀錄）；兩次測試在同一台機器、同一個網路，不算跨環境驗證。

失敗或限制

• 只有上市公司：這張表沒有上櫃、興櫃公司；證交所規格裡也沒有上櫃、興櫃公司的基本資料表（提到「上櫃」的只有兩張上市上櫃跨市場的交易彙總表）。上櫃、興櫃要看櫃買中心的 OpenAPI（本站只讀了規格，未實測）。
• 錯誤也回 HTTP 200：打錯資料表代號時回 200 加一頁 HTML，不是 404。
• 沒有查詢參數：每次都要下載整張表（約 1.4 MB）再自己篩選。
• 是快照，不是即時資料：2026-10-07 凌晨取得的表，出表日期是 2026-10-05；同一天 14:14（台灣時間）審查時再取，出表日期已變成 2026-10-06，有 8 家公司的實收資本額與已發行股數不同，台積電那一筆除了出表日期都沒變（審查重做紀錄）。官方規格沒有寫更新頻率；引用時要寫明出表日期。
• 回應時間不一：整張表凌晨那次 1.64 秒就回來，下午重取時花了 13–18 秒。
• 日期格式混用：出表日期是民國 7 碼，成立、上市日期是西元 8 碼。
• 本次沒有測的：其他 142 張資料表（例如每日重大訊息、裁罰案件）、CSV 格式，以及公開資訊觀測站網頁。

來源比較

• 公開資訊觀測站：公司自行申報的完整資料（財報、重大訊息原文、股東會資料），不只基本資料；收錄範圍本站沒有讀到官方的完整說明，而且要在瀏覽器操作，不適合整批取用。只查一家公司的公告，用觀測站；要整批核對統編、日期、資本額，用本頁的 API。
• 櫃買中心 OpenAPI：上櫃、興櫃、創櫃公司的對應資料表。依官方規格，基本資料的欄位和證交所這張表幾乎一樣（櫃買中心規格列 32 欄，少了中文的「住址」），但欄位名稱是英文（例如 UnifiedBusinessNo.），合併兩邊時要自己對照。
• 經濟部商工登記 API：回答登記狀態、登記機關與董監事，涵蓋所有公司，不限上市。上市公司表回答的是「有沒有在證交所掛牌、何時掛牌」。先用商工登記確認公司存在且核准設立，再用這張表確認是不是上市公司。

隱私與使用界線

這張表不需要你輸入任何查詢值，請求只會送到證交所，不會透露你在查哪一家公司。回應裡有董事長、總經理、發言人、代理發言人與簽證會計師的姓名，以及公司的電子郵件信箱：本站只把姓名當成確認公司身分的輔助欄位，不轉載、不從姓名出發去查一個人擔任哪些公司、不建立人物關係圖。轉用這份資料時，依證交所使用條款註明來源。