Search job vacancies on hh.ru by keywords, region, professional role, industry, metro, salary, experience, employment form, work format, date range and labels. Returns a compact paginated summary (pass raw:true for full JSON).

Get full vacancy details: description, requirements, key skills, contacts, employer info.

Find vacancies similar to a given one. Useful for expanding a candidate's job search.

Search candidate resumes by keywords, region, professional role, salary, experience. Requires an EMPLOYER OAuth token (HH_ACCESS_TOKEN) AND a paid hh.ru resume-database subscription — applicant/anonymous tokens get 403.

Get full resume details: experience, education, skills, contacts. Requires an EMPLOYER OAuth token + paid resume-database access.

Search companies/employers on hh.ru by name. Returns company info and open vacancy count.

Get detailed employer profile: description, industries, website, vacancy count.

List active vacancies for a specific employer.

Get the full tree of regions and cities as id — name lines (pass raw:true for nested JSON). Use to find area IDs for search filters.

Get the regions/cities subtree under one area id (e.g. 113=Russia) — lighter than the full /areas tree.

Get the tree of professional roles with IDs. Use to find role IDs for vacancy/resume search and salary stats.

Get the tree of company industries with IDs. Use to find industry IDs for the search_vacancies industry filter.

Get metro stations and lines with IDs for a city (city_id), or for all cities. Use to find metro IDs for the search_vacancies metro filter.

Get all reference dictionaries: currencies, employment types, schedules, experience levels, vacancy labels, and more.

Check whether HH_ACCESS_TOKEN is valid via /me and report the user role (applicant/employer). Use to diagnose resume-search access.

Autocomplete job titles / professional roles. Returns matching role suggestions for partial input.

Autocomplete company names. Returns matching employer suggestions for partial input.

Autocomplete region/city names. Returns matching area suggestions for partial input.

Estimate salary distribution (median, P25/P75, min/max) for a professional role in a region by sampling posted vacancy salaries client-side. Biased sample (only vacancies that disclose salary) — not official market data.