公司更名、遷址、增資,或剛剛成立,常常就是採購與合作啟動的時機。Prometiam 替你監控客戶名單中的公司,登記資料一出現變更就通知你,也提供全台灣的登記變更事件與新成立的公司。只提供公司層級的登記資料,不含負責人與董監事。
台灣公司的登記變更事件涵蓋名稱、狀況、組織型態、登記地址與資本額。事件日期是這項變更第一次出現在登記資料中的日期,不是公報日期,而且 2026 年 10 月首次載入之前沒有事件。
| 變動 | event_type | 對業務的意義 |
|---|---|---|
| 新成立的公司 | new_incorporation | 需要記帳、銀行、保險、辦公室與各種系統 |
| 公司更名 | name_change | 改名常伴隨品牌、合約與發票的更新 |
| 遷址 | address_change | 新辦公室:裝修、網路、設備與搬遷服務 |
| 資本額增減 | capital_change | 增資代表資金到位,是追加採購與合作的時機 |
| 改制 | legal_form_change | 例如有限公司改為股份有限公司,代表公司結構在調整 |
| 解散 | dissolution | 停止賒銷、確認債權、整理客戶名單 |
重整、接管與破產同樣會以狀況變更事件出現。capital_change 追蹤的是資本總額(capital_amount,新臺幣),不是實收資本額;previous_value 與 new_value 是變更前後的值,要自己比較才知道是增資還是減資。地址事件的前後值是「地址, 3 碼郵遞區號, 區」。
先用統編查到公司的 id,再用 POST /monitor 登記,並把 CRM 的客戶編號放進 label,之後每則通知都會帶回。登記監控不會扣點數。
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
# 客戶名單中的公司:統編與 CRM 的客戶編號
accounts = [('22099131', 'crm-1001'), ('20828393', 'crm-1002')]
for ubn, crm_id in accounts:
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': 'TW', 'company_number': ubn})
r.raise_for_status()
hits = r.json()['data']
if not hits:
continue
requests.post(f'{BASE}/monitor', headers=H, json={
'company_id': hits[0]['id'],
'country': 'TW',
'label': crm_id, # 每則通知都會帶回
'events': ['corporate_event', 'status_change', 'dissolution'],
'webhook_url': 'https://example.com.tw/hooks/prometiam',
}).raise_for_status()
通知附有簽章:X-Prometiam-Signature 標頭是 sha256= 加上以 POST /monitor 回傳的 webhook_secret 對本文計算的 HMAC-SHA256。建立業務待辦之前,請先驗證簽章。所有方案皆提供 webhook,也都能用 GET /monitor 讀取通知,所以每晚排程讀取也行。可監控的公司數:免費試用 3 家、Starter 25 家、Professional 250 家、Scale 2,500 家。
不帶 company_number 與 company_name 時,GET /company-events/search 是整個國家的事件流,由新到舊,可用 event_type 篩選(country 必填)。date_from 省略時從 7 天前開始,最多回溯 31 天,更早的日期會被拒絕並回傳 400。每天或每週讀一次,留下符合你目標客群的公司,就能找到還沒有監控的潛在客戶。
# 過去 7 天內出現的資本額變動,由新到舊,每次 100 筆 curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=TW&event_type=capital_change&limit=100' \ -H 'Authorization: Bearer rk_live_...'
每次呼叫最多 100 筆、扣 2 點數,把 next_cursor 帶進 cursor 取下一頁。下面的範例只留下資本總額至少加倍的公司:
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
r = requests.get(f'{BASE}/company-events/search', headers=H,
params={'country': 'TW', 'event_type': 'capital_change', 'limit': 100})
r.raise_for_status()
for e in r.json()['data']:
before, after = float(e['previous_value']), float(e['new_value'])
if after >= before * 2: # 下一頁用 pagination.next_cursor
print(e['event_date'], e['company_number'], e['company_name'], f'{before:,.0f} -> {after:,.0f}')
台灣的公司紀錄有核准設立日期,所以 founded_after 可以不帶名稱,列出某天以後設立的公司,由新到舊。每筆有 founding_date、資本額(capital_amount,新臺幣)、組織型態、登記地址的縣市(region)、區(city)與 3 碼郵遞區號。搜尋本身不能依縣市或資本額篩選,要在每一頁(100 筆,1 點數)上自己篩。
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': 'TW', 'founded_after': '2026-10-01', 'limit': 100})
r.raise_for_status()
for c in r.json()['data']:
# 臺北市、資本額 100 萬以上;下一頁用 pagination.next_cursor
if c['region'] == '臺北市' and (c['capital_amount'] or 0) >= 1_000_000:
print(c['company_number'], c['company_name'], c['founding_date'], c['capital_amount'])
新成立的公司常常還不在財政部的稅籍資料中,這時 vat_number 與 activity_code(財政部稅務行業代碼)是空值,所以不能指望用行業篩選新公司。公司出現在名單的時間跟著登記資料的公布節奏走:founding_date 是核准設立日期,first_seen_date 是這家公司第一次出現在資料中的日期,兩者可能差幾天。
Contains data from the Ministry of Economic Affairs, Department of Commerce (GCIS open data platform) and the Ministry of Finance, Fiscal Information Agency (business tax registration data), Republic of China (Taiwan), released under the Open Government Data License v1.0 (https://data.gov.tw/license). Adapted by Prometiam, not a certified register extract.
監控不扣點數。查詢公司或取得公司紀錄 1 點,事件查詢 2 點,錯誤不扣點。Starter 每月 9.99 歐元(1,000 點數);Professional 每月 29.99 歐元(10,000 點數);Scale 每月 99.99 歐元(50,000 點數);所有方案皆提供 webhook。免費試用 14 天,含 500 點數,需要信用卡,試用期間不會扣款,之後若未取消,將改為 Starter 方案。請見價格。
試用期為 14 天,包含 500 點數。需要信用卡,試用期間不會扣款;若未取消,之後將改為 Starter 方案(每月 9.99 歐元)。