開發者文件

認證

Clarifindata API 只接受一種認證方式：Authorization Bearer（RFC 6750），跟 Stripe / OpenAI 相同。

Bearer Token

在每個請求的 HTTP header 中加上 Authorization: Bearer {YOUR_KEY}。

bash

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://api.clarifindata.com/v1/data/TaiwanStockPrice?stock_id=2330&limit=5"

python

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY"}
resp = requests.get(
    "https://api.clarifindata.com/v1/data/TaiwanStockPrice",
    headers=headers,
    params={"stock_id": "2330", "limit": 5},
)
print(resp.json())

ℹ

沒有 Authorization header 或 key 格式錯誤會回 401。Key 存在但 tier 不符（例如用 Free key 查 Lite 資料集）會回 403。

每個回應都會帶以下 rate-limit header，方便你追蹤配額：

Header	說明
X-RateLimit-Limit	你這個 tier 的每小時上限
X-RateLimit-Remaining	這個小時視窗剩餘次數
X-RateLimit-Window	視窗長度（秒），固定 3600
X-RateLimit-Tier	這個 key 的 tier（free/lite/plus）

Key 等級

每個 API Key 對應一個 tier，決定可以存取哪些資料集和每小時請求上限。

Tier	資料集	每小時上限	方案
free	49 個 Free 資料集	600	免費，不需信用卡
lite	80 個（Free + Lite）	3,000	NT$149/月
plus	88+ 個（含 AI 加值）	10,000	NT$299/月

使用 GET /v1/key/info 可以隨時查詢你目前 key 的 tier 和剩餘配額。

bash

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://api.clarifindata.com/v1/key/info"

json

{
  "tier": "free",
  "rate_limit_per_hour": 600,
  "remaining_this_hour": 597,
  "window_resets_in_seconds": 2341
}