hh-apilisted
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.
-