Toolset vacancies
Vacancy search, similar and related vacancies.
4 tools. Mutations require an explicit confirm=true argument; Auth marks tools that need an hh.ru token.
| Tool | Operation | Auth | Confirm | Description |
|---|---|---|---|---|
get_vacancy |
GET /vacancies/{vacancy_id} |
– | – | Get full details of one vacancy by its numeric id, including salary, key skills, contacts and branded description. |
related_vacancies |
GET /vacancies/{vacancy_id}/related_vacancies |
– | – | Get other vacancies of the employer that published the given vacancy; supports frequent filters plus the nested advanced object for rare filters. |
search_vacancies |
GET /vacancies |
– | – | Search vacancies on hh.ru. Frequent filters (text, area, salary, currency, experience, employment, schedule, search_field, page, per_page, order_by and others) are top-level parameters. Rare or niche filters are grouped into the nested advanced object: pass only the fields you need, unset fields are not sent. Resolve ids first: dict_areas, dict_professional_roles, dict_industries, dict_metro. The response includes found, pages and clusters for pagination. |
similar_vacancies |
GET /vacancies/{vacancy_id}/similar_vacancies |
– | – | Get vacancies similar to the given vacancy id; supports the same frequent filters as search_vacancies plus the nested advanced object for rare filters. |