HireParser

AI-powered resume parsing and job matching API

原始信息汇总

HireParser API 数据集概述

基本信息

• API名称: HireParser
• 功能描述: AI-powered resume parsing and job matching API (AI驱动的简历解析和职位匹配API)
• 详细描述: Parse resumes into structured JSON and score candidates against job descriptions using your choice of AI provider. (使用您选择的AI提供商将简历解析为结构化JSON，并根据职位描述对候选人进行评分。)

核心功能

• POST /parse: 上传PDF或DOCX简历，获取结构化的JSON数据，包括：姓名、电子邮件、电话、技能、工作经历、教育背景、认证和项目。
• POST /score: 提交简历和职位描述，获取匹配分数（0-100）、分类细分、满足/缺失的要求、候选人优势、关注点以及建议的面试问题。

认证与配置

• 必需请求头:
  • X-AI-Provider: 必须，值为 anthropic、openai 或 google。
  • X-AI-Key: 必须，所选提供商的API密钥。
  • X-AI-Model: 可选，用于覆盖默认模型。
• 默认模型:
  • anthropic: claude-opus-4-6
  • openai: o4-mini
  • google: gemini-2.5-flash
• 关键说明: 用户需自行提供AI密钥，HireParser永不存储。

端点详情

POST /parse — 简历解析器

• 请求:
  • Content-Type: multipart/form-data
  • 参数 resume: 文件（PDF或DOCX，最大10 MB）
• 响应示例: 包含 success、data（结构化简历信息）和 meta（元数据，如提供商、模型、令牌使用量、文件名等）的JSON对象。

POST /score — 简历评分器 / 职位匹配器

• 请求:
  • Content-Type: multipart/form-data
  • 参数:
    • resume: 文件（PDF或DOCX — 或使用 resume_text）
    • resume_text: 字符串（纯文本简历 — 若无文件）
    • job_description: 字符串（完整的职位描述，至少50个字符）
• 响应示例: 包含 success、data（整体分数、推荐、摘要、分数细分、要求匹配情况、优势、关注点、建议面试问题）和 meta 的JSON对象。

错误响应

• 通用格式: json { "error": true, "message": "Description of what went wrong" }

• 状态码:

  • 400: 缺少或无效参数
  • 401: 缺少或无效的 X-AI-Provider / X-AI-Key
  • 422: 无法从上传的文件中提取文本
  • 429: AI提供商密钥受到速率限制
  • 500: 内部服务器错误 — 请重试

支持的文件类型与限制

• 支持的文件类型: PDF（基于文本，非扫描图像）、DOCX / DOC
• 最大文件大小: 10 MB
• 注意事项: 扫描或仅图像的PDF将返回422错误，因为无法提取文本。对于扫描文档，请先使用OCR工具提取文本，并通过 resume_text 传递。

AI提供商密钥获取

• Anthropic: https://console.anthropic.com
• OpenAI: https://platform.openai.com
• Google: https://aistudio.google.com