HeadHunter API

HeadHunter API — это бесплатный инструментарий для интеграции HeadHunter в ваш продукт.

Base URI

https://api.hh.ru
Parameters
per_page
string required

параметр пэйджинга - количество результатов на странице;
макс значение - 2000

Example:
10
page
number optional

параметр пэйджинга - номер страницы

Example:
1
API Methods
Вакансии
GET /vacancies/{vacancy_id}
GET /vacancies/favorited
PUT /vacancies/favorited/{vacancy_id}
DELETE /vacancies/favorited/{vacancy_id}
Просмотр вакансии
GET /vacancies/{vacancy_id}

возвращает подробную информацию по указанной вакансии

Path variables

vacancy_id
number required

идентификатор вакансии

Example:
1002002

Responses

200 OK
Body
Список избранных
GET /vacancies/favorited

Возвращает подмножество вакансий, добавленных пользователем в отобранные. Требует авторизации, иначе вернёт 403 Forbidden. Пейджинг работает по стандартным page&per_page, страницы нумеруются с нуля.

Responses

200 OK
Добавить в избранное
PUT /vacancies/favorited/{vacancy_id}

Добавляет указанную вакансию в список отобранных. Данная операция — идемпотентная: при добавлении вакансии, которая уже есть в отобранных, вернётся также 204 No Content, как и в случае первичного добавления. Если вакансия не найдена, то сервер вернёт 404 Not Found, если по каким-либо причинам не хватает прав положить вакансию в избранное — 403 Forbidden.

Path variables

vacancy_id
string required

идентификатор вакансии

Example:
1000299

Responses

204 No Content
Удалить из избранного
DELETE /vacancies/favorited/{vacancy_id}

удалит вакансию из списка отобранных авторизованного пользователя

Path variables

vacancy_id
string required

идентификатор вакансии

Example:
12431234

Responses

200 OK
Поиск вакансий
GET /vacancies

Поиск по вакансиям

Request parameters

text
string optional

Текстовое поле
переданное значение ищется в полях вакансии, указанных в параметре search_field. Доступен язык запросов, как и на основном сайте: http://hh.ru/article/1175.

search_field
string optional

Область поиска.
Справочник с возможными значениями: vacancy_search_fields в /dictionaries. По умолчанию, используется все поля. Возможно указание нескольких значений.

experience
string optional

Опыт работы.
Справочник с возможными значениями: experience в /dictionaries.

employment
string optional

Тип занятости
Справочник с возможными значениями: employment в /dictionaries. Возможно указание нескольких значений.

schedule
string optional

График работы.
Справочник с возможными значениями: schedule в /dictionaries. Возможно указание нескольких значений.

area
string optional

Регион.
Справочник с возможными значениями: /areas. Возможно указание нескольких значений.

metro
string optional

Ветка или станция метро. Справочник с возможными значениями: /metro. Возможно указание нескольких значений.

specialization
string optional

Профобласть или специализация.
Справочник с возможными значениями: /specializations. Возможно указание нескольких значений.

employer_id
string optional

Идентификатор компании. Возможно указание нескольких значений.

currency
string optional

Код валюты.
Справочник с возможными значениями: currency (ключ code) в /dictionaries.

salary
string optional

Размер заработной платы.
Если указано это поле, но не указано currency, то используется значение RUR у currency.

Example:
50000
label
string optional

фильтр по меткам вакансий.
Справочник с возможными значениями: vacancy_label в /dictionaries. Возможно указание нескольких значений.

only_with_salary
boolean optional

Показывать вакансии только с указанием зарплаты. Возможные значения: true или false. По умолчанию, используется false.

Example:
true
period
number optional

Количество дней, в пределах которых нужно найти вакансии. Максимальное значение: 30.

Example:
1
order_by
string optional

Cортировка списка вакансий.
Справочник с возможными значениями: vacancy_search_order в /dictionaries.

top_lat
string optional

Значение гео-координат.
При поиске используется значение указанного в вакансии адреса. Принимаемое значение — градусы в виде десятичной дроби. Необходимо передавать одновременно все четыре параметра гео-координат, иначе вернется ошибка.

Example:
70.012
bottom_lat
string optional

см. top_lat

left-lng
string optional

см. top_lat

right_lng
string optional

см. top_lat

Responses

