hh: поиск работы 数据 API

HeadHunter · 身份

hh 安卓端的求职链路走私有 JSON API：GET /v1/jobs/search 分页返回职位列表（标题、salary_range、地区、雇主、工作形式），GET /v1/jobs/{job_id} 水合职位详情（描述、key_skills、联系方式）。

求职者侧的 GET /v1/cv/{cv_id} 返回完整简历，GET /v1/applications 列出应聘沟通记录，GET /v1/jobs/{job_id}/phone 揭示招聘方电话。

hh: поиск работы（包名 ru.hh.android，版本 26.35.1）是 HeadHunter 的安卓客户端，覆盖其各地区招聘网站的职位搜索、简历、应聘与雇主联系方式。应用的数据 API 以 JSON 返回职位、简历与沟通记录。

应用截图

API 端点一览

搜索职位

GET /v1/jobs/search opendata

分页返回职位列表（title、salary_range、area、employer、work_format），用于首页搜索。

认证方式： Optional OAuth2 Bearer access token from the app's sign-in flow. Signed requests also send a generated User-Agent ({package}/{version}, Device, Android OS, UUID).

items
id
name
published_at
created_at
archived
alternate_url
url
salary_range
from
to
currency
gross
mode
frequency
area
employer
trusted
open_vacancies
accredited_it_employer
logo_urls
experience
employment_form
work_format
show_contacts
response_letter_required
found
page
pages
per_page

依据应用界面重构的示意示例，并非实时抓包。

GET /v1/jobs/search?text=product+manager&area=1&page=0&per_page=20 HTTP/1.1
User-Agent: <package>/<version>, Device: <device>, Android OS: <os> (UUID: <uuid>)
Authorization: Bearer <access_token>

