ATS ビルダー向け Curriculo API

概要 #

API の説明と概要。

Curriculo API は、Curriculo ATS 製品がすでに実行している同じ採用インテリジェンスエンジンを公開します。あなたはそれらにデベロッパーコンソールからのベアラキーで直接呼び出します。ATS ログインやセッションクッキー、組織ヘッダーは関与しません。

これをあなた自身の ATS、求人ボードまたは採用ワークフローの AI とメディアレイヤーとして使用できます。あなたの製品が候補者、職務、ステータス、リクルーター UI を所有し; Curriculo は背後での重労働を提供します。

すべての機能は、統合する前にインタラクティブドキュメントから実行できます: 操作を選択し、キーを貼り付け、実際の CV を添付して、応答を読み取ります。あなたは最初に自分のデータで出力品質を判断し、統合作業はありません。

API は第2の ATS ではありません

POST /jobs/ はこの API での職務を要件の文字列としてのみ保存しますので、それに対して CV のリストを評価できます。これは Curriculo ATS ジョブ API ではありません: ボードはなく、ページングはなく、組織のジョブリストもありません。コンソール ATS API は自分自身のページングを保持します; パブリック API は一度のリクエストでリストを受け取ります。

クイックスタート #

サインアップから稼働コールまで、営業の会話なしで。

Authorization: Bearer key_...

認証 #

1つのキー、全機能。

すべてのリクエストは、BearerトークンとしてあなたのDeveloper Consoleキーを持っています。コンソールキーは、すぐに公開APIスイートをアクティブにします。オンボーディングコールも個別の機能ごとのリクエストもありません。プロンプト、解析、評価、翻訳、言語検出、書き起こし、インタビュー要約、およびスクリーニングインタビューはすべて同じアカウントと同じ残高にあります。

機能 #

あなたが送信するもの、Curriculoが処理するもの、そして返ってくるもの。

リクエスト参照 #

すべての機能は、短い固定の入力セットを持つ1つのリクエストです。

必須の入力は、有効なリクエストに必要な最小限のものであり、オプションのものは結果を洗練するだけです。履歴書の作業においては、まず職務をその要件、言語、設定で登録します。次に、必要な条件を各履歴書と繰り返すのではなく、その職務参照に対して文書のリストを送信します。

履歴書を解析

同期呼び出しは、filesフィールドに履歴書を添付します（PDFまたはDOCX、各最大10 MB）。非同期呼び出しは、同じファイル、HTTPS file_urls（1行ごと、またはJSONリスト）、または両方を受け入れ、最大25の履歴書を処理します。オプションのcallback_urlを追加すると、準備が整ったときに結果をPOSTします。省略した場合は、タスクをポーリングしてください。

候補者を評価

同期呼び出しは、resume_pdfまたはresume_pdfsにPDFを添付します。非同期呼び出しは、同じファイル、HTTPS resume_urls（1行ごと、またはJSONリスト）、または両方を受け付け、最大25の履歴書を処理します。POST /jobs/からのjob_idまたはインラインjob_detailsを送信します。オプションのcallback_urlを追加すると、準備が整ったときに結果をPOSTします。省略した場合は、タスクをポーリングしてください。

翻訳

翻訳は、要求された言語ペアの最良のルートを使用します。直接の応答にrecommended_async: trueが含まれている場合は、そのペアの生産トラフィックに対してPOST /translate/asyncを使用してください。

言語を検出

インタビュー概要

プロンプト / 履歴書アシスタント

インタラクティブなドキュメントは、各機能に対する正確な入力をリストし、作業を開始する前に必要なセットが可視化され、テスト可能です。

スクリーニング面接

POST https://api.curriculo.me/public/screening-interviewを呼び出します。候補者のメールアドレス、質問、職務メタデータ、およびコールバックURLを送信します。Curriculoは各候補者に面接のリンクをメールで送信します。各回答が届くと、それをあなたのcallback_urlにPOSTします。失敗したアドレスは他のものをキャンセルしません。

これは組み合わせれた採用ワークフローであり、薄いメールラッパーではありません。Curriculoは招待の配信、ブラウザ録画、プライベートメディアストレージ、文字起こし、翻訳準備可能な回答テキスト、評価メタデータ、および署名付きコールバックを処理しますので、あなたのATSは候補者の証拠を直接リクルーターに示すことができます。

