Curriculo ATS 文档
Curriculo ATS 读取原始招聘材料并返回结构化、可决策的数据。发送简历、职位要求或面试录音，您将得到干净的字段、适配分数、翻译或招聘摘要。六种功能，一把API密钥。
创建一个帐户，生成一个密钥，并在编写代码之前通过浏览器运行每个功能。
请求参考六个功能中每个功能所需的确切输入和可选输入。
限制与性能文件大小、处理时间、吞吐量和速率限制，在生产中测量。
Curriculo ATS MCP ↗一个单独的产品：通过 OAuth 从 Claude、ChatGPT 或 Cursor 运行您的 ATS。
概述 #
API 的功能及其局限性。
Curriculo ATS API 暴露了 Curriculo ATS 产品已运行的相同引擎。您可以使用开发者控制台中的 Bearer 密钥直接调用它们。没有 ATS 登录，没有会话 cookie，也没有组织头。
在您集成之前，每个功能都可以从交互式文档中运行：选择一个操作，粘贴您的密钥，附加一个真实的简历，并阅读响应。您可以先使用自己的数据判断输出质量，而无需任何集成工作。
默认以列表方式返回。 每个可以是列表的输入都是一个列表。发送一项或一百项：响应以列表形式返回，顺序与发送的一致，每项一个结果。单个项目失败不会导致其余批次崩溃。
API 不是第二个 ATS
POST /jobs/ 在此 API 上仅将职位作为要求字符串存储，因此您可以根据它评估一系列简历。它不是 Curriculo ATS 工作 API：没有公开的职业板，没有分页，也没有组织工作列表。控制台 ATS API 保持自己的分页；公共 API 则在单个请求中接受列表。
快速入门 #
从注册到工作调用，无需销售对话。
创建您的帐户
在 console.curriculo.me 注册。注册为自助服务，无需销售电话即可开始。
生成 API 密钥
在 API 密钥 页面。密钥仅显示一次，因此请将其保存在安全的地方。如果它丢失或暴露，请撤销并发放一个新的。现有密钥在您撤销之前继续有效。
在编写代码之前尝试每个功能
打开交互式文档，访问 api.curriculo.me/public/docs，点击 授权，粘贴您的头信息，并在任何操作上使用 尝试，包括文件上传。控制台还为每个功能显示一个可复制的请求。
Authorization: Bearer key_...将密钥交给您的工程团队
他们需要密钥、他们已经看到的控制台模板以及控制台文档页面中的 Postman 集合。每个功能都是单个请求，因此集成保持小而自包含。
评估不花费任何费用。 注册、密钥创建和您的第一次调用由 $5.00 的免费积分覆盖。开始时不需要支付方式，因此您可以在进行任何商业讨论之前，根据您自己的简历判断输出质量。
身份验证 #
一个密钥，所有功能。
每个请求都以 Bearer 令牌形式传递您的开发者控制台密钥。控制台密钥立即激活所有六个功能。没有入职电话，也没有按功能请求。解析、评估、翻译、检测语言、面试摘要和简历助手都在同一个帐户和同一个余额上。
Authorization: Bearer key_...密钥管理。 密钥在创建时只显示一次。针对每个环境或团队生成单独的密钥，以确保它们可以独立撤销，切勿将密钥提交到源代码控制中或粘贴到不受信任的客户端，并在泄露后立即撤销。密钥的作用范围限于您的组织，并且看不到其他内容。
功能 #
六个操作。您发送什么，以及返回什么。
解析简历
一次性一个简历或一系列简历，以PDF或Word格式，单次调用。一个文件算作一次收费。
完整的简历作为干净、结构化的数据：姓名、联系信息、工作经历、教育背景、技能。值保持在简历本身的语言和文字中。没有任何翻译或重写。
评估候选人
一次性一次性注册工作内容，作为招聘页面文本、JSON字符串或工作PDF/DOCX。然后针对该工作发送一个简历或一系列简历PDF。
每个简历：适合度评分、书面理由、匹配的技能和差距。与Curriculo ATS应用程序向招聘人员展示的评估相同。请求中的一个简历算作一次收费。
翻译
一次性一系列文本（最多200个）或一个PDF/DOCX上传。始终是列表，因此一个项目就是一个项的列表。
一次性翻译所有文本，按照您发送的顺序。如果一个项目失败，其余的仍然会返回。批处理永远不会崩溃。
检测语言
一次性一个文本或一系列文本，单次调用。
文本书写的语言，这让您在行动之前能够对简历或消息进行路由。
面试总结
一次性视频（mp4，mov，mkv）或音频（mp3，m4a，wav），或您已经拥有的记录。一次面试或一系列面试。
如果您发送了媒体：转录，然后是AI分析，涵盖亮点、红旗、技能和建议。与Curriculo ATS前端使用的相同面试评分器。仅转录请求跳过转录。
简历助手
会话发送一次简历，然后发送清晰的语言指令。
关于该简历的工作会话：询问问题、编辑部分，或生成翻译版本，所有这些不需要每次都重新上传文件。
前五个功能是一次性的：您发送的内容不会被存储，并且没有信息从一个请求传递到下一个请求。简历助手是唯一保留工作副本的，因此它可以在会话中处理相同的简历。
请求参考 #
每个功能是一个请求，并具有一组简短的、固定的输入。
所需输入是有效请求的最低要求；可选输入仅用于细化结果。对于简历工作，首先注册一次工作及其要求、语言和设置。然后针对该工作参考发送文档列表，而不是在每个简历中重复要求。
解析简历
| 输入 | 必需 | 备注 |
|---|---|---|
files | 必需 | 一个或多个CV格式为PDF或DOCX，每个最大10 MB。附上单个文件或列表；结果以相同顺序返回。 |
评估候选人
| 输入 | 必需 | 备注 |
|---|---|---|
job_id | 其中之一 | 来自POST /jobs/，是评估助手而不是Curriculo ATS职位API（无板、分页或组织工作）。一次性注册要求，然后针对该ID发送简历列表。 |
resume_pdfresume_pdfs | 必需 | 一个CV通过resume_pdf，或多个通过resume_pdfs。PDF，每个最大10 MB。一个请求中的一个文件算作一次收费。 |
job_details | 其中之一 | 一个字符串：粘贴招聘页面文本，或者如果您已经拥有结构化要求则使用JSON字符串。不是ATS职位对象。使用此项，或job_id，或job_file（PDF/DOCX）。 |
language | 可选 | 用于书面分析的语言。省略，则分析返回英文。 |
| 输入 | 必需 | 备注 |
|---|---|---|
texts | 必需 | 待翻译的项目，最多200项和50,000个字符每次请求。保留顺序。 |
target_language | 必需 | 要翻译成的语言。 |
source_language | 可选 | 输入的语言。如果未提供，默认为英语。 |
检测语言
| 输入 | 必需 | 备注 |
|---|---|---|
text | 必需 | 要检查的文本，最多50,000个字符。 |
default_language | 可选 | 当文本太短或太混合而无法识别时返回的内容。默认为英语。 |
面试摘要
| 输入 | 必需 | 备注 |
|---|---|---|
interview_id | 必需 | 您自己的面试参考；它会被回显，以便您可以将结果与您的记录匹配。 |
media | 其中之一 | 视频或音频（mp4, mov, mkv, mp3, m4a, wav）。我们进行转录，然后运行相同的AI分析。使用此项或transcript_text。 |
transcript_text | 其中之一 | 如果您已经持有转录，最多200,000个字符时，请使用此项，而不是media。两者必须选择其一。 |
transcript_entries | 可选 | 将相同的转录分割为说话者轮次。提供此项，您还可以获得发言时间分析。 |
language | 可选 | 摘要使用的语言。默认为英语。 |
简历助手
| 输入 | 必需 | 备注 |
|---|---|---|
prompt_text | 必需 | 您用任何语言写的指令或问题。 |
file | 首次调用时必需 | 首次附加CV以打开会话。后续调用无需文件。 |
language | 可选 | 设置为将简历呈现为该语言。这种方式比在指令中请求翻译更为有效。 |
交互式文档清楚列出了每项功能所需的输入，因此所需的项目在任何人编写代码之前都是可见且可测试的。
语言 #
招聘很少是单语的，因此每个功能都嵌入了语言处理，而不是作为附加功能出售。
- 以任何语言发送简历。解析和评估按书写的文件读取，无论是阿拉伯语、韩语、日语、印地语、法语、葡萄牙语还是俄语，您无需预处理。
- 没有内容被默默重写。解析后的值以简历本身的语言和脚本返回，因此，名称或雇主永远不会被音译成候选人无法识别的内容。
- 翻译覆盖200+ 种语言，使用我们自己的专用引擎，涵盖欧洲、中东、南亚、东亚和东南亚以及非洲语言。对于不在该集合中的语言，我们的AI模型将处理请求，而不是拒绝它。
- 您可以选择输出语言。评估、面试摘要和简历助手各自接受语言设置，因此阿拉伯语简历可以用英语评估，或者英语简历可以用韩语呈现。
- 语言检测可以让您在任何人阅读文件之前分支工作流程，因此您可以先分配合适的招聘者或选择正确的模板。
限制与性能 #
以实际生产环境为依据，而非预测。根据这些计划，上线时不会有惊喜。
| 内容 | 值 | 为什么重要 |
|---|---|---|
| 文档大小 | 最多10 MB | 实际上覆盖几乎所有真实的简历，包括扫描和设计繁重的简历。 |
| 简历处理时间 | 40-90秒 | 真实的AI分析，而非关键词匹配。将其视为后台作业，而不是页面加载。 |
| 持续吞吐量 | 每分钟2-4份简历 | 每小时大约150-250份简历，非人工干预。此容量在服务之间共享，因此应对此进行计划，而不是假设它保留给您。 |
| 处理中文档数量 | 同时处理3份 | 发送超过三份时，多余的会等待其轮到，而不是失败，最多到达以下请求速率限制。在正常高峰期间不会丢失任何内容。 |
| 每个密钥的请求速率 | 每分钟600次 | 远高于文档工作负载所需；超出时将返回速率限制响应，而不是降低每个人的服务。 |
| 一次调用的翻译量 | 200项/50,000个字符 | 可以在一次请求中翻译整个职业页面或简历。 |
| 面试转录 | 200,000个字符 | 舒适地容纳一个较长的面板面试，逐字记录。 |
大存积压力。 一次注册职位，然后按列表提交您的文件。您在完成后收集结果，而不是每份简历保持一个连接开放。如果您预计批量中有数千份文件，告诉我们工作负荷的形状，我们会在您构建之前确认计划。
错误与可靠性 #
操作中可以期待什么。
- 每个请求都是独立的。一份文件失败不会影响其他文件，重新发送单个失败的文件总是安全的，因为它不会创建重复或半完成的记录。
- 拒绝的请求会告诉您原因：文件太大、格式错误、缺少关键内容或处理时间过长。没有任何失败是沉默的。
- 批次优雅降级。在任何列表请求中，单个项目失败会返回该项目的错误，而其余结果正常返回，顺序与您发送的顺序一致。
- 速率限制的行为也是一样。超过每分钟600个请求的密钥返回速率限制响应，而不是降级所有人的服务。
账单与使用 #
自助服务今天在控制台中上线；合作伙伴条款已签约。
自助服务：免费额度，然后按需付费
| 项目 | 金额 | 工作机制 |
|---|---|---|
| 一次性免费额度 | $5.00 | 在注册时授予，在任何收费之前使用。控制台显示剩余金额和已使用金额。 |
| 使用费率 | 按呼叫计量 | 每次调用根据实际消耗进行计量，精确到百万分之一美元。简短说明的费用只有几分钱；长文档的费用相对更高。 |
| 充值 | 自动 | 您持有信用余额。当余额低于您选择的阈值时，您的卡会被收取以补充余额，因此调用在工作负载中不会中断。 |
| 支付方式 | 卡，通过Stripe处理 | 卡片详细信息在Stripe自己的页面中输入，绝不会在Curriculo ATS屏幕上输入。 |
| 无订阅 | 按需付费 | 没有每月计划和没有账单周期可承诺。您为所做的呼叫付费，当您没有呼叫时则不需付费。 |
您支付的费用是呼叫消耗的费用，而不是固定的每次呼叫费用，因此便宜的操作保持便宜：翻译和语言检测使用我们的模型运行，是我们最便宜的工作。所有六个功能都通过相同的基于使用量的计费进行计量，因此单个密钥和单个余额覆盖您所调用的一切。
使用可见性
控制台显示呼叫、可收费使用、错误和该期间的预计费用，因此您可以在任何费用被收取之前进行对账。为每个环境或团队签发单独的密钥，以保持使用可归属，密钥可独立撤销。
合作伙伴和经销商定价
对于转售或承诺的数量，我们根据合同按呼叫定价。合作伙伴费率是合同，而不是自助服务，并根据参与确认。告诉我们您预期的每月呼叫量，我们将确认价格及其相关条款。
- 简历助手按使用量计费，而不是每次呼叫固定收费。说明的长度是开放式的，因此按其消耗计价，您可以设置上限。
- 所有数字均为美元，且不包括地方税。地方货币开票按参与定价。
数据处理 #
我们保留什么，我们不保留什么，以及您的密钥可以访问什么。
| 功能 | 保留 | 这意味着什么 |
|---|---|---|
| 解析简历 | 单次 | 您发送的任何内容都不被存储，没有信息从一个请求传递到下一个请求。 |
| 评估候选人 | 单次 | |
| 翻译 | 单次 | |
| 检测语言 | 单次 | |
| 面试摘要 | 单次 | |
| 简历助手 | 会话 | 保持一份简历的工作副本，以便在会话内对同一文件进行操作。这是唯一一个保留您发送的内容的功能。 |
- 您的数据仍然属于您。在简历助手会话之外，我们不会保留您发送的文件。
- 一个密钥绑定到您的组织，无法看到其他任何内容。
- 解析输出保留简历的原始语言和书写系统，因此没有名称或雇主在您未要求的情况下被音译。
- 撤销是立即的且自助服务。您可以在控制台撤销已泄露的密钥，并发放替换密钥；其他密钥不受影响。
您仍然是数据控制者。 简历和面试录音都是个人数据。在集成之前，确保您有合法的基础来处理候选人材料并将其发送给处理方。地方货币开票按参与处理。在构建之前与我们联系，如果这些适用于您。
使用条款 #
适用于每个API密钥的操作条件。
- 访问. 开发者控制台密钥在一个账户和一个余额上激活所有六个功能。密钥由您自助申请，并可随时被您撤销。
- 收费. 使用按调用计量，基于调用消耗的内容。$5.00的注册信用是优先消耗的。超出后，您存储的银行卡会被收取以维持您选择的余额阈值。没有订阅和最低承诺。
- 公平使用. 发布的吞吐量是共享的服务容量，而不是预留的容量。每个密钥限制为每分钟600个请求，超出则返回速率限制响应。
- 收费单位. 请求中的一个文件是一次收费。十份简历的列表是十次收费。
- 税费. 所有金额为美元，不包括当地税费。
- 合作伙伴条款. 转售和承诺量定价是根据每次合作签订的合同，而不是自助服务费率。
此页面记录了产品的操作方式。它不能替代Curriculo ATS服务条款、隐私政策或数据处理协议。在签署之前，请向[email protected]请求这些文件。
Curriculo ATS在Claude和ChatGPT中的使用 (MCP) #
与公共API不同的单独产品。
不同的产品，不同的身份验证. MCP通过OAuth与Curriculo ATS交流，因此用户需要登录。公共API key_ 不适用于这些工具，公共API也无法访问您的ATS。这两者是单独购买和使用的。
对于已经在Curriculo ATS上的团队，助手可以用简单的语言处理招聘流程。添加连接器大约需要1分钟：粘贴一个地址，登录，批准。它使用模型上下文协议，这是两个助手都支持的开放标准，因此您的团队不需要维护任何定制化内容。
https://mcp.curriculo.me/mcp您需要用您的Curriculo ATS账户登录并批准访问，所有操作都仅限于您的组织。
| 请求它做… | 它将会 |
|---|---|
| 审核招聘管道 | 列出空缺职位，显示每个阶段的候选人数量，并报告不同时间段之间的变化。 |
| 寻找人才 | 用简单的语言搜索您的候选人库，并返回排名匹配及其原因。 |
| 推进候选人 | 在各阶段之间移动申请者，添加备注和通过/失败决策，并为任何人展示人工智能评估。 |
| 安排日程 | 预订面试，并在连接日历的情况下，自动发送邀请和视频链接。 |
| 处理收件箱 | 阅读候选人的电子邮件线程并从您的连接邮箱发送回复或批量更新。 |
助手看到的所有内容仅限于您的组织，并且它可以读取的信息远远超过其可更改的信息。没有工具会删除您的数据。 具有外部影响的操作，例如发送电子邮件、预订面试或关闭职位，在执行之前都需经过您的确认。
MCP工具目录 #
二十五种工具。访问类型告诉您风险。
仅可阅读。可以写入更改ATS数据。WRITE+更改数据并且外部连接，因此会发送电子邮件、发出邀请或开始人工智能工作。二十五种工具中有十七种是只读的；六种WRITE+工具在使用前须经过您的确认。
| 工具 | 访问 | 功能 |
|---|---|---|
| 账户 | ||
whoami | 可读 | 确认助手作为哪个用户和组织在操作。在任何会话中，首先运行此命令是值得的。 |
| 职位 | ||
list_jobs | 可读 | 列出职位，按状态过滤，最近更新优先。 |
get_job | 可读 | 获取某个职位的详细信息，包括其招聘阶段和申请人数量。 |
create_job | 可写 | 创建一个默认阶段的职位（新职位 → 第一轮面试 → 第二轮面试 → 提供）。只需提供标题；职位将立即打开。 |
update_job_status | 可写+ | 更改职位的状态。关闭或暂停所有未被提供的候选人。 |
list_job_automations | 可读 | 列出在某个职位上配置的自动化操作：电子邮件、面试调度、标签和通知。 |
get_automation_executions | 可读 | 自动化操作的运行历史。 |
| 概览 | ||
get_dashboard | 可读 | 收件箱以及当前所有活跃职位的详细统计。 |
get_analytics | 阅读 | 总数，逐期变化，阶段分析，热门职位和来源比例。默认情况下为过去30天。 |
| 候选人 | ||
list_applicants | 阅读 | 列出申请人， 可选择一个职位，包含星标/拒绝/归档过滤器。 |
get_applicant | 阅读 | 一个申请人全部信息：当前阶段，备注和活动历史。 |
search_candidates | 阅读 | 在整个候选人池中进行自然语言搜索。返回排名匹配结果及每个结果的CV段落和推理。 |
get_applicant_evaluation | 阅读 | AI评估：适应性分数，标签，摘要和差距。 |
get_applicant_resume_text | 阅读 | 解析的CV内容，以文本和字段形式返回，无附加文件。 |
add_applicant_note | 写入 | 添加备注，可选择标记为通过或未通过的决定及其所属轮次。默认情况下为私有。 |
move_applicant_stage | 写入+ | 将某人移至另一个阶段。触发该阶段的自动化；达到Offer可能会在满足人数限制时自动关闭职位。 |
reprocess_resume | 写入+ | 对CV重新运行完整AI流程：解析、评估和索引。后台运行。 |
| 面试 | ||
list_interviews | 阅读 | 按职位、申请人、状态、类型或日期范围列出面试。 |
schedule_interview | 写入+ | 安排面试，添加面试官并创建反馈链接。连接日历时，它还会创建事件，邀请候选人并生成视频链接。无论如何，面试都会被保存。 |
| 邮件 | ||
list_inbox_emails | 阅读 | 列出入站邮件，按职位、状态或文本搜索过滤。 |
get_inbox_stats | 阅读 | 未读计数和总数。 |
get_applicant_email_thread | 阅读 | 与一个候选人的完整对话，双向记录。 |
reply_to_applicant_email | 写入+ | 从您组织的地址回复现有线程。需要连接的邮箱。 |
send_bulk_email | 写入+ | 向一个或多个候选人发送一条消息，用于外展或状态更新。需要连接的邮箱。 |
| 导入 | ||
get_import_batch | 阅读 | 候选人导入的进度：按文件状态和任何错误。 |
邮件工具需要连接的邮箱。面试安排不需要。如果没有连接的日历，依然会保存面试并报告未发送邀请。
Claude、ChatGPT和Cursor的设置，身份验证和范围，示例提示和故障排除。
Curriculo ATS MCP是什么？ ↗产品概述：通过输入来进行招聘，在您已经使用的助手中。
常见问题解答 #
我需要与销售团队联系以获取API密钥吗？
不需要。注册在console.curriculo.me上自助进行。创建帐户，在API密钥页面生成密钥，且一次性$5.00的免费额度可以支付您的评估。开始时不需要付款方式。
一个API密钥覆盖所有功能吗？
是的。控制台密钥立即启用所有六个功能，使用相同的帐户和剩余余额。没有按功能请求，也没有首次呼叫。
Curriculo ATS存储我发送到API的文档吗？
六个功能中的五个是一次性使用：您发送的内容不会被存储，且从一个请求到下一个请求没有信息传递。简历助手是唯一保留工作副本的功能，以便在一个会话中对同一CV进行操作。
MCP服务器与公共API是同一产品吗？
不是。它们是不同的产品。公共API通过开发者控制台的Bearer密钥进行身份验证。Curriculo ATS MCP服务器通过OAuth进行身份验证，需要现有的Curriculo ATS帐户，且公共API密钥不能访问其工具。请参见完整的MCP文档。
是否有订阅或每月最低费用？
没有。自助计费是按需付费，没有月度计划和账单周期。每个呼叫根据实际消耗的情况计量，当您没有调用时，您不需要支付任何费用。
处理CV需要多长时间？
40-90秒。这是真正的AI分析，而不是关键字匹配，因此将其视为后台工作，而不是阻止页面加载的东西。持续的吞吐量是每分钟2-4份简历， roughly 150-250每小时无人值守。
如果批处理中一个文档失败会发生什么？
其余的仍会返回。每个请求都是独立的，因此一个文档的失败从不影响另一个文档，重新发送单个失败的文档始终是安全的，因为它无法创建重复或未完成的记录。
我可以在集成之前评估输出质量吗？
可以，我们建议这样做。打开互动文档，点击授权，粘贴您的密钥并在任何操作上使用“试试”与真实简历。无需代码。
支持 #
接下来该去哪里。
- 互动API参考在api.curriculo.me/public/docs列出了每个操作，并允许您在浏览器中测试它。在控制台文档页面上有一个Postman集合。
- 开发者控制台在console.curriculo.me保存您的密钥、使用情况、余额和请求模板。
- MCP设置、身份验证和完整工具参考位于curriculo.me/docs/mcp/。
- 对于高容量工作负载、合作伙伴条款或法律文件，请写信至[email protected]。告诉我们工作负载的具体情况，我们将在您构建之前确认计划。