Curriculo的简历解析器API将PDF或DOCX格式的CV转换为结构化数据(包括联系方式、职位头衔、带日期的角色、教育背景和技能),只需一次POST请求,价格为每CV$0.01。如果您正在构建招聘网站、职位发布平台或招聘工具,解析功能通常是其他功能所需的基础。此处仅需从开发者控制台获取一个API密钥,无需ATS登录即可使用。
快速事实
- PDF 和 DOCX
- 每次请求10条
- 每CV$0.01
- 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 对应一条 JSON 记录,包含候选人姓名、联系方式、职位、任职日期、教育背景和技能。缺失字段返回为空,列表字段始终为数组。
{
"name": "Jordan Rivera",
"title": "Lead Software Engineer",
"email": "[email protected]",
"experience": [ ... ],
"technical_skills": [ ... ]
}这些值保留在 CV 的原始语言和脚本中,没有任何翻译或改写。字段详情在 完整 API 引用中.
如何使用 API 解析简历?
你需要从开发者控制台获取一个 API 密钥,并将一个多部分 POST 发送到 /parse/,其中 CV 在 files 字段中。
登录至 控制台。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'
在编写代码之前,您还可以在控制台的文档页面上对真实简历进行同步解析。下一步: 快速入门 以及 完整API参考.
您可以批量解析简历吗?
是的。一次最多发送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的物体。
大批量数据的处理时间详见下方的速率限制部分。这两种选项均在 批处理中有所记录。.
速率限制是什么?
每个API密钥每分钟处理600次请求。每次解析耗时约40至90秒,持续吞吐量约为每分钟2至4份简历。
将客户端超时时间设置为超过五分钟,因为请求超过300秒后会返回504错误。通过 /parse/async 发送积压任务。查看 速率限制.
API简历解析器的价格是多少?
每单位CV的价格为5美元0.01。十份简历花费 $0.10,未通过的简历不收费。您使用预存余额进行支付,无需订阅、每月最低消费或开户费。
如果每月工具费用是你考虑自建招聘技术栈的原因之一,那么这项成本只有在解析时才会发生变化。您通过 Stripe 使用银行卡充值,并可选择开启自动充值。API 开发控制台与 Curriculo 的入门版和专业版套餐分开计费,您无需购买其中任何一项。账单详情在 定价和计费.
是否有免费的简历解析工具 API?
免费开始。每个账户可获得一次性的 $5.00 信用额度,足以以每张 $0.01 的价格解析 500 份简历,无需订阅。解析器并非永远免费。此后,解析将按相同费率从您的预付款余额中扣除。
500份简历,让您在充值前有机会通过解析器运行自己的文件,并将JSON与您的数据模型进行对比检查。
CV数据会发生什么变化?
这取决于端点。同步解析是无状态的,响应后不会保留任何内容。通过 /parse/async 进行异步解析会保留任务、结果和文件。
数据处理文档对同步调用补充了一项说明:当模型调用失败时,可保留简短摘录。如需告知客户候选人的数据去向,请从 数据处理开始。另请参阅 隐私政策、 数据处理协议以及 服务条款.
从解析到排序
/evaluate/端点根据职位对每个CV进行评分,费用为每CV$0.01。您可自行决定评分结果的处理方式。
如果你希望从团队的工作中移除重复性阅读任务,同时让他们继续以现有的方式工作,可以在你自己的产品中解析并评估运行作为两个调用。文档还将 /translate/ 列为下一步。开始 AI 为 ATS 构建器提供的 API 或者 评估端点.
API简历解析器与自行开发解析器的对比
如果解析是你的产品,那就自己构建吧。如果你的产品只需一步,那么“构建”意味着拥有三个问题:文件多样性、日期和语言,以及维护。
文件多样性。 简历来自不同的文字处理程序和模板,以一列或两列的形式呈现,表格、侧栏和联系信息被巧妙地嵌入页眉中。每个新布局都是提取器需要处理的一个案例。Curriculo API 对 PDF 和 DOCX 进行操作,并为每个操作返回相同的 JSON 字段。
日期和语言。 一个角色可以写成“2019年至今”、“03/2019至今”,或者用其他语言和文字表示。您的解析器必须将每个日期范围与候选人用任何语言编写的相应角色关联起来。API 返回其角色及其日期,使用 CV 自身的语言和书写系统。
维护。 招聘软件在统计各种复杂情况时会变得难以维护:空上传、受密码保护的文件、超大文档以及超时未完成的处理。通过 API,您无需自行维护解析器。这些情况会作为记录在案的错误返回:400 表示文档为空、无法读取或受密码保护,413 表示超出大小限制,504 表示处理时间超过 300 秒。
在 Curriculo 的 API 上构建你自己的 ATS 体验
5美元免费信用额度。无需订阅。无 ATS 登录。
常见问题
是否有免费的简历解析工具 API?
Curriculo 的解析服务并非永久免费,但每个账户都会获得一次性的 $5.00 信用额度,足以以每张 $0.01 的价格解析 500 份简历,且无需订阅。
CV解析器API接受哪些文件格式?
仅限 PDF 和 DOCX,每个请求最多可包含 10 个 MB,且每个请求最多 10 份文件,请求体中 MB 的数量上限为 12。可读扫描可能已被 OCR 化。空文件、无法读取或受密码保护的文件将返回 400。
解析需要多长时间?
每份文档约 40 至 90 秒。请将客户端超时时间设置为五分钟以上,因为请求在 300 秒后会返回 504 错误,或者使用 /parse/async 接口处理积压任务。持续吞吐量约为每分钟 2 至 4 份简历。请参阅 速率限制.
API 存储简历吗?
视端点而定。同步解析为无状态操作,响应完成后不保留任何数据,除非模型调用失败,否则可能会保留简短摘录。/parse/async 会保留任务、结果和文件。请参阅 数据处理.
它能解析其他语言的简历吗?
是的。字段以 CV 自身的语言和脚本返回,未经翻译。
简历解析器与CV解析器是相同的吗?
是。"Resume"是通常使用的US术语,而"CV"在大多数其他国家中使用。API两者均接受。背景信息请参阅 简历解析.
如何获取 API 密钥?
登录 控制台.curriculo.me,打开API密钥并选择创建API密钥。该密钥仅显示一次,请妥善保存。