200 OK
Body
Array of VacancySimple
Работодатели
GET /employers/{employer_id}
Поиск компаний
GET /employers

Поиск работодателя/компании

Request parameters

text
string optional

Текстовое поле, переданное значение ищется в названии и описании компании

area
string optional

Множественный параметр, идентификатор региона работодателя. Идентификаторы регионов можно узнать в справочнике регионов

type
string optional

множественный параметр, типы работодателей. Разрешенные значения - ключи в разделе employer_type в /dictionaries

only_with_vacancies
boolean optional

возвращать только работодателей у которых есть в данный момент открытые вакансии (true) или же всех (false), по умолчанию - false

Example:
true

Responses

200 OK
Body
Array of Employer
Информация о компании
GET /employers/{employer_id}

Path variables

employer_id
string required

идентификатор компании

Responses

200 OK
Body
Резюме
GET /resumes/{resume_id}
Собственные резюме
GET /resumes/mine

Вернёт список ваших резюме. Этот метод требует авторизации, в противном случае ответом будет 403 Forbidden.

Responses

200 OK
Получение резюме
GET /resumes/{resume_id}

Path variables

resume_id
string required

Идентификатор резюме

Example:
502ff8b100018bddf30039ed1f63735f4dda66

Responses

200 OK
Отклики

В данный момент функциональность откликов/приглашений реализована только для соискателей. Для работодателей данный сервис запланирован, но еще не выпущен. В процессе использования сайта соискатели выбирают вакансии. Для того чтобы связаться с работодателем на предмет трудоустройства соискатель может откликнуться на выбранную вакансию. Так же и работодатель, найдя интересное резюме, может предложить соискателю рассмотреть вакансию.

Для указанных целей служат специальные сущности - отклики. В отк

GET /negotiations/active
GET /negotiations/{nid}
DELETE /negotiations/active/{nid}
GET /negotiations/{nid}/messages
Список откликов
GET /negotiations

Request parameters

order_by
string optional

Поле, по которому проводить сортировку выдаваемых данных. Возможные значения: updated_at, created_at. По умолчанию: updated_at

Example:
created_at
order
string optional

Направление сортировки. Возможные значения: asc, desc. По умолчанию: desc

vacancy_id
string optional

фильтр по id вакансии

Responses

200 OK
Body
Array of Negotiation
Список активных
GET /negotiations/active

см. Список откликов за дополнительной инофрмацией

Responses

200 OK
Откликнуться на вакансию
POST /negotiations

Request parameters

vacancy_id
string required

Идентификатор вакансии, на которую происходит отклик

resume_id
string required

Идентификатор резюме, которым производится отклик

message
string optional

Сопроводительное письмо к отклику. Является обязательным, если в вакансии указано, что обязательно сопроводительное письмо

Responses

201 Created
Просмотр отклика
GET /negotiations/{nid}

Path variables

nid
string required

идентификатор отклика.

Responses

200 OK
Скрыть отклик
DELETE /negotiations/active/{nid}

Path variables

nid
string required

идентификатор отклика

Responses

204 No Content
Cообщения в отклике
GET /negotiations/{nid}/messages

Path variables

nid
string required

идентификатор отклика

Responses

200 OK
Body
Object
id
string

Идентификатор сообщения

Example:
123
read
boolean

Прочитано ли сообщение принимающей стороной. В запросе редактирования сообщения можно указывать только не прочитанные сообщения.

Example:
true
created_at
string

Дата и время создания сообщения

Example:
2013-10-07T18:30:57+0400
text
string

Текст сообщения

Example:
Вас приглашает очень крупный иностранный банк на зарплату, о которой мечтают арабские шейхи
state
Object

Текущее состояние отклика. Разрешенные значения находятся в справочнике /dictionaries в разделе negotiations_state

id
string
Example:
invitation
name
string
Example:
Приглашение
address
Редактировать сообщение в отклике
GET /negotiations/{nid}/messages/{mid}

Если сообщение, адресованное работодателю, ещё не было им прочитано (флаг read в сообщении), то его можно отредактировать.

Path variables

nid
string required

идентификатор отклика

mid
string required

идентификатор сообщения в отклике

Request parameters

message
string required

Текст сообщения

Responses

204 No Content
Data Reference
Vacancy

Подробное представление вакансии

Object
id
string

Идентификатор вакансии

