Рекрутеры теперь ищут кандидатов на HireHi. Добавь резюме — имя и контакты покажем только с твоего согласия Перейти в раздел

MCP и API

PROДоступно в подписке

HireHi в твоём коде через API

Подключи скрипт, n8n или свой сервис к вакансиям, резюме и откликам

59методов
2 000вакансий в сутки
14разрешений

первый запрос за минуту

1
Создай ключ

Отметь только нужные разрешения. Ключ покажем один раз — сразу сохрани его

2
Сохрани ключ в переменную окружения

Так ключ не попадёт в код и историю git

export HIREHI_API_KEY="hhk_…"
3
Отправь запрос

Пять свежих вакансий продакт-дизайнера

curl https://hirehi.ru/api/v1/jobs/search \
  -H "Authorization: Bearer $HIREHI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"filters": {"search": "product designer"}, "size": 5}'

методы

openapi.json

вакансии8

Возвращает значения фильтров: категории, грейды, форматы работы. Передай категорию — получишь её специализации.

Разрешение
Вакансии
categorystringнеобязательный
Категория. Значение из /jobs/filters
Запрос
curl https://hirehi.ru/api/v1/jobs/filters \
  -H "Authorization: Bearer $HIREHI_API_KEY"

Ищет вакансии по фильтрам сайта. Для следующей страницы повтори запрос с теми же фильтрами и cursor из ответа.

Разрешение
Вакансии
filtersobjectнеобязательный
Фильтры как на сайте. Значения — из /jobs/filters
sizeintegerнеобязательный
Сколько записей вернуть, до 20
cursorstringнеобязательный
next_cursor из прошлого ответа — для следующей страницы
Запрос
curl https://hirehi.ru/api/v1/jobs/search \
  -H "Authorization: Bearer $HIREHI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"filters": {"search": "product designer"}, "size": 5}'
Ответ 200
{
  "jobs": [],
  "next_cursor": null
}

Считает вакансии одним запросом: опубликованные за период или открытые сейчас. Можно уточнить компанию и фильтры. Без периода опубликованные считаются за последние 7 дней.

Разрешение
Вакансии
companystringнеобязательный
Название компании, например «Яндекс», или её адрес на HireHi
modestringнеобязательный
published — опубликованные за период, open — открытые сейчас
daysintegerнеобязательный
За сколько последних дней считать
date_fromstringнеобязательный
Первый день периода, ГГГГ-ММ-ДД
date_tostringнеобязательный
Последний день периода включительно, ГГГГ-ММ-ДД
filtersobjectнеобязательный
Фильтры как на сайте. Значения — из /jobs/filters
Запрос
curl https://hirehi.ru/api/v1/jobs/count \
  -H "Authorization: Bearer $HIREHI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"company": "Яндекс", "mode": "published", "days": 7}'
Ответ 200
{
  "mode": "open",
  "count": 0,
  "from_utc": null,
  "until_utc_exclusive": null
}

Возвращает полные тексты вакансий по их ID, до 5 за раз

Разрешение
Вакансии
idsarrayобязательный
ID вакансий, до 5
Запрос
curl https://hirehi.ru/api/v1/jobs/cards \
  -H "Authorization: Bearer $HIREHI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"ids": []}'
Ответ 200
{
  "jobs": [],
  "unavailable_ids": [
    12
  ]
}

Показывает, насколько вакансия подходит основному резюме. Если расчёт ещё идёт, в ответе будет task_id — повтори запрос с ним.

Разрешение
Мэтч и отклики
job_idintegerобязательный
ID вакансии
task_idstringнеобязательный
task_id из прошлого ответа, если расчёт ещё шёл
Запрос
curl https://hirehi.ru/api/v1/jobs/match \
  -H "Authorization: Bearer $HIREHI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"job_id": 1}'

Добавляет вакансию в избранное или скрывает её. Можно скрыть и всю компанию.

Разрешение
Избранное
job_idintegerобязательный
ID вакансии
markstringобязательный
favorite — в избранное, hidden — скрыть вакансию, hidden_company — скрыть компанию
enabledbooleanобязательный
true — поставить отметку, false — снять
Запрос
curl https://hirehi.ru/api/v1/jobs/marks \
  -H "Authorization: Bearer $HIREHI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"job_id": 1, "mark": "…", "enabled": true}'

Открывает контакт работодателя или ссылку для отклика. Тратит один контакт из остатка на сегодня.

Разрешение
Контакты
job_idintegerобязательный
ID вакансии
Запрос
curl https://hirehi.ru/api/v1/jobs/contact \
  -H "Authorization: Bearer $HIREHI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"job_id": 1}'

Возвращает сводку по рынку вакансий на HireHi

Разрешение
Вакансии
Запрос
curl -X POST https://hirehi.ru/api/v1/market/summary \
  -H "Authorization: Bearer $HIREHI_API_KEY"

ошибки

в ответе: {"error": "…"}
400Проверь параметры запроса
401Ключ не подходит или отозван
403Нет PRO или нужного разрешения у ключа
404Не найдено
409Данные уже изменились, запроси их заново
410Резюме уже удалено
413Запрос или файл слишком большой
422Не получилось разобрать данные
429Закончился остаток или запросы идут слишком часто
503HireHi временно недоступен, повтори позже
429 приходит в двух случаях. Закончился остаток на сегодня — он обновится в 03:00 мск. Запросы идут слишком часто — подожди столько секунд, сколько указано в Retry-After

вопросы

MCP подключает HireHi к ИИ-ассистенту: ты пишешь в чат, а ИИ сам вызывает нужные действия. API — для кода: скрипта, n8n или своего сервиса. Методы, разрешения и остаток на сутки у них общие.

Ключ видит только то, что отмечено при создании. Для поиска вакансий хватит «Вакансий», для мэтча и трекера нужны личные данные. Поменять разрешения нельзя: создай новый ключ и отзови старый.

Остаток общий для всех ключей и MCP и обновляется в 03:00 мск. Короткая выдача поиска тратит один запрос, полные карточки и контакты считаются отдельно. Сколько осталось — в GET /account.

Сохрани поиск через /saved-searches и подключи к нему вебхук. HireHi сам пришлёт новые вакансии на твой HTTPS-адрес. Каждый запрос подписан: проверь X-HireHi-Signature — это HMAC-SHA256 от X-HireHi-Timestamp, точки и тела запроса.

Да, но отправляешь всегда ты. /applications/prepare вернёт ссылку confirm_url: открой её, проверь письмо и отправь. Без подтверждения работодатель ничего не получит.

Отправь PDF или DOCX в поле file на /resumes/upload — HireHi создаст приватное резюме. Проверку запусти через /analysis/resume с уникальным request_id, а результат забери из /analysis/result тем же ключом.

Нет, открыть доступ можно только на сайте: там ты сам выбираешь, кто увидит резюме и какие контакты. /resumes/visibility покажет, кому резюме видно сейчас, и вернёт settings_url — ссылку на эти настройки. Скрыть резюме можно и через API, методом /resumes/hide.

Нажми «Заменить» — старый ключ сразу перестанет работать, а новый получит те же права. Или «Отозвать», если ключ больше не нужен.

Ключи сохранятся, но запросы будут возвращать 403. После продления они снова заработают без перенастройки.