← ClaudeAtlas

hh-apilisted

Provides authentication flows, endpoint references, and workflow rules for the HeadHunter recruitment REST API (hh.ru / hh.uz / rabota.by and other group-company sites). Use when the user asks to integrate with hh.uz or hh.ru, call the HeadHunter API, work with OAuth tokens for HeadHunter, or read/write vacancies, resumes, negotiations (responses/invitations), employer managers, chats, or webhooks through that API.
uchkunr/skills · ★ 0 · AI & Automation · score 58
Install: claude install-skill uchkunr/skills
# Integrating the HeadHunter (hh.ru / hh.uz) API HeadHunter's API is a single REST service (`https://api.hh.ru`) that serves every site in the group — hh.ru, hh.uz, hh.kz, rabota.by, hh1.az, headhunter.ge, headhunter.kg — differentiated only by a `host` query parameter. This skill targets **hh.uz**, so pass `?host=hh.uz` on requests where site-specific data matters (locales, areas, currencies, dictionaries); it's optional elsewhere and defaults to `hh.ru`. The full spec is bundled at [openapi.yml](openapi.yml) (27k+ lines, Russian). **Don't read it in full.** Grep it for an `operationId:` named in the reference files below to get the exact parameters, request body, and response schema for one operation. ## Contents - [Request basics](#request-basics) - [Authentication](#authentication) - [Pagination](#pagination) - [Errors](#errors) - [Domain map](#domain-map) - [Typical integration flows](#typical-integration-flows) ## Request basics - Base URL: `https://api.hh.ru`. All data is JSON; all traffic is HTTPS. - **Every request must send a `User-Agent` header** naming your app and a contact email, e.g. `User-Agent: MyApp/1.0 (my-app-feedback@example.com)`. If your HTTP client can't set `User-Agent`, send `HH-User-Agent` instead with the same value — if you send both, only `HH-User-Agent` is honored. Omitting both returns `400 Bad Request`. - JSON request bodies: UTF-8 without escaping is preferred (`{"name": "Иванов Иван"}`); ASCII with `\uXXXX` escaping is also accepted. -