Toolset suggests
Search suggestions for areas, companies, skills and keywords.
11 tools. Mutations require an explicit confirm=true argument; Auth marks tools that need an hh.ru token.
| Tool | Operation | Auth | Confirm | Description |
|---|---|---|---|---|
suggest_area_leaves |
GET /suggests/area_leaves |
– | – | Suggest leaf regions (cities/districts without children) inside area_id by name prefix; used to pick concrete locations. |
suggest_areas |
GET /suggests/areas |
– | – | Suggest hh.ru regions (areas) by name prefix; returns matching areas with ids. area_id narrows the search to children of a given region, include_parent=true adds the parent region to the response. |
suggest_companies |
GET /suggests/companies |
– | – | Suggest registered employers (companies) by name prefix with their ids and urls. |
suggest_educational_institutions |
GET /suggests/educational_institutions |
– | – | Suggest educational institutions by name prefix with their ids. |
suggest_fields_of_study |
GET /suggests/fields_of_study |
– | – | Suggest fields of study (specialties) by name prefix with their ids for resume and vacancy education blocks. |
suggest_positions |
GET /suggests/positions |
– | – | Suggest job positions (titles) by name prefix for resumes; returns positions with professional role ids. |
suggest_professional_roles |
GET /suggests/professional_roles |
– | – | Suggest professional roles by name prefix with their ids for vacancy and resume search. |
suggest_resume_search_keyword |
GET /suggests/resume_search_keyword |
– | – | Suggest full search phrases for resume search by a partial keyword (employer side). |
suggest_skill_set |
GET /suggests/skill_set |
– | – | Suggest key skills by name prefix with their ids; skill ids are accepted by dict_skills. |
suggest_vacancy_positions |
GET /suggests/vacancy_positions |
– | – | Suggest job positions (titles) by name prefix for vacancies; returns positions with professional role ids. |
suggest_vacancy_search_keyword |
GET /suggests/vacancy_search_keyword |
– | – | Suggest full search phrases for vacancy search by a partial keyword (applicant side). |