ResumeJSON — Resume & CV Parser API

A resume parser API: resume or CV in, typed JSON out, not OCR text. Send a PDF, a DOCX, plain text, or a photo or scan of the page, and get back name, contact details, every role with normalised dates, education, skills, certifications and languages.

原始信息汇总

ResumeJSON — Resume & CV Parser API 数据集详情总结

数据集概述

ResumeJSON是一款专业的简历解析API，能够将简历或CV（支持PDF、DOCX、纯文本、图片或扫描件）转换为结构化的JSON数据。与传统的OCR文本提取不同，该API直接输出申请追踪系统（ATS）所需的实际字段，如姓名、联系方式、工作经历（含标准化日期）、教育背景、技能、认证和语言等。

核心功能

• 字段级解析：输出结构化字段（如company、title、start_date），而非简单OCR文本。
• 标准化日期：start_date始终为YYYY-MM或YYYY格式，无结束日期的职位标记为is_current: true，避免缺失日期歧义。
• 不虚构数据：简历未提及的字段返回null，不猜测职位、技能或国家，确保数据真实性。
• 多语言支持：保留原文语言，仅标准化日期格式（如印尼语简历输出印尼语职位名称）。

使用方式

• 三种提交方式：
  1. JSON文本（application/json，含text字段）
  2. 文件上传（multipart/form-data，file部分）
  3. 原始字节流（直接作为请求体）
• 文件识别：通过文件内容字节自动检测PDF/DOCX类型，不依赖Content-Type头。
• 扫描件处理：无文本层的扫描件或照片，API会自动以图像识别方式读取，无需预先OCR。

性能与限制

项目	参数
解析耗时	文本解析中位数约2.2秒；扫描件解析需数秒（几秒而非两秒）
上传大小限制	20 MB，超过返回413 too_large
提取文本限制	60,000字符，超过返回413 too_large
处理预算	单次25秒处理时间，含2次重试，超时返回503 upstream_unavailable

响应结构

响应包含两个主要键：

• resume：解析后的结构化数据，包含basics、work、education、skills、certifications、languages及total_years_experience等字段。
• meta：解析元信息，如数据来源（source）、读取方式（read，text或vision）、解析字符数（characters）和耗时（durationMs）。

所有字段类型、空值语义及日期规则详见官方字段参考文档（resumejson.tiraisoft.com/reference）。

错误处理

HTTP状态码	错误代码	含义	是否可重试
400	empty_input	无输入内容	否
413	too_large	超过大小限制	否
415	unsupported_type	不支持的文件类型	否
422	unreadable_file	文件无法打开（加密、损坏等）	否
422	not_a_resume	文档非简历内容	否
502	upstream_invalid	解析结果不可用	建议重试1次
503	upstream_unavailable	服务暂时不可用	是，按Retry-After重试

已知限制与注意事项

• 不支持手写简历（打印体为设计目标，手写未保证解析准确性）。
• 图片上传时，单张图片仅代表一页；多页扫描件需合并为PDF提交。
• 图片解析速度与大小正相关，建议长边控制在约2000像素以获得最佳性能表现。
• 超过20 MB的文件返回413错误，并指明大小与限制值。

定价方案

方案	月费
BASIC	$0.00
PRO	$29.00
ULTRA	$99.00
MEGA	$299.00

免费试用

提供免费的浏览器端简历解析工具（resumejson.tiraisoft.com/tools/resume-parser），无需注册和API密钥，即可测试解析效果，所有文档处理在Cloudflare Worker中完成，不存储任何数据。