Skip to content

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).