API

開發者 API

與本站同源的面板資料，以乾淨的 JSON 提供。以 Bearer 金鑰驗證。

匿名呼叫可用於低限額評估。將核發的金鑰作為 Bearer token 傳入，即可取得計量存取。

curl /api/v1/overview

載入中…

端點

GET /api/v1/overview— 面板核心指標

GET /api/v1/salary?by=seniority|company|job_family|country— 依維度的薪酬中位數

GET /api/v1/facets— 即時篩選值與列數

GET /api/v1/explore?country=DE&salaried_only=true&sort=salary_desc— 篩選後的職缺列

GET /api/v1/explore?as_of=2026-08-05&…— 同一查詢，按該日期的已知狀態重現——時光旅行參數（/salary 也支援）

GET /api/v1/explore.csv?…— 同樣篩選條件的 CSV 範例匯出

GET /api/v1/insights/comp-mix?by=sector— 依產業或職能的股權與獎金提及率

GET /api/v1/events?type=salary_revised_down&days=30— 衍生變動事件——薪資修訂、關閉、重新開放，每條附來源 URL

GET /api/v1/insights/time-to-fill?by=job_family— 職缺存續時間分布（僅計未設限區間），依職能/國家/公司

GET /api/v1/insights/market-mix?by=seniority— 依職能、職級或產業的開放徵才組成

GET /api/v1/insights/benchmark-series?job_family=Engineering&country=US— 單一市場按日寫入的基準歷史

GET /api/v1/quality— 欄位完整度與匯率出處

GET /api/v1/coverage— 逐看板涵蓋清冊

GET /api/v1/hiring?days=30— 開放職缺時間序列

GET /api/v1/signals/disclosure?days=30— 薪酬揭露趨勢（全部 vs 歐盟）

GET /api/v1/signals/movers?days=30— 徵才加速 / 減速榜

GET /api/v1/company/{platform}/{token}— 逐公司訊號

對即時面板組合一個請求，並複製成 curl。

curl …

職缺列的欄位語意。未知值為 null——絕不默默插補。

欄位	類型	意義
salary_min / salary_max	number\|null	雇主明示的範圍上下限，保留原始幣別與計薪週期。
currency	ISO 4217\|null	能從職缺原文判定時為 ISO 4217 代碼；否則為 null。
period	year\|month\|hour	原文所載的計薪週期（年、月或時）。
salary_source	stated\|none	只有雇主親自寫出數字時才是 'stated'。絕不建模。
annual_usd	number\|null	範圍中點以附日期參考匯率年化為美元；幣別未知時為 null。
confidence	0–1\|null	確定性擷取器對這條明示範圍的信賴度。
has_equity / has_bonus	0\|1\|null	薪酬摘錄中是否提及股權/獎金；null = 摘錄未評估（絕不猜測）
as_of	date (param)	explore/salary 的任何查詢都接受 as_of=YYYY-MM-DD，並按當日已知狀態回答——引用一個數字，任何人都能重現它
quality_flags	string[]	這一列的已知缺口，例如 no_country、no_currency。
observed_at	ISO 8601	最後一次在來源看板上觀測到這個狀態的時間。
first_seen_at	ISO 8601	這則職缺首次進入即時面板的時間。
url	string	公開來源職缺 URL——每一列都可稽核。
fx_as_of	date	本次回應中美元換算所用的匯率快照日期。

所有錯誤都回傳結構穩定的 JSON，並帶對應的狀態碼。

{ "error": "explanation", "status": 4xx }

配額按金鑰、按 UTC 日強制執行。 429 表示當日配額已用盡。

時點正確as-of 語意，支援可重現的研究

來源可查每個職缺列都附公開職缺 URL

明示與正規化並存保留原始當地範圍

明確配額逐金鑰的確定性每日計量