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 для платных методов
- Локализация
- Локализация для резюме
- Выбор сайта
Webhook API
- Список уведомлений, на которые подписан пользователь
- Подписка на уведомления
- Удаление подписки
- Изменение подписки
Резюме
- Поиск резюме
- Сохраненные поиски резюме
- Просмотр резюме
- Работа с резюме для соискателя
- Работа с телефоном
- Список резюме авторизованного пользователя
- Просмотр резюме
- Создание резюме
- Редактирование резюме
- Публикация и продление резюме
- Клонирование резюме
- Удаление резюме
- Проверка возможности создания резюме
- История просмотра резюме
- Условия заполнения полей нового резюме
- Информация о статусе резюме и готовности резюме к публикации
- Списки видимости резюме
- Получение списков видимости
- Получение списка типов видимости резюме
- Добавление компаний в список видимости
- Удаление компаний из списка видимости
- Очистка списка видимости
- Поиск работодателей для добавления в список видимости
- Работа с телефоном
- Артефакты (фото, портфолио)
- Поиск по вакансиям, похожим на резюме
- История откликов/приглашений по резюме
Вакансии
- Получение вакансий
- Поиск по вакансиям, похожим на вакансию
- Отобранные вакансии
- Скрытые вакансии
- Скрытые работодатели
- Сохраненные поиски вакансий
- Работа с вакансиями
- Список улучшений для вакансии
- Статистика по вакансии
- Просмотры вакансии
- Черновики вакансий
Соискатели
Работодатели/компании
- Поиск компаний
- Получение информации о компании
- Услуги работодателя
- Авторизация работодателя
- Менеджеры работодателя
Менеджеры работодателя
Переписка (отклики/приглашения)
- Переписка для соискателя
- Резюме для отклика на указанную вакансию
- Переписка для работодателя
- Модель работы, термины и процедуры
- Общее описание процесса работы с откликами/приглашениями
- Коллекции и работодательские состояния откликов/приглашений
- Список откликов/приглашений
- Просмотр отклика/приглашения
- Работа с сообщениями по отклику/приглашению для работодателя
- Приглашение соискателя на вакансию
- Действия по отклику/приглашению (смена состояния)
- Отметить отклики прочитанными
- Статистика по работе с откликами
- Тексты сообщений
- Изменение шаблона ответа соискателю
- Модель работы, термины и процедуры
- Инструменты оценки
Справочники
- Справочники в OpenAPI
- Регионы
- Профессиональные роли
- Станции метро в указанном городе
- Станции метро во всех городах
- Языки
- Отрасли компаний
- Учебные заведения
- Справочники работодателя
- Ключевые навыки
- Прочие справочники
Подсказки (autosuggest, autocomplete)
Банк данных заработных плат
Поддержка, обратная связь, новости
Общайтесь с нами через twitter @apihhru или через почту api@hh.ru.
Если вы нашли баг в работе HeadHunter API или виджетах, загляните в issues, возможно, про него мы уже знаем и чиним. Если нет, лучше всего сообщить о нём там. Там же вы можете оставлять свои пожелания и предложения.
Если вы нашли проблему на одном из сайтов HeadHunter, напишите в поддержку по сайту или в сообщество поддержки.
За новостями вы можете следить по коммитам в этом репозитории. RSS.
Часто задаваемые вопросы собраны в FAQ.