Example:
8331228
description
string
Example:
...
schedule
Object
id
string
Example:
fullDay
name
string
Example:
Полный день
accept_handicapped
boolean
Example:
false
experience
Object
id
string
Example:
fullDay
name
string
Example:
Полный день
address
alternate_url
string
Example:
http://hh.ru/vacancy/8331228
employment
Object
id
string
Example:
fullDay
name
string
Example:
Полный день
salary
Object
to
number
Example:
10000
from
number
Example:
30000
currency
string
Example:
RUR
archived
boolean
Example:
false
name
string
Example:
Секретарь
area
Object
url
string
Example:
https://api.hh.ru/areas/1
id
string
Example:
1
name
string
Example:
Москва
created_at
string
Example:
2013-07-08T16:17:21+0400
relations
Array of unknown

При запросе с авторизацией возвращает значения из справочника vacancy_relations в /dictionaries.

negotiations_url
string

ссылка для получения списка откликов/приглашений по данной вакансии текущего пользователя-соискателя (для других типов пользователей возвращается null).

Example:
https://api.hh.ru/negotiations?vacancy_id=8331228
employer
Object
logo_urls
Object
90
string
Example:
http://hh.ru/employer-logo/289027.png
240
string
Example:
http://hh.ru/employer-logo/289169.png
original
string
Example:
http://hh.ru/file/2352807.png
name
string
Example:
HeadHunter
url
string
Example:
https://api.hh.ru/employers/1455
alternate_url
string
Example:
http://hh.ru/employer/1455
id
string
Example:
1455
trusted
boolean
Example:
true
response_letter_required
boolean
Example:
true
response_url
string

На вакансии с типом direct нельзя откликнуться на сайте hh.ru, у этих вакансий в ключе response_url выдаётся URL внешнего сайта (чаще всего это сайт работодателя с формой отклика) Подробнее в документации по откликам

Example:
http://company.ru/response.html
type
Object
id
string
Example:
fullDay
name
string
Example:
Полный день
test
Object

Информация о прикрепленном тестовом задании к вакансии. В случае отсутствия теста — null, в противном случае объект с ключом required, который указывает на необходимость заполнения теста для отклика. В данный момент отклик на вакансии с обязательным тестом через API невозможен.

required
boolean
Example:
false
specializations
Array
Object
profarea_id
string
Example:
4
profarea_name
string
Example:
Административный персонал
id
string
Example:
4.255
name
string
Example:
Ресепшен
contacts
Object

Контактная информация. В вакансиях, где контакты не указаны, возвращается null. Все внутренние ключи являются строками либо null. Список телефонов может быть пустым.

name
string
Example:
Имя
email
string
Example:
user@example.com
phones
Array
Object
comment
unknown
city
string
Example:
985
number
string
Example:
000-00-00
country
string
Example:
7
Address
Object
city
string
Example:
Москва
street
string
Example:
Годовикова
building
string
Example:
9
description
string
Example:
Текстовое описание адреса
lat
number
Example:
55.807794
lng
number
Example:
37.638699
raw
string
Example:
Текстовое описание адреса, как было введено
metro
Object
station_name
string
Example:
название станции
line_name
string
Example:
Название линии
station_id
string
Example:
Идентификатор станции
line_id
string
Example:
Идентификатор линии
lat
number
Example:
55.807794
lng
number
Example:
37.638699
VacancySimple

короткое представление вакансии

Object
id
string

Идентификатор вакансии

Example:
7760476
premium
boolean

Является ли премиум вакансией

Example:
true
address

Адрес вакансии

alternate_url
string

Ссылка на представление вакансии на сайте

Example:
http://hh.ru/vacancy/7760476
salary
Object

Оклад

to
number
Example:
1
from
number
Example:
100000
currency
string
Example:
RUR
name
string

Название вакансии

Example:
Специалист по автоматизации тестирования (Java, Selenium)
area
Object

Регион размещения вакансии

url
string
Example:
https://api.hh.ru/areas/1
id
string
Example:
1
name
string
Example:
Москва
url
string

Ссылка на полное представление вакансии в api

Example:
https://api.hh.ru/vacancies/7760476
created_at
string

Дата и время создания вакансии

Example:
2013-10-11T13:27:16+0400
relations
Array of unknown
employer
Object

Короткое представление работодателя

