API
開発者 API
本サイトを支えているのと同じパネルを、クリーンな JSON で提供します。認証は Bearer キーで行います。
認証
匿名コールは低い上限内で評価用に利用できます。発行済みキーを Bearer トークンとして渡すと、メータリングされたアクセスになります。
curl /api/v1/overview
ライブレスポンス
読み込み中…
エンドポイント
GET /api/v1/overview— パネルの主要 KPI
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 EU)
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 | 中点を日付付き参照為替レートで USD に年換算した値。通貨不明の場合は 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 | このレスポンスの USD 換算に使った為替スナップショットの日付。 |
エラー
すべてのエラーは、安定した形の JSON ボディと適切なステータスコードを返します。
{ "error": "explanation", "status": 4xx }
クォータはキーごと・UTC 日ごとに適用されます。 429 は、その日のクォータを使い切ったことを意味します。
バージョニングと廃止
- v1 エンドポイントは追加のみ:新しいフィールドが増えることはあっても、既存フィールドの意味が v1 内で変わることはありません。
- 破壊的変更は /api/v2 として提供し、両バージョンを少なくとも 90 日間並行稼働させます。
- 廃止予定は、削除前に変更履歴とレスポンスヘッダーで告知します。 変更履歴 →
ポイントインタイム再現可能なリサーチのための基準日セマンティクス
出典リンク付き全求人行に公開求人票の URL
明示 vs 正規化元の現地通貨レンジを保持
明示的なクォータキーごとの決定論的な日次メータリング