api icon indicating copy to clipboard operation
api copied to clipboard

HeadHunter API: документация и библиотеки

HeadHunter API

По-русски | In english

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

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

Для использования методов, требующих авторизацию пользователя или приложения, вам необходимо зарегистрировать приложение по адресу https://dev.hh.ru и настроить процесс авторизации.

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

‼️ Обратите внимание на Поддержку нового каталога специализаций (профессиональных ролей) .

Доступ к ряду методов для работодателя платный.

Для уточнения стоимости API необходимо обратиться к Вашему персональному менеджеру или позвонить по телефону: +7 495 974-64-27 (для Москвы и Подмосковья),
+7 812 458-45-45 (для Санкт-Петербурга),
8 800 100-64-27 (для регионов России),
+375 17 336 03 02, +375 33 336 03 02 (для Республики Беларусь).

OpenAPI

Доступная в OpenAPI документация будет со временем дополняться. Методы, описанные в данной документации и доступные в OpenAPI, имеют соответствующую ссылку.

Спецификация HeadHunter API: openapi.yml.

Содержание

Пометки в документации:

  • anonymous – актуально для анонимных запросов, не требует авторизации.
  • client – актуально для запросов от имени приложения, требует авторизацию приложения
  • applicant – актуально для запросов от имени соискателя, требует авторизацию пользователя.
  • employer – актуально для бесплатных методов работодателя, требует авторизацию пользователя.
  • employer with paid access – актуально для платных методов работодателя, требует авторизацию пользователя.

Общая информация

Контекст

Резюме

  • Поиск резюме employer with paid access
  • Сохраненные поиски резюме employer with paid access
    • Список сохраненных поисков резюме employer with paid access
    • Получение единичного сохраненного поиска резюме employer with paid access
    • Создание нового сохраненного поиска резюме employer with paid access
    • Обновление сохраненного поиска резюме employer with paid access
    • Удаление сохраненного поиска резюме employer with paid access
    • Передача сохраненного поиска резюме другому менеджеру employer with paid access
  • Просмотр резюме employer with paid access
  • Работа с резюме для соискателя applicant
    • Работа с телефоном applicant
    • Список резюме авторизованного пользователя applicant
    • Просмотр резюме applicant
    • Создание и редактирование резюме applicant
    • Публикация и продление резюме applicant
    • Удаление резюме applicant
    • История просмотра резюме applicant
    • Информация о статусе резюме и готовности резюме к публикации applicant
    • Списки видимости резюме applicant
  • Артефакты (фото, портфолио) applicant
  • Поиск по вакансиям, похожим на резюме applicant
  • История откликов/приглашений по резюме employer with paid access

Вакансии

Соискатели

Работодатели/компании

Менеджеры работодателя

Переписка (отклики/приглашения)

  • Переписка для соискателя applicant
    • Получение списка откликов applicant
    • Получение списка активных откликов applicant
    • Откликнуться на вакансию applicant
    • Просмотр отклика/приглашения applicant
    • Скрыть отклик applicant
    • Просмотр списка сообщений в отклике applicant
    • Отправка сообщений в отклике applicant
    • Редактирование сообщения в отклике applicant
  • Резюме для отклика на указанную вакансию applicant
    • Список резюме, которыми можно откликнуться на указанную вакансию applicant
    • Резюме, сгруппированные по возможности отклика на данную вакансию applicant
  • Переписка для работодателя employer with paid access
    • Модель работы, термины и процедуры employer with paid access
    • Общее описание процесса работы с откликами/приглашениями employer with paid access
    • Коллекции и работодательские состояния откликов/приглашений employer with paid access
    • Список откликов/приглашений employer with paid access
    • Просмотр отклика/приглашения employer with paid access
    • Работа с сообщениями по отклику/приглашению для работодателя employer with paid access
    • Приглашение соискателя на вакансию employer with paid access
    • Действия по отклику/приглашению (смена состояния) employer with paid access
    • Статистика по работе с откликами employer with paid access
  • Тексты сообщений employer with paid access
  • Инструменты оценки applicant employer with paid access

Справочники

Подсказки (autosuggest, autocomplete)

  • Подсказки в OpenAPI anonymous client applicant employer
  • Подсказки anonymous client applicant employer
    • по названиям университетов anonymous client applicant employer
    • по организациям anonymous client applicant employer
    • по специализациям anonymous client applicant employer
    • по ключевым навыкам anonymous client applicant employer
    • по должностям резюме anonymous client applicant employer
    • по регионам anonymous client applicant employer
    • по ключевым словам поиска вакансий anonymous client applicant employer

Банк данных заработных плат

  • Отчёты Банка данных заработных плат employer
    • Оценка заработной платы без прогнозов employer
  • Справочники Банка данных заработных плат anonymous client applicant employer
    • Отрасли anonymous client applicant employer
    • Уровни специалистов anonymous client applicant employer
    • Профобласти и специализации anonymous client applicant employer
    • Регионы и города anonymous client applicant employer

Поддержка, обратная связь, новости

Общайтесь с нами через twitter @apihhru или через почту [email protected].

Если вы нашли баг в работе HeadHunter API или виджетах, загляните в issues, возможно, про него мы уже знаем и чиним. Если нет, лучше всего сообщить о нём там. Там же вы можете оставлять свои пожелания и предложения.

Если вы нашли проблему на одном из сайтов HeadHunter, напишите в поддержку по сайту или в сообщество поддержки.

За новостями вы можете следить по коммитам в этом репозитории. RSS.

Часто задаваемые вопросы собраны в FAQ.