{
  "items": [
    {
      "id": "123456789",
      "name": "Product Manager",
      "published_at": "2026-09-20T10:15:00+0300",
      "created_at": "2026-09-18T09:00:00+0300",
      "archived": false,
      "alternate_url": "https://example.org/vacancy/123456789",
      "url": "https://example.org/api/jobs/123456789",
      "salary_range": {"from": 180000, "to": 250000, "currency": "RUR", "gross": true, "mode": "MONTH", "frequency": "MONTH"},
      "area": {"id": "1", "name": "Москва", "url": "https://example.org/api/areas/1"},
      "employer": {"id": "1337", "name": "Example Corp", "alternate_url": "https://example.org/employer/1337", "trusted": true, "open_vacancies": 42, "accredited_it_employer": true, "logo_urls": {"90": "https://cdn.example.org/logo90.png", "240": "https://cdn.example.org/logo240.png", "original": "https://cdn.example.org/logo.png"}},
      "experience": {"id": "between3And6", "name": "От 3 до 6 лет"},
      "employment_form": {"id": "FULL", "name": "Полная занятость"},
      "work_format": [{"id": "HYBRID", "name": "Гибрид"}],
      "show_contacts": true,
      "response_letter_required": false,
      "accept_incomplete_resumes": true,
      "has_test": false
    }
  ],
  "found": 1284,
  "page": 0,
  "pages": 65,
  "per_page": 20,
  "alternate_url": "https://example.org/search/vacancy?text=product+manager&area=1"
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

Reconstructed from the search-results screen flow and its pagination parameters
Wire field names taken from the vacancy list and salary payloads

获取职位详情

GET /v1/jobs/{job_id} opendata

水合职位卡片（description、key_skills、salary_range、employer、contacts 等）。

认证方式： Bearer access_token for signed-in extras (relations, show_contacts, chat flags). User-Agent as above.

id
name
description
key_skills
published_at
created_at
archived
alternate_url
apply_alternate_url
negotiations_url
salary_range
area
address
employer
experience
employment_form
work_format
schedule
working_hours
work_schedule_by_days
professional_roles
response_letter_required
accept_incomplete_resumes
show_contacts
contacts
email
phones
formatted
responses_count
allow_chat_with_manager
relations

依据应用界面重构的示意示例，并非实时抓包。

GET /v1/jobs/123456789 HTTP/1.1
User-Agent: <package>/<version>, Device: <device>, Android OS: <os> (UUID: <uuid>)
Authorization: Bearer <access_token>

{
  "id": "123456789",
  "name": "Product Manager",
  "description": "<p>Lead the candidate experience squad.</p>",
  "key_skills": [{"name": "product management"}, {"name": "SQL"}],
  "published_at": "2026-09-20T10:15:00+0300",
  "created_at": "2026-09-18T09:00:00+0300",
  "archived": false,
  "alternate_url": "https://example.org/vacancy/123456789",
  "apply_alternate_url": "https://example.org/applicant/vacancy_response?vacancyId=123456789",
  "negotiations_url": "https://example.org/api/applications?vacancy_id=123456789",
  "salary_range": {"from": 180000, "to": 250000, "currency": "RUR", "gross": true},
  "area": {"id": "1", "name": "Москва"},
  "address": {"city": "Москва", "street": "Тверская", "building": "1", "lat": 55.76, "lng": 37.61},
  "employer": {"id": "1337", "name": "Example Corp", "trusted": true, "accredited_it_employer": true},
  "experience": {"id": "between3And6", "name": "От 3 до 6 лет"},
  "employment_form": {"id": "FULL", "name": "Полная занятость"},
  "work_format": [{"id": "HYBRID", "name": "Гибрид"}],
  "schedule": {"id": "fullDay", "name": "Полный день"},
  "working_hours": [{"id": "HOURS_8", "name": "8 часов"}],
  "work_schedule_by_days": [{"id": "FIVE_ON_TWO_OFF", "name": "5/2"}],
  "professional_roles": [{"id": "73", "name": "Менеджер продукта"}],
  "response_letter_required": false,
  "accept_incomplete_resumes": true,
  "accept_temporary": false,
  "internship": false,
  "show_contacts": true,
  "contacts": {"name": "Anna Petrova", "email": "[email protected]", "call_tracking_enabled": true, "phones": [{"country": "7", "city": "495", "number": "1234567", "formatted": "+7 (495) 123-45-67"}]},
  "responses_count": 42,
  "allow_chat_with_manager": true,
  "relations": ["got_response"]
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

Reconstructed from the vacancy-detail screen and deep-link handling
Field names taken from the full vacancy and contacts payloads

获取求职者简历

GET /v1/cv/{cv_id} osint

返回登录求职者的完整简历（姓名、birth_date、联系方式、教育、经历等）。

认证方式： Bearer access_token required. The native resume screen asks for professional roles and credential extras via query flags.

id
last_name
first_name
middle_name
title
created_at
updated_at
birth_date
age
gender
area
salary
contact
education
experience
skill_set
skills
professional_roles
status
access
total_views
new_views
views_url
alternate_url
can_publish_or_update
next_publish_at
progress
creds

依据应用界面重构的示意示例，并非实时抓包。

GET /v1/cv/abc12defghijklmnopqrstuvwx?include=roles,credentials HTTP/1.1
User-Agent: <package>/<version>, Device: <device>, Android OS: <os> (UUID: <uuid>)
Authorization: Bearer <access_token>

{
  "id": "abc12defghijklmnopqrstuvwx",
  "last_name": "Ivanov",
  "first_name": "Ivan",
  "middle_name": "Ivanovich",
  "title": "Product Manager",
  "created_at": "2024-03-01T12:00:00+0300",
  "updated_at": "2026-09-21T08:30:00+0300",
  "birth_date": "1992-04-12",
  "age": 34,
  "gender": {"id": "male", "name": "Мужской"},
  "area": {"id": "1", "name": "Москва"},
  "salary": {"amount": 220000, "currency": "RUR"},
  "contact": [{"kind": "email", "value": "[email protected]", "preferred": true}, {"kind": "cell", "value": {"formatted": "+7 999 123-45-67"}}],
  "education": {"level": {"id": "higher", "name": "Высшее"}, "primary": [{"organization": "MGU", "name": "Economics", "year": 2014}]},
  "experience": [{"company": "Example Corp", "position": "Product Manager", "start": "2020-01-01", "end": null}],
  "skill_set": ["SQL", "product management"],
  "skills": "Led marketplace growth.",
  "professional_roles": [{"id": "73", "name": "Менеджер продукта"}],
  "status": {"id": "published", "name": "Опубликовано"},
  "access": {"type": {"id": "clients", "name": "Видно всем компаниям"}},
  "total_views": 128,
  "new_views": 7,
  "views_url": "https://example.org/api/cv/abc12defghijklmnopqrstuvwx/viewers",
  "alternate_url": "https://example.org/resume/abc12defghijklmnopqrstuvwx",
  "can_publish_or_update": true,
  "next_publish_at": "2026-09-24T08:30:00+0300",
  "progress": {"percentage": 92},
  "creds": {"email": "[email protected]"}
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

Reconstructed from the My resumes screen and the resume editor flow
Field names taken from the full resume payload, including views counters

列出应聘沟通记录

GET /v1/applications osint

列出求职者对各职位的投递（state、viewed_by_opponent、关联职位 / 简历、时间）。

认证方式： Bearer access_token required. User-Agent as above.

items
id
state
hidden
read
created_at
updated_at
url
has_updates
viewed_by_opponent
messaging_status
decline_allowed
vacancy
resume
chat_id
employer_responses_read_percent
manager_inactive_minutes
source
employer_violates_rules
tags
found
page
pages
per_page

依据应用界面重构的示意示例，并非实时抓包。

GET /v1/applications?page=0&per_page=20 HTTP/1.1
User-Agent: <package>/<version>, Device: <device>, Android OS: <os> (UUID: <uuid>)
Authorization: Bearer <access_token>

{
  "items": [
    {
      "id": "987654321",
      "state": {"id": "response", "name": "Отклик"},
      "hidden": false,
      "read": true,
      "created_at": "2026-09-19T11:00:00+0300",
      "updated_at": "2026-09-21T09:15:00+0300",
      "url": "https://example.org/api/applications/987654321",
      "has_updates": true,
      "viewed_by_opponent": true,
      "messaging_status": "has_new",
      "decline_allowed": true,
      "vacancy": {"id": "123456789", "name": "Product Manager", "alternate_url": "https://example.org/vacancy/123456789"},
      "resume": {"id": "abc12defghijklmnopqrstuvwx", "title": "Product Manager"},
      "chat_id": "c-555",
      "employer_responses_read_percent": 80,
      "manager_inactive_minutes": 120,
      "source": "search",
      "employer_violates_rules": false,
      "tags": []
    }
  ],
  "found": 12,
  "page": 0,
  "pages": 1,
  "per_page": 20
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

Reconstructed from the responses tab flow and its per-item status payload
A matching POST variant creates an application from vacancy id, resume id and a cover message

列出简历浏览记录

GET /v1/cv/{cv_id}/viewers osint

返回谁看过该简历（雇主 id / 名称 / logo、created_at、已读标记）。

认证方式： Bearer access_token required. User-Agent as above.

items
created_at
viewed
employer
id
name
url
alternate_url
vacancies_url
logo_urls
resume
title
found
page
pages
per_page

依据应用界面重构的示意示例，并非实时抓包。

GET /v1/cv/abc12defghijklmnopqrstuvwx/viewers?page=0&per_page=20 HTTP/1.1
User-Agent: <package>/<version>, Device: <device>, Android OS: <os> (UUID: <uuid>)
Authorization: Bearer <access_token>

{
  "items": [
    {
      "created_at": "2026-09-21T14:22:00+0300",
      "viewed": true,
      "employer": {
        "id": "1337",
        "name": "Example Corp",
        "url": "https://example.org/api/employers/1337",
        "alternate_url": "https://example.org/employer/1337",
        "vacancies_url": "https://example.org/api/jobs/search?employer_id=1337",
        "logo_urls": {"90": "https://cdn.example.org/logo90.png", "240": "https://cdn.example.org/logo240.png", "original": "https://cdn.example.org/logo.png"}
      }
    }
  ],
  "resume": {"id": "abc12defghijklmnopqrstuvwx", "title": "Product Manager", "url": "https://example.org/api/cv/abc12defghijklmnopqrstuvwx"},
  "found": 128,
  "page": 0,
  "pages": 7,
  "per_page": 20
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

Reconstructed from the who-viewed-my-resume screen and its employer payload

获取职位联系电话
GET /v1/jobs/{job_id}/phone osint
揭示职位招聘方电话（国家 / 城市 / 号码 / 格式化串、virtual_phone_state），用于拨打。
认证方式： Bearer access_token required. Shown after the applicant taps show contacts on the vacancy card.
- comment
- city
- number
- country
- formatted
- virtual_phone_state
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v1/jobs/123456789/phone HTTP/1.1
User-Agent: <package>/<version>, Device: <device>, Android OS: <os> (UUID: <uuid>)
Authorization: Bearer <access_token>
```
```
{
  "comment": "HR desk, 10:00–18:00 MSK",
  "city": "495",
  "number": "1234567",
  "country": "7",
  "formatted": "+7 (495) 123-45-67",
  "virtual_phone_state": "enabled"
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- Reconstructed from the vacancy contacts sheet shown after tapping show contacts

数据类别

职位
简历
应聘记录
联系方式
雇主
资料

数据使用场景与案例

职位市场分析
薪酬对标管道聚合职位搜索结果——薪资区间、地区、雇主资质、办公形式——绘制分角色分地区的薪酬带地图。
招聘管道同步
ATS 集成镜像沟通列表——状态、已读未读、对方是否查看、会话号——招聘官只需经营一条管道，不必守两个收件箱。
简历效果追踪
求职工具列出哪些雇主在何时查看了简历，把查看量与简历修改关联，告诉候选人哪个版本真正获得关注。

常见问题

hh 安卓端使用什么数据 API？

应用调用一套私有 JSON API：GET /v1/jobs/search 搜索职位、GET /v1/jobs/{job_id} 取详情；简历、应聘记录、简历浏览与联系电话各有端点。

职位搜索返回哪些字段？

GET /v1/jobs/search 分页返回职位卡片：title、salary_range、area、employer 与 work_format，用于首页列表渲染。

应聘记录（negotiations）包含什么？

GET /v1/applications 列出求职者对各职位的投递：state、viewed_by_opponent（雇主是否已读）、关联职位与简历 id 及时间戳。

如何获取职位的联系电话？

GET /v1/jobs/{job_id}/phone 返回招聘方电话（国家 / 城市 / 号码 / 格式化串与虚拟号状态），供一键拨打；属于需登录的私有端点。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

获取报价

hh: поиск работы 数据 API

应用截图

API 端点一览

搜索职位

获取职位详情

获取求职者简历

列出应聘沟通记录

列出简历浏览记录

获取职位联系电话

数据类别

数据使用场景与案例

职位市场分析

招聘管道同步

简历效果追踪

常见问题

相关应用

相关主题

需要集成这个 App 的数据 API？