呼び出しは202応答を返し、screening_id、一度表示されるcallback_secret、sent_count、およびinvitesリストを返します。各招待はsentまたはfailedです。スクリーニング面接は、送信された候補者の招待ごとに$0.02です。失敗した招待には料金は発生しません。

{
  "candidate_emails": ["[email protected]"],
  "questions": ["出荷したシステムについて教えてください。"],
  "callback_url": "https://example.com/screening",
  "job_title": "バックエンドエンジニア"
}

各回答はあなたのサーバーへの1つの署名付きPOSTです。X-Curriculo-Signatureはsha256=に加えて、生の本体のHMAC-SHA256です。completedは、その候補者がすべての質問に対して最終的な回答を提供するまでfalseのままです。question_indexは0から始まります。

{
  "screening_id": "...",
  "email": "[email protected]",
  "question": "出荷したシステムについて教えてください。",
  "question_index": 0,
  "transcript": "請求サービスを出荷しました。",
  "recording_url": "https://api.curriculo.me/public/screening-interview/.../recording",
  "media_kind": "video",
  "duration_seconds": 142,
  "completed": false
}

recording_urlはプライベートなCurriculoメディアリンクであり、生のS3 URLではありません。これはあなたのATS結果ページ用であり、リクルーターは文字起こしと評価の文脈の隣で回答を見ることができます。古いリンクが期限切れの場合は、最新のメディアURLを受け取るためにスクリーニング結果を再度リクエストしてください。

言語 #

採用は単一言語で行われることは稀であり、言語の取り扱いはすべての機能に組み込まれているので、アドオンとして販売されることはありません。

• どの言語でも履歴書を送信できます。パースおよび評価は、アラビア語、韓国語、日本語、ヒンディー語、フランス語、ポルトガル語、ロシア語など、書かれた通りに文書を読み取ります。あなたの側で前処理は不要です。
• 何も静かに書き換えられません。パースされた値は履歴書の言語とスクリプトで戻されるので、名前や雇用者は候補者が認識しないものに転写されることはありません。
• 翻訳は、欧州、中東、南アジア、東アジアおよび東南アジア、アフリカ、地域の言語にわたって200以上の言語をサポートします。APIは、要求されたソースおよびターゲット言語ペアに対して最も適切なルートを選択します。
• 出力言語はあなたが選択します。評価、面接の要約、履歴書アシスタントはそれぞれ言語設定を受け付けるため、アラビア語の履歴書は英語で評価でき、英語の履歴書は韓国語で表示できます。
• 言語検出により、どの人間も文書を読む前にワークフローを分岐させることができ、適切なリクルーターを割り当てたり、最初に適切なテンプレートを選択したりできます。

制限 & パフォーマンス #

生産で測定されており、予想ではありません。これらに対して計画すると、ゴーライブ時に驚きはありません。

エラーと信頼性 #

運用上の期待事項。

• 各リクエストは独立して存在します。1つのドキュメントが失敗しても他のドキュメントに影響を与えることはなく、失敗したドキュメントを再送信するのは常に安全です。なぜなら、重複や途中までのレコードを作成することができないからです。
• 拒否されたリクエストはその理由を教えてくれます：ファイルが大きすぎる、形式が間違っている、キーが欠落している、または処理に時間がかかりすぎた。何も静かに失敗することはありません。
• バッチは優雅に劣化します。任意のリストリクエストで、1つのアイテムの失敗はそのアイテムのエラーを返し、残りの結果は通常通り、送信した順序で返されます。
• レート制限も同じように動作します。キーで1分あたり600件のリクエストを超えると、サービス全体を劣化させるのではなくレート制限の応答が返されます。

API価格 #

公開されたセルフサービス価格。インフラストラクチャの公式、乗数、または隠れたセットアップ料金はありません。

セルフサービス：無料クレジット、その後従量制

単一のキーと単一の残高がすべての呼び出しをカバーします。解析と評価にはファイルを添付するか、HTTPS履歴書リンクを貼り付けることができ、両方を送信することもできます。非同期呼び出しにはコールバックURLを含めることができ、準備ができたら結果をPOSTします。コールバックを省略した場合でもポーリングは機能します。

使用状況の可視性