url
string
Example:
https://api.hh.ru/employers/1455
alternate_url
string
Example:
http://hh.ru/employer/1455
logo_urls
Object
90
string
Example:
http://hh.ru/employer-logo/289027.png
240
string
Example:
http://hh.ru/employer-logo/289169.png
original
string
Example:
http://hh.ru/file/2352807.png
name
string
Example:
HeadHunter
id
string
Example:
1455
response_letter_required
boolean

Обязательно ли заполнять сообщение при отклике

Example:
false
type

Тип вакансии, один из элементов vacancy_type в Справочнике

Employer

Короткое представление работодателя

Object
url
string

ссылка на детальное описание работодателя

Example:
https://api.hh.ru/employers/1455
alternate_url
string

ссылка на описание работодателя на сайте

Example:
http://hh.ru/employer/1455
logo_urls

логотипы компании

name
string

название работодателя

Example:
HeadHunter
id
string

идентификатор работодателя

Example:
1455
vacancies_url
string

cсылка на поисковую выдачу вакансий данной компании

open_vacancies
string

количество открытых вакансий у работодателя

type
string

Тип компании (прямой работодатель, кадровое агентство и т.п.). Возможные значения описаны в коллекции справочников под ключом employer_type.

trusted
boolean

//todo

Example:
false
site_url
string

Веб сайт компании

Example:
http://hh.ru
LogoUrls

Изображения логотипа компании разных размеров

Object
90
string
Example:
http://hh.ru/employer-logo/289027.png
240
string
Example:
http://hh.ru/employer-logo/289169.png
original
string

Необработанный логотип, который может быть большого размера. Если изначально загруженный компанией логотип меньше, чем 240px и/или 90px по меньшей стороне, то в соответствующих ключах будут ссылки на изображения оригинального размера. Объект может быть null, если компания не загрузила логотип. Клиент должен предусмотреть возможность отсутствия логотипа по указанной ссылке (ответ с кодом 404 Not Found).

Example:
http://hh.ru/file/2352807.png
Types: Employer
EnumType
Object
id
string
Example:
fullDay
name
string
Example:
Полный день
Area
Object
url
string
Example:
https://api.hh.ru/areas/1
id
string
Example:
1
name
string
Example:
Москва
ResumeSimple

Короткое представление резюме

Object
id
string

Идентификатор резюме

Example:
502ff8b100018bddf30039ed1f63735f4dda66
name
string

Желаемая должность

Example:
консультант
url
string

Ссылка на получение полной версии резюме

Example:
https://api.hh.ru/resumes/502ff8b100018bddf30039ed1f63735f4dda66
Negotiation

В процессе использования сайта соискатели выбирают вакансии. Для того чтобы связаться с работодателем на предмет трудоустройства соискатель может откликнуться на выбранную вакансию. Так же и работодатель, найдя интересное резюме, может предложить соискателю рассмотреть вакансию.

Для указанных целей служат специальные сущности - отклики. В отклике может быть указана вакансия, резюме и переписка соискателя с работодателем, в каждый момент времени отклик находится в одном из состояний. Переход меж

Object
id
string

Идентификатор отклика

Example:
123
state
Object

Текущее состояние отклика. Разрешенные значения находятся в справочнике /dictionaries в разделе negotiations_state

id
string
Example:
invitation
name
string
Example:
Приглашение
hidden
boolean

Скрыт ли текущий отклик (True - отклик скрыт, False - отклик активен)

Example:
false
created_at
string

Дата и время создания отклика

Example:
2013-10-05T19:51:38+0400
updated_at
string

Дата и время последнего обновления отклика

Example:
2013-10-07T18:30:57+0400
url
string

Ссылка на полную версию отклика

Example:
https://api.hh.ru/negotiations/123
resume
vacancy
Paging

К любому запросу, подразумевающему выдачу списка объектов, можно в параметрах указать page=N&per_page=M. Нумерация идёт с нуля, по умолчанию выдаётся первая (нулевая) страница с 20 объектами на странице. Во всех ответах, где доступна пагинация, единообразный корневой объект

Object
found
number

Количество найденных пезультатов

Example:
1000
per_page
number

количество результатов на странице, задается параметром per_page

Example:
20
pages
number

количество страниц

Example:
1
page
number

номер страницы

Example:
0
items
Object data_container

массив с результатами

E1
string
Enumeration:
v1
v2