CurriculoのレジュメパーサーAPIは、PDFまたはDOCXのCVを、連絡先情報、職歴(日付付き)、教育背景およびスキルなどの構造化されたJSONに変換します。これは1回のPOSTリクエストで完了し、CVあたり$0.01です。ATS、求人ボード、またはHRツールを開発中の方には、パーシング機能は他の機能を構築するための基盤としてしばしば必要となります。ここでは、開発者コンソールから取得した1つのAPIキーを使用し、ATSログインは不要です。
クイックファクト
- PDFおよびDOCX
- 1回のリクエストにつき10件
- 0.01はCVに対して20ドル
- 5ドルの無料クレジット
- 同期パーサーはステートレスである
リクエスト
curl -X POST https://api.curriculo.me/public/parse/ \
-H 'Authorization: Bearer key_abc123_yoursecret' \
-F 'files=@/path/to/candidate.pdf'応答
{
"name": "Jordan Rivera",
"title": "Lead Software Engineer",
"email": "[email protected]",
"experience": [ ... ],
"technical_skills": [ ... ]
}あなたのAPIキーを するか、または の完全なAPI参照をお読みください.
レジュメパーサーのAPIはどのような結果を返しますか?
各CVにつき1件のJSONレコード。候補者の氏名、連絡先情報、職位、日付付きの役割、学歴、スキルを含む。欠落したフィールドは空で返され、リストフィールドは常に配列です。
{
"name": "Jordan Rivera",
"title": "Lead Software Engineer",
"email": "[email protected]",
"experience": [ ... ],
"technical_skills": [ ... ]
}値はCVの独自の言語と文字体系のまま保持され、翻訳や書き換えは一切行われません。フィールドの詳細は、 の完全なAPI参照にあります。.
APIで履歴書を解析する方法
開発者コンソールからAPIキーと、multipart POSTを/parse/エンドポイントに送信する必要があります。ここで、CVはfilesフィールドに含まれている必要があります。
console.curriculo.meにサインインしてください。一回限りの$5.00クレジットがアカウントに追加されます。
APIのキーを開き、「APIキーを作成」を選択します。キーは「
key_<id>_<secret>」のように見え、一度だけ表示されるので、ページを離れる前に保存してください。リクエストを送信する:
curl -X POST https://api.curriculo.me/public/parse/ \ -H 'Authorization: Bearer key_abc123_yoursecret' \ -F 'files=@/path/to/candidate.pdf'
コードを書く前に、コンソールのドキュメントページにある実際の履歴書で同期パーサーを実行することもできます。次へ: Quickstart と 完全な API リファレンス.
CVをバッチ処理で解析できますか?
はい。1リクエストで最大10件のドキュメントを送信でき、結果は入力順の配列として返されます。バックログでは、POST /parse/async はタスクごとに最大25のリンクを使用します。
curl -X POST https://api.curriculo.me/public/parse/ \
-H 'Authorization: Bearer key_abc123_yoursecret' \
-F 'files=@candidate_a.pdf' \
-F 'files=@candidate_b.docx'失敗したドキュメントは独自のエラーを返し、他の処理には影響を与えません。各ファイルは最大10 MB、リクエストボディは最大12 MBまで可能です。413は、10 MBを超える文書、10文書以上、または12 MBを超える本体を意味します。
大容量バッチのタイミングは、以下のレート制限セクションに記載されています。両方のオプションは、 バッチ処理で文書化されています。.
レート制限はどのようになっていますか?
1分あたりAPIキーで600リクエスト。各解析には約40〜90秒かかり、持続的な処理能力は1分あたり約2〜4件のCVです。
クライアントのタイムアウトを5分以上に設定してください。300秒以上経過したリクエストは504エラーを返します。バックログを /parse/async を通じて送信する。 レート制限を参照.
レジュメパーサーAPIの価格はどのくらいですか?
CVあたり$0.01。10件のCVの価格は$0.10であり、解析に失敗したCVに対しては課金されません。プリペイド残高から支払いを行い、サブスクリプション、月額の最低利用額、または設定料金はありません。
月額ツールの費用が独自の採用スタックを構築しようとする理由の一部である場合、このコストは解析時にのみ変動します。カードでStripeを通じてチャージを追加でき、オプションで自動チャージも可能です。Developer Console APIは、CurriculoのStarterプランおよびProプランとは別に請求され、それらのプランは必要ありません。請求の詳細は の料金と請求ページをご覧ください。.
APIの無料履歴書パーサーはありますか?
無料で始められます。すべてのアカウントには、購読なしで1回限りの$5.00クレジットが付与され、これにより各$0.01で500件の履歴書解析が可能です。パーサーは永遠に無料ではありません。その後、解析はプリペイド残高から同じレートで引き落とされます。
500件のCVがあれば、ファイルをパサーに通し、チャージを追加する前にデータモデルに対してJSONを確認するのに十分な余裕があります。
CVのデータはどうなるのですか?
エンドポイントによります。同期パーセはステートレスであり、応答後には何も保持されません。/parse/asyncを通じた非同期パーセでは、タスク、結果、およびファイルが保持されます。
データ処理のドキュメントは、同期呼び出しについて1つの注意点を追加しています:モデル呼び出しが失敗した場合、短い抜粋を保持することがあります。候補者のデータがどこに送信されるかを、自社の顧客に伝える場合は、以下から始めてください。 データ処理.また、参照してください。 プライバシーポリシー、 データ処理契約、そして 利用規約.
構文解析からランキングへ
/evaluate/エンドポイントは、各CVをジョブに対してスコアリングし、$0.01 per CVで評価します。スコアをどうするかはあなた次第です。
チームメンバーが既存の作業方法で業務を継続しながら、反復的な読み込みタスクから解放されるよう、ご自身の製品内でparseおよびevaluateを実行する2つの呼び出しとして実装することをお勧めします。ドキュメントでは、/translate/も次のステップとして記載されています。ここから始めます ATS builders向けのAI APIs または エンドポイントを評価する.
レジュメパーサーAPI vs 自作のパーサー
パースがあなたの販売製品である場合、それ自体を構築してください。製品内で1つのステップを踏むということは、ファイルの多様性、日付と言語、メンテナンスという3つの問題を抱えることを意味します。
ファイルの多様性。 CVsは、異なるワードプロセッサやテンプレートから作成され、1列または2列で構成されています。テーブル、サイドバー、連絡先情報はヘッダーに収められています。新しいレイアウトが増えるたびに、抽出ツールが対応しなければならないケースが増えます。Curriculo、APIは、PDFおよびDOCXを取得し、それぞれに対して同じJSONフィールドを返します。
日付と言語。 役職は「2019年から現在まで」、「2019年3月~現在」など、または全く異なる言語や文字体系で記載することもできます。あなたのパーサーは、候補者が記述した言語に関わらず、各日付範囲を適切な役割に結びつける必要があります。APIは、CVの言語と文字で、役職とその日付を返します。
メンテナンス。 採用ソフトウェアは、空のアップロード、パスワード保護されたファイル、大きすぎる文書、完了しない実行など、厄介なケースを考慮すると、保守が面倒になる。APIでは、パーサーを維持しません。これらのケースは、文書が空、読み込み不可、またはパスワードで保護されている場合に400、サイズ制限に達した場合に413、処理が300秒を超えた場合に504としてエラー報告されます。
CurriculoのAPIで自分だけのATS体験を作りましょう
5ドルの無料クレジット。サブスクリプションなし。ATSログインなし。
よくある質問
APIの無料履歴書パーサーはありますか?
Curriculoのパーサーは永久に無料ではありませんが、すべてのアカウントには一度限りの$5.00クレジットが付与され、これにより500件のCVをそれぞれ$0.01で解析できます(サブスクリプションなし)。
CVパーサーAPIは、どのようなファイル形式を受け入れますか?
PDFおよびDOCXのみ。各リクエストで最大10のMB、最大10文書まで。リクエストボディには12のMB制限があります。可読スキャンはOCR化されることがある。空、読み取り不可、またはパスワード保護された文書は400を返します。
解析にはどのくらい時間がかかりますか?
文書1件あたり約40〜90秒。リクエストは300秒後に504エラーを返すため、クライアントのタイムアウトを5分以上に設定してください。または、バックログ処理には /parse/async をご利用ください。持続スループットは1分あたり約2〜4通です。 レート制限をご覧ください.
APIは履歴を保存しますか?
エンドポイントによります。同期パーサーはステートレスであり、応答後には何も保持されませんが、モデル呼び出しの失敗時には短い抜粋が保持される場合があります。/parse/async はタスク、結果、およびファイルを保持します。 データ処理を参照してください。.
他の言語で書かれた履歴書も解析できますか?
はい。フィールドは翻訳なしで、CVの独自の言語と文字セットで返されます。
レジュメパーサーはCVパーサーと同じですか?
はい。「履歴書」は通常 US と呼ばれ、「CV」は他のほとんどの国で使われています。APIは両方を受け入れます。背景については、 履歴書解析を参照してください。.
APIキーの入手方法
サインイン console.curriculo.me、APIキーを開き、「APIキーを作成」を選択します。キーは1回だけ表示されるので、安全に保管してください。