コンソールには、呼び出し、請求可能な使用状況、エラー、期間ごとの推定料金が表示されるため、何かが請求される前に調整できます。環境やチームごとに異なるキーを発行して、使用状況を明確にし、キーを独立して無効にできるようにします。

パートナーおよびリセラー価格

再販またはコミットしたボリュームの場合、契約に基づいて呼び出しごとに価格を設定します。パートナー料金は契約に基づいており、セルフサービスではなく、エンゲージメントごとに確認されます。月間の期待呼び出し量を教えてください、料金とその条件を確認します。

• 履歴書アシスタントは呼び出しごとに$0.01で、PDFを添付する呼び出しも含まれます。
• すべての金額は米ドルで、現地の税金は含まれていません。現地通貨での請求はエンゲージメントごとに価格設定されます。

データ処理 #

私たちが保持するもの、保持しないもの、キーがアクセスできるもの。

• あなたのデータはあなたのものです。プロンプトセッションおよびスクリーニングインタビューの結果を除き、ワンショットAPI呼び出しは送信したドキュメントを保持しません。
• キーはあなたの組織に結びついており、他のものは見えません。
• パースされた出力は CV の言語とスクリプトを保持するため、要求しない限り名前や雇用主は音訳されません。
• 取り消しは即時で自己サービスです。コンソールで危険にさらされたキーを取り消して交換品を発行します。他のキーには影響しません。

利用規約 #

すべてのAPIキーに適用される操作条件。

• アクセス。 開発者コンソールのキーは1つのアカウントと1つの残高で公開APIスイートをアクティブにします。キーは自己サービスで発行され、いつでもあなたによって取り消すことができます。
• 請求。 各呼び出しはその操作の公表価格で請求されます。$5.00のサインアップクレジットが最初に引かれます。それを超えると、あなたの保存されたカードが選択した残高のしきい値を維持するために請求されます。サブスクリプションはなく、最低限のコミットメントもありません。
• フェアユース。 公開されたスループットは共有サービス能力であり、予約された能力ではありません。キーごとに600リクエスト/分の制限が施行されており、それを超えるとレート制限の応答が返されます。
• 請求単位。 一つのリクエストは一つの請求です。一回の呼び出しで10のCV のリストを取得しても$0.01です。
• 税金。 すべての数字はUSDであり、地方税は含まれていません。
• パートナー条件。 再販およびコミットボリュームの価格設定はエンゲージメントごとに契約されており、自己サービスの料金ではありません。

Curriculo ATS in Claude and ChatGPT (MCP) #

公開APIとは別の製品です。

すでにCurriculo ATSにいるチームにとって、アシスタントは平易な言語で採用パイプラインを運営できます。コネクタの追加は約1分かかります：アドレスを貼り付け、サインインし、承認します。これは、両方のアシスタントがサポートするオープンスタンダードであるモデルコンテキストプロトコルを使用しているため、チームの維持が必要な特別なものはありません。

Curriculo ATSアカウントでサインインし、アクセスを承認すると、すべてのアクションはあなたの組織に範囲を制限されます。

MCPツールカタログ #

25個のツール。アクセスのタイプがリスクを示します。

読み取り は、見ることだけを意味します。書き込みはATSデータを変更します。書き込み+はデータを変更かつ外部にアクセスし、メールを送信したり、招待状を送信したり、AIジョブを開始したりします。25のうち17個は読み取り専用であり、6個の書き込み+ツールは使用する前に確認されます。

メールツールには接続されたメールボックスが必要です。面接スケジューリングは必要ありません。接続されたカレンダーがなくても面接は保存され、招待が送信されなかったことが報告されます。

FAQ #

サポート #

次のステップ。

• api.curriculo.me/public/docsのインタラクティブAPIリファレンスでは、すべての操作を一覧表示し、ブラウザでテストできます。Postmanコレクションはコンソールドキュメントページにあります。
• Developer Consoleでは、キー、使用量、残高、リクエストテンプレートが管理されています。
• MCPの設定、認証、および完全なツールリファレンスはcurriculo.me/docs/mcp/にあります。
• 大量の作業負荷、高ボリュームのパートナー契約や法的文書については、[email protected]にお問い合わせください。作業負荷の形状を教えていただければ、構築の前にプランを確認します。