api
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.
Содержание
Пометки в документации:
–
актуально для анонимных запросов, не требует авторизации.
– актуально для запросов от имени приложения, требует авторизацию приложения
–
актуально для запросов от имени соискателя, требует авторизацию пользователя.
–
актуально для бесплатных методов работодателя, требует авторизацию пользователя.
–
актуально для платных методов работодателя, требует авторизацию пользователя.
Общая информация
- Общая информация

- Условия использования сервиса API

- Требования к использованию логотипов

- Требования к названию приложений

- Авторизация

- Кэширование

- Ошибки и коды ответов

- Платный доступ для работодателей к некоторым методом API

- Новая модель работы с базой резюме (поддержка в API)

- Новый каталог специализаций (профессиональных ролей). Поддержка в API HH

Контекст
- Информация об авторизованном пользователе или приложении
- Получение информации об авторизованном пользователе:
- Редактирование информации авторизованного пользователя
- Получение информации об авторизованном приложении
- Информация о менеджере
- Информация по активным услугам API для платных методов

- Локализация

- Локализация для резюме

- Выбор сайта

Резюме
- Поиск резюме

- Сохраненные поиски резюме
- Список сохраненных поисков резюме

- Получение единичного сохраненного поиска резюме

- Создание нового сохраненного поиска резюме

- Обновление сохраненного поиска резюме

- Удаление сохраненного поиска резюме

- Передача сохраненного поиска резюме другому менеджеру

- Список сохраненных поисков резюме
- Просмотр резюме

- Работа с резюме для соискателя
- Работа с телефоном

- Список резюме авторизованного пользователя

- Просмотр резюме

- Создание и редактирование резюме

- Публикация и продление резюме

- Удаление резюме

- История просмотра резюме

- Информация о статусе резюме и готовности резюме к публикации

- Списки видимости резюме

- Работа с телефоном
- Артефакты (фото, портфолио)

- Поиск по вакансиям, похожим на резюме

- История откликов/приглашений по резюме

Вакансии
- Получение вакансий
- Поиск по вакансиям
- Кластеры

- Описание использованных параметров

- Кластеры
- Получение информации о вакансии

- Особенности работы с вакансиями для соискателя

- Поиск по вакансиям
- Поиск по вакансиям, похожим на вакансию

- Отобранные вакансии

- Скрытые вакансии

- Сохраненные поиски вакансий

- Работа с вакансиями
- Возможные варианты публикации вакансий

- Публикация вакансий

- Редактирование вакансий

- Продление вакансий

- Список опубликованных вакансий

- Архивация вакансий

- Список архивных вакансий

- Удаление вакансий

- Список удаленных вакансий

- Возможные варианты публикации вакансий
- Список улучшений для вакансии

- Статистика по вакансии

- Черновики вакансий
Соискатели
Работодатели/компании
- Поиск компаний

- Получение информации о компании

- Услуги работодателя

- Авторизация работодателя

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

- Брендированные шаблоны вакансий

Менеджеры работодателя
- Менеджеры
- Добавление менеджера

- Редактирование менеджера

- Удаление менеджера

- Справочник менеджеров работодателя

- Получение информации о менеджере

- Дневной лимит просмотра резюме для текущего менеджера

- Добавление менеджера
Переписка (отклики/приглашения)
- Переписка для соискателя
- Получение списка откликов

- Получение списка активных откликов

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

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

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

- Просмотр списка сообщений в отклике

- Отправка сообщений в отклике

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

- Получение списка откликов
- Резюме для отклика на указанную вакансию
- Список резюме, которыми можно откликнуться на указанную вакансию

- Резюме, сгруппированные по возможности отклика на данную вакансию

- Список резюме, которыми можно откликнуться на указанную вакансию
- Переписка для работодателя
- Модель работы, термины и процедуры

- Общее описание процесса работы с откликами/приглашениями

- Коллекции и работодательские состояния откликов/приглашений

- Список откликов/приглашений

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

- Работа с сообщениями по отклику/приглашению для работодателя

- Приглашение соискателя на вакансию

- Действия по отклику/приглашению (смена состояния)

- Статистика по работе с откликами

- Модель работы, термины и процедуры
- Тексты сообщений

- Инструменты оценки

Справочники
- Справочники в OpenAPI

- Регионы

- Специализации

- Станции метро в указанном городе

- Станции метро во всех городах

- Языки

- Отрасли компаний

- Учебные заведения
- Основная информация об учебных заведениях

- Факультеты учебных заведений

- Основная информация об учебных заведениях
- Справочники работодателя
- Адреса

- Типы и права менеджера

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

- Департаменты

- Тесты

- Регионы вакансий

- Брендированные шаблоны вакансий

- Адреса
- Ключевые навыки

- Прочие справочники

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

- Подсказки
- по названиям университетов

- по организациям

- по специализациям

- по ключевым навыкам

- по должностям резюме

- по регионам

- по ключевым словам поиска вакансий

- по названиям университетов
Банк данных заработных плат
- Отчёты Банка данных заработных плат
- Оценка заработной платы без прогнозов

- Оценка заработной платы без прогнозов
- Справочники Банка данных заработных плат
- Отрасли

- Уровни специалистов

- Профобласти и специализации

- Регионы и города

- Отрасли
Поддержка, обратная связь, новости
Общайтесь с нами через twitter @apihhru или через почту [email protected].
Если вы нашли баг в работе HeadHunter API или виджетах, загляните в issues, возможно, про него мы уже знаем и чиним. Если нет, лучше всего сообщить о нём там. Там же вы можете оставлять свои пожелания и предложения.
Если вы нашли проблему на одном из сайтов HeadHunter, напишите в поддержку по сайту или в сообщество поддержки.
За новостями вы можете следить по коммитам в этом репозитории. RSS.
Часто задаваемые вопросы собраны в FAQ.