HeadHunter API

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

Base URI

https://api.hh.ru

Просмотр вакансии

GET /vacancies/{vacancy_id}

Список избранных

GET /vacancies/favorited

Добавить в избранное

PUT /vacancies/favorited/{vacancy_id}

Удалить из избранного

DELETE /vacancies/favorited/{vacancy_id}

Поиск вакансий

GET /vacancies

GET /vacancies/{vacancy_id}

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

Path variables

vacancy_id

number required

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

Example:

1002002

Responses

200 OK

Body

Vacancy

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

Информация о компании

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

Employer

Собственные резюме

GET /resumes/mine

Получение резюме

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

Body

ResumeSimple

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

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

Список откликов

GET /negotiations

Список активных

GET /negotiations/active

Откликнуться на вакансию

POST /negotiations

Просмотр отклика

GET /negotiations/{nid}

Скрыть отклик

DELETE /negotiations/active/{nid}

Cообщения в отклике

GET /negotiations/{nid}/messages

Редактировать сообщение в отклике

GET /negotiations/{nid}/messages/{mid}

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

Body

Negotiation

DELETE /negotiations/active/{nid}

Path variables

nid

string required

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

Responses

204 No Content

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

Address

GET /negotiations/{nid}/messages/{mid}

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

Path variables

nid

string required

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

mid

string required

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

Request parameters

message

string required

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

Responses

204 No Content

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

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

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

Methods: Просмотр вакансии

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

Methods: Cообщения в отклике

Types: Vacancy VacancySimple

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

Object

id

string

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

Example:

7760476

premium

boolean

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

Example:

true

address

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

EnumType

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

Methods: Поиск вакансий

Types: Negotiation

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

Object

url

string

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

Example:

https://api.hh.ru/employers/1455

alternate_url

string

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

Example:

http://hh.ru/employer/1455

logo_urls

LogoUrls

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

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

Methods: Информация о компании Поиск компаний

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

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

Object

id

string

Example:

fullDay

name

string

Example:

Полный день

Types: VacancySimple

Object

url

string

Example:

https://api.hh.ru/areas/1

id

string

Example:

1

name

string

Example:

Москва

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

Object

id

string

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

Example:

502ff8b100018bddf30039ed1f63735f4dda66

name

string

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

Example:

консультант

url

string

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

Example:

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

Methods: Получение резюме

Types: 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

ResumeSimple

vacancy

VacancySimple

Methods: Просмотр отклика Список откликов

К любому запросу, подразумевающему выдачу списка объектов, можно в параметрах указать 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

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

Methods: Поиск вакансий Поиск компаний Список откликов

string

Enumeration:

v1

v2