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