reviewed_by: rd: Ronny pm:
tw.openfun~api~company — 台灣公司資料 API
版本:2026-06 最後更新:2026-06-02 維護:歐噴資料(data.openfun.tw) 授權:CC-BY 歐噴,經濟部 原始資料授權:政府資料開放授權條款-第1版
資料集概述
台灣公司登記資料查詢 API,由歐噴維護於 company.g0v.ronny.tw。原始資料來源為經濟部商業發展署商工行政資料開放平台,每日同步更新。提供依統一編號查詢、批量查詢、依名稱/地址/人名/母公司統編搜尋等六個端點,適合 KYC 盡職調查、統編對照公司資訊、董監事網絡分析等用途。
資料來源
| 項目 | 說明 |
|---|---|
| 原始資料 | 經濟部商業發展署商工行政資料開放平台(https://data.gcis.nat.gov.tw/) |
| 政府開放平台 | https://data.gov.tw/dataset/9400 |
| 原始授權 | 政府資料開放授權條款-第1版 |
| API 服務 | 歐噴維護(company.g0v.ronny.tw) |
| 更新頻率 | 每日 |
API 端點概覽
共 6 個端點,Base URL:https://company.g0v.ronny.tw
| 端點 | 用途 |
|---|---|
GET /api/show/{id} |
依統編查詢單一公司完整資料 |
GET /api/bulkquery |
批量查詢多間公司(分號分隔統編) |
GET /api/search |
依公司名稱或地址搜尋 |
GET /api/fund |
依董監事「所代表法人」搜尋 |
GET /api/name |
依人名搜尋(代表人、董監事、經理人) |
GET /api/branch |
依母公司統編搜尋其所有分公司 |
回傳欄位說明
公司基本資料(/api/show/{id} 回傳)
| 欄位 | 說明 |
|---|---|
公司狀況 |
如「核准設立」、「廢止」、「撤銷」等 |
名稱 |
公司目前登記名稱 |
資本總額 |
登記資本額(新台幣) |
代表人 |
公司負責人/代表人姓名 |
地址 |
登記地址 |
登記機關 |
核准登記的主管機關 |
核准設立日期 |
公司正式核准日期 |
營業項目 |
登記的業務項目代碼與名稱 |
董監事名單 |
董事、監察人清單(含姓名、持股、所代表法人) |
經理人名單 |
經理人清單(含姓名、任職日期) |
changelog |
歷次變更紀錄(需帶 with_changelog=true 參數) |
資料特性與限制
統一編號的穩定性與限制
統一編號(8 碼)在同一公司或行號的存續期間是穩定的——改名、遷址、變更負責人都不影響統編,跨資料集 JOIN 應以統編為主鍵。
但統編並非永久不重複使用:公司廢止或行號歇業後,該統編在一段時間後可能被重新配發給新的公司或行號。因此:
- 以統編為 JOIN key 時,務必確認雙方資料的時間點是否一致
- 若歷史資料庫中某統編對應的公司名稱,與本 API 查到的不同,可能是統編已被重新使用
- 長期追蹤特定公司時,應同時記錄公司名稱(或設立日期)作為輔助驗證
公司名稱可能改變
歷史上有大量公司曾改名,本 API 的 名稱 欄位只顯示目前登記名稱;歷史名稱需透過 with_changelog=true 取得變更紀錄。
涵蓋範圍
- 涵蓋全台依《公司法》登記的公司(有限公司、股份有限公司等)
- 也包含行號(商號):行號依《商業登記法》登記,本 API 同樣收錄
- 已廢止、撤銷的公司與行號仍保留記錄,查詢時可用
alive_only=true只取存續者 - 如何區分公司與行號:回傳記錄含
公司名稱欄位者為公司;含商業名稱者為行號
搜尋結果分頁
/api/search、/api/fund、/api/name、/api/branch 均支援分頁(page 參數,從 1 開始),回傳含 found(總筆數)與 data(當頁資料)。
地址搜尋時的特殊現象:商務中心
以地址搜尋(address: 前綴)若發現單一地址下登記了大量公司,通常代表該地址是商務中心(商業秘書服務)——公司以此地址作為登記地址,實際辦公地點另在他處。這在台灣商業環境中相當常見,分析地址資料時需留意此現象。
公司名稱的唯一性規則
- 公司名稱全國唯一:存續中的公司不能有兩家同名。公司名稱由「特取名稱 + 組織類型」組成(如「歐噴有限公司」)。
- 廢止後名稱可再使用:公司廢止或撤銷後,其特取名稱可以被新公司再次登記使用。因此同一名稱在歷史上可能對應多個不同統編的公司。
- 行號名稱非全國唯一:商號名稱只在同一縣市或登記機關管轄範圍內不得重複,全國可以有多家同名行號(例如台北有「大安便利商行」,高雄也可以有另一家「大安便利商行」)。
公司與行號的欄位差異
回傳記錄依登記類型不同,欄位名稱會有差異:
| 欄位意義 | 公司(公司法) | 行號(商業登記法) |
|---|---|---|
| 名稱 | 公司名稱 |
商業名稱 |
| 負責人 | 代表人姓名 |
負責人姓名 |
| 資本 | 資本總額(元) |
資本額(元) |
| 狀況 | 公司狀況 / 登記現況 |
現況 / 登記現況 |
| 營業項目 | 所營事業資料(結構化陣列) |
營業項目(文字,格式不一) |
| 股東/出資 | 董監事名單(含出資額) |
出資額(元) |
| 法人代表 | 董監事名單.所代表法人 |
無 |
| 經理人 | 經理人名單 |
無 |
| 組織 | 欄位值含公司類型 | 組織類型(獨資/合夥) |
所營事業資料的格式與限制
格式不一致:
- 較新登記或有更新過的公司:
所營事業資料為結構化陣列,每個項目是["代碼", "業別名稱"] - 行號的
營業項目欄位格式更為混亂:早年可能是純文字(如「1. 日用什貨批發。2. 菸酒批發。」),近年則可能嵌入代碼但格式不一致
所營事業資料不精準:
- 除了少數特許行業(如旅行業、計程車業、典當業等)需要主管機關許可才能登記外,大部分業別是公司自行勾選登記,並不代表公司真正有在經營該業務
- 因此
所營事業資料僅供參考,不可當作「該公司確實從事此業務」的依據
如需更精準的行業資訊:
- 可參考
tw.gov.fia.eip~ref~business-tax中的行業代號(財政部稅籍資料) - 稅籍行業代號代表「因從事該業而需依法申報稅務」,相較工商登記的自行勾選更具參考價值
- 但稅籍行業代號同樣有限制:是稅籍建立時填報的,若公司事後轉移業務方向,不一定會回頭更新稅籍行業資料
- 實務建議:兩個欄位互相參照,差異處值得進一步核實
歷史變遷有分析價值:
- 若一家公司原本沒有某個業別,某天突然新增,表示該公司很可能正在跨足這個領域(準備擴展業務的早期信號)
- 搭配
with_changelog=true取得歷次異動記錄,可以追蹤公司的業務擴展軌跡
與稅籍資料的差異
本 API(工商登記)與 tw.gov.fia.eip~ref~business-tax(稅籍登記)同樣以統編為主鍵,但來源不同:
| 本 API(工商登記) | 稅籍登記 | |
|---|---|---|
| 主管機關 | 經濟部商業發展署 | 財政部 |
| 涵蓋對象 | 依《公司法》設立的公司+依《商業登記法》設立的行號 | 所有有統編的營業人(含基金會等) |
| 特有資訊 | 董監事、股權結構、歷次變更、行號出資人 | 營業地址、行業代碼、營業稅籍 |
相關資料集
| 資料集 | 關聯說明 |
|---|---|
tw.gov.fia.eip~ref~business-tax |
同樣以統編為主鍵,含行號等非公司型態的營業人 |
tw.gov.judicial~ref~foundation |
財團法人、社團法人、政黨的法院登記資料 |
更新頻率與版本記錄
| 版本 | 更新日期 | 說明 |
|---|---|---|
| 2026-06 | 2026-06-02 | 知識文件初始建立 |
AI 使用指引
AI agent 使用指引見 skill.md。