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

明示与归一并存保留原始本地范围

明确配额按密钥的确定性每日计量