September 28, 2026
HeadHunter API
用于将 HeadHunter 招聘平台集成到第三方产品的 REST API 工具集。
Commercial License
Product facts
- Type
- API, SDK & Library
- Category
- Business & Finance › HR and Recruiting
- Pricing
- Freemium
- License
- Commercial License
- Launched
- Sep 28, 2026
- Listed
- Sep 28, 2026
- Website
- github.com
Overview
HeadHunter API 是俄罗斯招聘平台 HeadHunter (hh.ru) 提供的官方接口工具集，允许开发者将平台的职位、简历、消息等能力集成到自己的产品中。 ## 核心能力 该 API 基于 REST 架构，数据格式为 JSON，并提供 OpenAPI 规范文件（openapi.yml）供生成客户端代码或查阅文档。主要覆盖以下业务场景： - **上下文与用户信息**：获取和编辑已授权用户（求职者或雇主经理）的信息，以及应用级别的信息。 - **简历管理**：支持雇主端搜索简历、创建和管理保存的简历搜索条件。 - **Webhook 通知**：雇主可以订阅、修改、查看和取消各类事件的通知推送。 - **本地化与站点选择**：支持多语言环境配置及不同地区站点的切换。 ## 授权机制 API 使用 OAuth2 进行授权。开发者需要在 dev.hh.ru 注册应用，根据请求主体的不同，分为四种授权级别： - **匿名请求**：无需授权。 - **应用授权**：以应用身份发起请求。 - **求职者授权**：以求职者身份操作个人数据，无需获取用户的登录名和密码。 - **雇主授权**：以雇主或雇主经理身份执行操作。 ## 注意事项 仓库中明确指出，以雇主经理身份处理回复/邀请消息的相关方法已经废弃，不再支持新的聊天功能，可能导致消息记录显示异常。此外，部分雇主端方法（如简历库的新模型）属于付费 API 服务，需要开通相应的付费权限才能调用。
Key features
- RESTful JSON 接口：基于 REST 架构提供 JSON 格式的数据交互接口。
- OpenAPI 规范：提供 openapi.yml 规范文件，支持通过 Redoc 查看在线文档。
- OAuth2 授权：支持应用级和用户级的 OAuth2 授权流程，无需存储用户密码。
- 多级访问控制：区分匿名、应用、求职者和雇主四种请求身份，对应不同的接口权限。
- 简历搜索与管理：允许雇主端搜索简历，并创建、更新或删除保存的简历搜索条件。
- Webhook 订阅：支持雇主订阅、修改和取消系统事件的 Webhook 通知。
- 用户信息管理：可获取和编辑当前已授权的求职者或雇主经理信息。
- 多语言本地化：提供通用及简历专用的本地化字典查询接口。
- 付费 API 支持：部分高级功能（如新简历库模型）需通过付费服务接口调用。
Releases
Notify me
Initial · HeadHunter APIQ&A
- 如何开始使用 HeadHunter API？AI-generated
- 首先阅读 API 的总体信息和常见问题，然后在 dev.hh.ru 注册你的应用，并根据需求配置 OAuth2 授权流程。
- API 支持哪些类型的授权？AI-generated
- 支持四种类型：匿名请求（无需授权）、应用授权、求职者用户授权和雇主用户授权。
- 可以通过 API 读取雇主的聊天消息吗？AI-generated
- 原文指出，以雇主经理身份处理回复或邀请消息的方法已经废弃，不支持新的聊天功能，相关消息可能无法正确显示。
- 在哪里可以找到 API 的接口文档？AI-generated
- 可以通过 OpenAPI 规范文件（openapi.yml）或在线的 Redoc 文档页面查看所有可用接口。
Bookmark
This product has no owner yet
It was listed by the platform or its author left. If it is your work, prove your relationship to become the owner.
Claim this product