# hh.ru Scraper - HeadHunter Jobs, Salaries & Skills (`haketa/hh-scraper`) Actor
Scrape job vacancies from hh.ru (HeadHunter) across Russia & CIS: title, company, salary, city, work format, experience, key skills, application counts and full description. Export to JSON, CSV or Excel.
- **URL**: https://apify.com/haketa/hh-scraper.md
- **Developed by:** [Haketa](https://apify.com/haketa) (community)
- **Categories:** Jobs, Lead generation
- **Features:** Limited permissions
- **Stats:** 12 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $1.75 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event
## What's an Apify Actor?
An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.
For examples already wired to this Actor's own input schema, see the [API](#api) section below.
Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).
# README
Extract structured job vacancies from hh.ru (HeadHunter) — as well as regional portals hh.kz (Kazakhstan) and hh.uz (Uzbekistan) — into clean, ready-to-analyze datasets. Capture job titles, structured salary ranges, company profiles, employer ratings, accredited IT status, work formats, applicant response counts, office coordinates, full job descriptions, and key skills with zero coding.
***
### ⚡ At a glance
| Feature | Details |
| :--- | :--- |
| 💼 **Supported Portals** | `hh.ru` (Russia), `hh.kz` (Kazakhstan), `hh.uz` (Uzbekistan), and regional HeadHunter domains |
| 💰 **Salary & Demand Data** | `salaryFrom`, `salaryTo`, `salaryCurrency`, `salaryGross`, `salaryPeriod`, `responsesCount` (total applicants), `onlineUsers` |
| 🏢 **Employer Intelligence** | `company`, `companyId`, `companyUrl`, `companyWebsite`, `employerRating`, `employerReviewsCount`, `accreditedItEmployer` |
| 🧠 **Detail Enrichment** | Optional full text `description`, structured `keySkills` array, and public recruiter contacts (`includeDescription: true`) |
| 📈 **Pagination & 1,000+ Scale** | High-density `items_on_page=100` pagination plus automatic experience-tier query splitting to scale past single-search limits |
| ⚡ **Speed & Efficiency** | **100 vacancies in ~5–10 seconds** (prefill); **1,000+ vacancies in ~30–60 seconds** in list mode |
| 📦 **Bulk Export Formats** | JSON, CSV, Excel (XLSX), XML, HTML Table, RSS, and direct REST API / Webhook integration |
***
### 🔎 Why scrape hh.ru (HeadHunter)?
**HeadHunter (`hh.ru`, `hh.kz`, `hh.uz`)** is the largest recruitment and labor-market platform across Russia, Kazakhstan, Uzbekistan, and the wider CIS region, hosting hundreds of thousands of active job listings across technology, finance, engineering, retail, logistics, and executive management.
Every listing on HeadHunter contains uniquely rich labor-market signals that go far beyond a standard job post:
- **Structured compensation bands** (`salaryFrom`, `salaryTo`, `salaryCurrency`, `salaryGross`)
- **Live applicant competition metrics** (`responsesCount` — how many candidates have already applied to the role)
- **Verified employer brand scores** (`employerRating`, `employerReviewsCount`, and state `accreditedItEmployer` status)
- **Precise office geolocation & transit data** (`metro` stations, `latitude`, `longitude`)
Collecting this data manually is slow and restricted by page limits. This **hh.ru scraper** turns any keyword list, regional filter, or custom search URL into a clean, deduplicated JSON/CSV/Excel dataset in seconds.
#### Key reasons teams use this hh.ru data extractor:
- 💵 **Compensation & salary benchmarking:** Analyze real-time salary ranges (`RUR`, `KZT`, `USD`, `EUR`) segmented by role, required experience (`noExperience`, `1-3 years`, `3-6 years`, `6+ years`), and city.
- 🎯 **B2B sales & hiring-signal lead generation:** Identify fast-growing companies (`companyWebsite`, `accreditedItEmployer`) actively expanding their engineering, sales, or operations teams.
- 🧠 **Skills-demand & curriculum analytics:** Enable `includeDescription: true` to extract tagged `keySkills` (e.g., `Python`, `FastAPI`, `Kubernetes`, `1C`, `SQL`) and measure technology adoption trends.
- 📊 **Job board aggregation & talent feeds:** Power regional job aggregators, Telegram job bots, career newsletters, and internal talent-sourcing dashboards via scheduled API runs.
- 🕵️ **Competitive intelligence:** Track competitor headcount expansion and measure candidate attraction velocity using `responsesCount`.
***
### ✨ What this hh.ru scraper does
- ✅ **Flexible dual input modes:** Pass any custom filtered **`startUrls`** from `hh.ru`, `hh.kz`, or `hh.uz`, or simply enter an array of **`keywords`** (e.g., `["python", "data analyst", "devops"]`) with an optional `area` code.
- ✅ **Unlocked 1,000+ pagination & query splitting:** Requests `100` vacancies per page and automatically expands broad queries across experience tiers (`noExperience`, `between1And3`, `between3And6`, `moreThan6`) when `maxItems > 1500` so runs scale cleanly past HeadHunter's single-search ceiling.
- ✅ **Smart empty-run fallback:** Running with an empty input `{}` automatically sweeps 10 popular job categories and returns a diverse sample of 100 active vacancies.
- ✅ **Complete employer profile metadata:** Extracts `company`, `companyId`, `companyUrl`, external `companyWebsite`, `companyLogo`, `employerRating` (out of 5.0), `employerReviewsCount`, and `accreditedItEmployer`.
- ✅ **Granular work format & schedule tags:** Captures `workSchedule` (`remote`, `fullDay`, `flexible`), `workFormats` (`REMOTE`, `HYBRID`, `ON_SITE`, `FIELD_WORK`), `experience`, and `employment` (`FULL`, `PART`, `PROJECT`).
- ✅ **Full geolocation & metro mapping:** Extracts `city`, numeric `areaId`, street `address`, nearest `metro` station names, and `latitude` / `longitude` coordinates.
- ✅ **Optional detail page enrichment (`includeDescription`):** Fetches each vacancy's detail page to append the clean plain-text `description`, the structured `keySkills` array, and any public `contactName`, `contactEmail`, and `contactPhones`.
- ✅ **Clean, compact output:** Automatically strips `null` or empty fields per record and deduplicates globally by vacancy `id`.
***
### 🎯 Use cases
| Team / Industry | How they use this hh.ru scraper |
| :--- | :--- |
| **Tech Recruiters & Sourcers** | Monitor companies hiring scarce roles, filter for remote-only positions (`onlyRemote: true`), and track employer websites. |
| **HR Analytics & Compensation Teams** | Benchmark market pay bands (`salaryFrom` / `salaryTo`) across Moscow (`area: "1"`), Saint Petersburg (`area: "2"`), Almaty (`area: "160"`), and Tashkent (`area: "2759"`). |
| **B2B Sales & Outbound Agencies** | Find state-accredited IT companies (`accreditedItEmployer: true`) with external `companyWebsite` URLs that are actively hiring. |
| **Job Boards & Telegram Channels** | Schedule hourly or daily runs to ingest fresh remote and specialist vacancies via the Apify Dataset API. |
| **Macroeconomic & Labor Researchers** | Track vacancy volumes, applicant-to-vacancy ratios (`responsesCount`), and remote work share over time. |
***
### 📥 Input configuration
All fields are optional. Use the visual form in the Apify Console or pass a JSON object via the API.
| Parameter | Type | Default / Prefill | Description |
| :--- | :--- | :--- | :--- |
| `startUrls` | `array
