Curriculo ATS REST API

統合

採用データに対する完全なプログラムアクセス。ジョブを作成し、候補者のスコアを取得し、パイプラインを同期し、カスタムワークフローを構築します。Proプラン（$50/月）で利用可能です。

CurriculoATS REST APIは、採用データに対する完全なプログラムアクセスを提供し、チームがジョブを作成し、候補者スコアを取得し、パイプラインステージを管理し、HRIS、給与計算、報告ツールとのカスタム統合を構築できるようにします。APIは、JSONレスポンス、APIキー認証、リアルタイム更新のためのWebhookイベントを使用した標準的なREST規約を採用しています。Proプランで月額$50で利用可能であり、レート制限内のリクエストには追加料金はかかりません。

API 機能

ジョブおよび候補者のCRUD

プログラムを通じてジョブや候補者を作成、読み取り、更新、削除します。内部ツールから新しいジョブリストを投稿し、一括で候補者のステージを更新し、外部システムと候補者プロフィールを同期します。すべてのコアリソースに対する完全なCRUD操作。

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

すべての候補者のインパクトスコア（0-100）および次元別の内訳を取得します。パイプラインステージを照会し、候補者の進行状況を追跡し、カスタムダッシュボードおよび報告のための集計された採用メトリクスを取得します。

Webhookイベント

リアルタイムのWebhookイベントにサブスクライブします：新しい応募、候補者のスコア付け、ステージ変更、オファー送信、候補者の雇用。各Webhookは、エンドポイントに完全なイベントコンテキストを持つJSONペイロードを配信します。

一括エクスポート

候補者データ、スコア結果、およびパイプラインスナップショットを一括でエクスポートします。役職ごとのすべての候補者、役職全体のすべてのスコア、またはコンプライアンスおよび報告要件のための完全なパイプライン履歴を取得します。

使用 ケース

HRISおよび給与計算との同期

候補者がCurriculoATSで雇用されるとマークされた場合、自動的にそのプロフィールをHRIS（BambooHR、Ripplingなど）または給与計算システム（Gusto、ADP）にプッシュします。採用とオンボーディングの間の手動データ入力を排除します。

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

API経由で採用メトリクスを取得し、お好みのBIツール（Looker、Metabase、Google Sheets）でカスタムダッシュボードを構築します。採用までの時間、ソースの質、スコア分布、ファネル転換率を追跡します。

自動ジョブ投稿

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

候補者データの強化

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

技術的

認証 & レート制限

APIキー認証

設定 > APIの下でCurriculoATSダッシュボードからAPIキーを生成します。すべてのリクエストのAuthorizationヘッダーにキーを含めます。キーは、アクティブな統合を妨げることなくいつでもローテーション可能です。

レート制限

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

ドキュメンテーション

完全なAPIドキュメンテーションは、Proプラン加入者のためのCurriculoATS開発者ポータルで利用可能です。対話型APIエクスプローラ、cURL、Python、Node.js、Rubyのコード例、Webhookテストツールなどが含まれています。

コード 例

1回のAPI呼び出しで新しいジョブリストを作成します。

# 新しいジョブリストを作成する
curl -X POST https://api.curriculo.me/v1/jobs \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "シニアバックエンドエンジニア",
"department": "エンジニアリング",
"location": "リモート",
"employment_type": "フルタイム",
"description": "私たちのAPIインフラストラクチャを構築・拡張します...",
"scoring_criteria": {
"role_fit_weight": 40,
"outcomes_weight": 35,
"context_weight": 25
}
}'