Curriculo ATS REST API

統合

採用データへのフルプログラムアクセス。求人を作成し、候補者スコアを取得、パイプラインを同期、カスタムワークフローを構築。Proプラン（月額$50）で利用可能。

Curriculo ATS REST API は、採用データへのフルプログラムアクセスを提供し、チームが求人を作成、候補者スコアを取得、パイプラインステージを管理、HRIS、給与、レポートツールとのカスタム統合を構築できるようにします。API は、REST の標準規約に従い、JSON のレスポンス、API キー認証、リアルタイム更新のためのWebhookイベントを使用します。Proプラン（月額$50）で利用可能で、レートリミット内のリクエストごとの料金は発生しません。

API 機能

CRUD 求人および候補者向け

求人と候補者をプログラム的に作成、取得、更新、削除。内部ツールから新規求人を掲載、候補者ステージを一括更新、外部システムと候補者プロファイルを同期。すべてのコアリソースに対するフルCRUD 操作。

スコアおよびパイプラインデータ

各候補者のインパクトスコア（0〜100）と次元別内訳を取得。パイプラインステージを照会し、候補者の進捗を追跡、カスタムダッシュボードとレポート用に集計された採用指標を取得。

Webhook イベント

リアルタイムのWebhookイベントを購読：新規応募受信、候補者スコア付与、ステージ変更、オファー送信、候補者採用。各WebhookはJSON ペイロードを送信し、イベントの全コンテキストをエンドポイントに提供します。

一括エクスポート

候補者データ、スコアリング結果、パイプラインスナップショットを一括でエクスポートします。役割のすべての候補者、役割を横断したすべてのスコア、またはコンプライアンスとレポート要件のためのパイプライン履歴を取得します。

ケースを使用

HRIS と給与体系と同期

候補者が Curriculo ATS で採用としてマークされると、自動的にプロファイルを HRIS (BambooHR、Rippling など) または給与体系 (Gusto、ADP) にプッシュします。採用とオンボーディングの間での手動データ入力を排除します。

カスタム分析ダッシュボード

API を介して採用メトリクスを取得し、BI ツールの選択 (Looker、Metabase、または Google Sheets) でカスタムダッシュボードを構築します。採用までの時間、ソースの品質、スコアの分布、ファネル転換率を追跡します。

自動ジョブポスティング

内部ツールまたはキャリアサイト CMS から Curriculo ATS でプログラム的にジョブリストを作成します。チームが新しい役割を開くと、API はジョブを作成し、スコアリング基準を設定し、パイプラインを自動的に有効にします。

候補者データの強化

新しい候補者が応募したときに強化ワークフローをトリガーするために Webhook を使用します。Clearbit、LinkedIn、または独自のデータベースから追加データを取得し、強化されたプロファイルを Curriculo ATS にAPI経由で書き戻します。

テクニカル

認証 & レート制限

API キー認証

Curriculo ATS ダッシュボードの設定 > API から API キーを生成します。すべてのリクエストの認証ヘッダーにキーを含めます。キーは、有効な統合を妨げることなく、いつでも回転できます。

レート制限

標準のレート制限は、API キーごとに 1 分あたり 100 リクエストです。API は、制限を超えた場合に 429 ステータスコードを返し、再試行するタイミングを示す Retry-After ヘッダーを含みます。エンタープライズプランでは、より高い制限が利用可能です。

ドキュメント

完全な API ドキュメントは、Pro プランのサブスクライバー向けの Curriculo ATS デベロッパーポータルで利用可能です。インタラクティブな API エクスプローラー、cURL、Python、Node.js、Ruby のコード例、および Webhook テストツールが含まれます。

コード 例

1 つの API 呼び出しで新しい求人を作成します。

# Create a new job listing
curl -X POSThttps://api.curriculo.me/v1/jobs \
-H"Authorization: Bearer YOUR_API_KEY" \
-H"Content-Type: application/json" \
-d'{
"title": "Senior Backend Engineer",
"department": "Engineering",
"location": "Remote",
"employment_type": "full_time",
"description": "Build and scale our API infrastructure...",
"scoring_criteria": {
"role_fit_weight": 40,
"outcomes_weight": 35,
"context_weight": 25
}
}'