跳至主要內容
← API 文件

API Quickstart

以下為 6 個常用 endpoint 的 curl 範例(含 v1 新增的 sources/registry、company canonical view,以及多公司並排 compare)。

GET

/api/v1/company/2330

curl -X GET "https://ghostradar.tw/api/v1/company/2330"

GET

/api/v1/ranking?mode=ghost

curl -X GET "https://ghostradar.tw/api/v1/ranking?mode=ghost"

POST

/api/v1/batch

curl -X POST "https://ghostradar.tw/api/v1/batch" \
  -H "Content-Type: application/json" \
  -d '{
    "tickers": ["2330", "2303", "2454"]
  }'

GET · NEW

/api/v1/sources/registry

curl -X GET "https://ghostradar.tw/api/v1/sources/registry"

全部 SRC-* 來源清單(id / 機關 / 授權 / 更新頻率)。GR-953 shipped 2026-05-10。

GET · NEW

/api/v1/company/2330/canonical

curl -X GET "https://ghostradar.tw/api/v1/company/2330/canonical"

公司 canonical view,每段事實附 source_id(裁罰 / 碳盤查 / 碳費 / 確信 / 訊號)。GR-954 shipped 2026-05-10。

GET · NEW

/api/v1/compare?tickers=…

curl -X GET "https://ghostradar.tw/api/v1/compare?tickers=2330,2317,2412"

多公司並排比較(2-5 家),單一 HTTP 呼叫取得每家 source-traced canonical view。支援 ?fields= 篩選段落。GR-959 shipped 2026-05-10。

Quota 對照(§34)

TierRealtime APIBatch APICSV 匯出Pack 生成
Tier 05 req/min20 req/day3 CSV/day0/day
Tier 130 req/min200 req/day10 CSV/day0/day
Tier 2120 req/min2,000 req/dayunlimited10/day
Tier 3300 req/min10,000 req/dayunlimited50/day
需要更多額度?前往付費升級