候補者を評価する

POSThttps://api.curriculo.me/public/evaluate/

On this page

リクエスト
例
レスポンス
タイミング
エラー

ステートレス。 は、求人に対してCVを評価し、各CVごとに、適性スコアと書面の理由、適合スキル、ギャップ、要約ポイントを返します。各CVは、同じ求人に対して個別に評価されます。

価格： $0.01毎のリクエスト、1つのCVまたは10個のリクエストにかかわらず。

リクエスト

multipart/form-data

フィールド	タイプ	ノート
`resume_pdfs`	ファイル[]	1〜10のCV、PDFまたはDOCX（フィールド名とは関係なく）、10個のMBずつ。各CVは、同じ求人に対して評価されます。
`resume_pdf`	ファイル	シングルドキュメントエイリアス。PDFまたはDOCXです。
`job_details`	文字列	職務をプレーンテキストとしてキャリアページから貼り付け、または構造化された要件を持つ場合、JSONオブジェクトです。
`job_file`	ファイル	職務説明をPDFまたはDOCXとしています。
`job_id`	文字列	以前に `POST /jobs/`を通じて登録されたジョブを代わりに送信します。説明をバックログ全体に繰り返すのではなく、送信されます。
`language`	文字列	候補者向けの文章のISO639-1コード。空の場合、英語になります。

[！NOTE] 職務を正確に1つの方法で提供します： job_details、job_file 、または job_id。説明をインラインで送信することは常に機能します。ジョブを最初に登録することは最適化であり、必須のステップではありません。

例

インライン求人説明:

curl -X POST https://api.curriculo.me/public/evaluate/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -F '[email protected]' \
  -F 'job_details=Senior backend engineer, Python and FastAPI, Seoul'

登録された求人に対する履歴書の一覧:

curl -X POST https://api.curriculo.me/public/evaluate/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -F 'resume_pdfs=@candidate_a.pdf' \
  -F 'resume_pdfs=@candidate_b.pdf' \
  -F 'job_id=job_abc123'

レスポンス

1つのCVがCVの評価オブジェクトを返します。複数の履歴書が results 配列を返します。1つのCVごとに1つのエントリが入力順序で含まれます。バッチ処理についてはこちらを参照してください.

タイミング

評価ごとに30〜60秒かかります。クライアントのタイムアウトを5分以上に設定してください。バックログの場合、 POST /evaluate/async を使用し、タスクごとに最大25のリンクを使用できます。

エラー

ステータス	典型的な原因
`400`	読み取り不可または不正なCV `job_details`.
`404`	未知の `job_id`、または別のアカウントによって登録されたもの。求人を再登録してください。
`413`	10を超えるCV、10を超える履歴書、または12MBを超えるリクエストボディ
`422`	必須項目が不足または名前が間違っています.
`504`	処理時間が300秒を超えました。リクエストごとに送信するCVの数を減らしてください.

Updated 12 October 2026