# hh.ru Jobs Scraper - HeadHunter Vacancies, Salaries & Employers (`topapi/hh-ru-jobs-scraper`) Actor

Scrape hh.ru (HeadHunter) vacancies in Russia, Kazakhstan, Belarus, Uzbekistan and more: every hh.ru filter, full description, key skills, salary, address, employer profile and website contacts, 2,000+ results per search, monitor mode. $0.71 per 1,000 vacancies.

- **URL**: https://apify.com/topapi/hh-ru-jobs-scraper.md
- **Developed by:** [Top Api](https://apify.com/topapi) (community)
- **Categories:** Jobs, Lead generation, Business
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.71 / 1,000 vacancies

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

### What does hh.ru Jobs Scraper do?

**hh.ru Jobs Scraper** extracts vacancies from [hh.ru](https://hh.ru) (HeadHunter), the largest job board in Russia and the CIS (about 900,000 open vacancies), and from its sister sites hh.kz, rabota.by, hh.uz, headhunter.kg, headhunter.ge and hh1.az. Each vacancy is one structured row: title, employer, salary range with gross / net and pay period, area, address with coordinates and metro stations, experience, employment form, work format, schedule, professional roles, key skills, the full description, dates and response counts. Search by keyword with every filter of hh.ru's own search form, or paste hh.ru search, catalog, employer or vacancy links, or vacancy ids. Recruiters, HR-tech and staffing companies, job boards, salary analysts and B2B sales teams use it to pull HeadHunter vacancies into a sheet, a database or an API call.

- 🔎 **Every hh.ru filter**: area, keyword fields, exclude words, professional roles and role groups, industries, employers, experience, employment form, work format, schedule, working hours, part-time options, education, salary from, "only with salary", published within, labels (no agencies, accredited IT, internship...), metro, driver licences, sort order
- 🌍 **Seven HeadHunter sites**: hh.ru, hh.kz, rabota.by, hh.uz, headhunter.kg, headhunter.ge, hh1.az; areas by id or by name (Москва, Moscow, Алматы, Kazan)
- 📈 **Past hh.ru's 2,000-result cap**: hh.ru lists at most 2,000 results per search; ask for more and the actor reads the search region by region (then by experience and employment form), every vacancy once
- 📄 **The full vacancy**: description (HTML, text, Markdown), key skills, valid-until date, languages, driver licences, snippets, response counts
- 💰 **Salary you can filter on**: `salaryFrom` / `salaryTo` / currency / gross or net / per month, shift or hour, and a conversion to USD, EUR or another currency at hh.ru's own rates
- 🏢 **Employer add-ons**: the employer's hh.ru profile (free) and emails, phones and social links from the employer's own website
- 🔔 **Monitor mode** for schedules: only vacancies you have not received, with Slack, Discord, Telegram, WhatsApp or webhook alerts
- 🔓 No login, no cookies, no API key

### What data can you get from hh.ru?

| | | |
|---|---|---|
| 💼 Title, vacancy id, URL, apply link | 🏢 Employer, logo, hh.ru employer page, website | ✅ Verified employer, accredited IT company, agency flag |
| ⭐ Employer rating and review count | 💰 Salary from / to, currency, gross or net | 🗓️ Pay period (month, shift, hour) and frequency |
| 📍 Area, region, country | 🗺️ Address, latitude, longitude | 🚇 Metro stations with line and colour |
| 🧭 Experience required | 📝 Employment form, work format, schedule | ⏱️ Working hours, days on / off, rotation (вахта) |
| 🛠️ Key skills | 🎯 Professional roles | 📄 Full description (HTML, text, Markdown) |
| ✂️ Requirement, responsibility and conditions snippets | 📅 Published, created, changed, valid until | 📨 Responses, all responses, viewers now |
| 🏷️ Tags and labels, premium listing flag | 🌐 Languages, driver licences, accessibility | 🔗 Links, emails and phones written in the description |
| ➕ Employer profile: industries, description, website, open vacancies, category | ➕ Company contacts: emails (with their kind), phones, Telegram / VK / LinkedIn | 🆕 New / updated / unchanged / removed, first seen, reposts |

### How to scrape hh.ru with hh.ru Jobs Scraper

1. [Create a free Apify account](https://console.apify.com/sign-up) (it comes with monthly free credit).
2. Open **hh.ru Jobs Scraper** and type one or more **Search keywords**, e.g. `python`, `бухгалтер`, `менеджер по продажам`.
3. Add **Areas** (`1` or `Москва` for Moscow, `113` for all of Russia, `160` or `Алматы`) and any **Filters** you need, or paste hh.ru links in **hh.ru URLs**.
4. Set **Max vacancies per search** and click **Start**.
5. Download the vacancies as JSON, CSV, Excel or HTML, or read them through the API.

### ⬇️ Input

Every field is optional. An empty form reads 100 vacancies from all of hh.ru in hh.ru's default order.

| Parameter | Type | Description |
|---|---|---|
| `searchQueries` | array | Keywords; each one runs its own search |
| `site` | string | `hh.ru` (default), `hh.kz`, `rabota.by`, `hh.uz`, `headhunter.kg`, `headhunter.ge`, `hh1.az` |
| `areas` | array | hh.ru area ids or names: `1` Moscow, `2` Saint Petersburg, `113` Russia, `40` Kazakhstan, `160` Almaty, `16` Belarus, `97` Uzbekistan; `Казань`, `Moscow`, `Новосибирская область` |
| `searchFields` | array | Where the keyword must appear: `name` (title), `company_name`, `description` |
| `excludedText` | string | Words that must not appear (hh.ru's own field) |
| `professionalRoles` / `roleCategories` | array | Role ids or names (`96`, `Программист, разработчик`) / whole role groups (`11` = IT) |
| `industries` | array | Industry ids or names (`7`, `7.540`) |
| `employerIds` | array | hh.ru employer ids: each employer's open vacancies |
| `experience` | array | `noExperience`, `between1And3`, `between3And6`, `moreThan6` |
| `employmentForm` | array | `FULL`, `PART`, `PROJECT`, `FLY_IN_FLY_OUT`, `SIDE_JOB` |
| `workFormats` | array | `ON_SITE`, `REMOTE`, `HYBRID`, `FIELD_WORK` |
| `workScheduleByDays` / `workingHours` | array | `FIVE_ON_TWO_OFF`, `TWO_ON_TWO_OFF`, `WEEKEND`... / `HOURS_4`, `HOURS_8`, `HOURS_12`, `FLEXIBLE`... |
| `partTime` | array | `employment_part`, `employment_project`, `temporary_job_true`, `from_four_to_six_hours_in_a_day`, `only_saturday_and_sunday`, `start_after_sixteen` |
| `schedule` / `employment` | array | hh.ru's older filters (`fullDay`, `shift`, `flexible`, `remote`, `flyInFlyOut` / `full`, `part`, `project`, `volunteer`, `probation`), still applied by the site |
| `education` | array | `not_required_or_not_specified`, `special_secondary`, `higher` |
| `labels` | array | `with_address`, `not_from_agency`, `accredited_it`, `low_performance` (under 10 responses), `internship`, `night_shifts`, `with_salary`, `accept_handicapped`, `accept_kids`, `accept_teens`, `accept_labor_contract` |
| `driverLicenses` / `metroStations` | array | Licence categories / hh.ru metro ids |
| `salary` / `currency` | integer / string | hh.ru's "salary from" filter and its currency |
| `onlyWithSalary` / `acceptTemporary` | boolean | Only vacancies with a salary / open to temporary work |
| `searchPeriod` | string | Published within `1`, `3`, `7` or `30` days (`0` = any time) |
| `sortBy` | string | `relevance`, `publication_time` (newest first), `salary_desc`, `salary_asc`, `distance` (with `latitude` / `longitude`) |
| `startUrls` | array | hh.ru search URLs, catalog pages (`/vacancies/programmist`), employer pages (`/employer/1740`), vacancy URLs; any HeadHunter site, regional hosts (spb.hh.ru) too |
| `vacancyIds` | array | Vacancy ids or URLs |
| `maxResults` / `maxTotalResults` / `maxPages` | integer | Vacancies per search (default 100; 0 = all) / a cap on the whole run / result pages per search (100 a page) |
| `splitLargeSearches` | boolean | Read searches over 2,000 results as narrower searches (default on; used only when you ask for more than 2,000) |
| `includeDetails` | boolean | Read each vacancy page (default on); off = the search card's fields only, much faster |
| `includeDescription` / `descriptionFormat` / `descriptionMaxLength` | | Description on / off, `all` / `text` / `html` / `markdown`, cut length |
| `includeEmployerProfile` | boolean | The employer's hh.ru profile (free) |
| `enrichEmails` | boolean | Emails, phones and socials from the employer's website (paid add-on) |
| `convertSalaryTo` | string | Add the salary converted to `USD`, `EUR`, `RUR`, `KZT`, `BYR` or `UZS` |
| `includeKeywords` / `excludeKeywords` / `excludeCompanies` / `companyNames` | array | Title must / must not contain; employers to drop / keep. hh.ru applies them in its own search (`NAME:(...)`, `COMPANY_NAME:(...)`; a word or a word start), so only matching pages are read; each card is checked again before anything is charged |
| `minCompanyRating` / `onlyAccreditedIt` / `onlyTrustedEmployers` / `excludeAgencies` / `salaryMax` | | Employer and salary filters hh.ru's form does not have, checked on each card (never charged). A search these filters empty almost completely stops after the pages it has read (the status line says so) |
| `sinceHours` / `postedAfter` / `postedBefore` | | Publication window |
| `latitude` / `longitude` / `radiusKm` | | Distance filter around a point |
| `maxItemsPerCompany` / `skipReposts` | | At most N vacancies per employer / skip the same employer + title + area under a new id |
| `monitorMode`, `monitorStoreName`, `firstRunMode`, `monitorIncludeUpdated`, `emitUnchanged`, `emitRemovedVacancies`, `resetMonitor` | | Only new vacancies on scheduled runs; see below |
| `webhookUrl`, `webhookHeaders`, `webhookSecret`, `slackWebhookUrl`, `discordWebhookUrl`, `telegramToken` + `telegramChatId`, `whatsappPhoneNumberId` + `whatsappAccessToken` + `whatsappTo`, `notificationLimit` | | Run alerts |
| `compact` / `excludeEmptyFields` / `fields` / `includeRawData` | | Main columns only / drop empty fields / keep only these fields / hh.ru's raw card |
| `includeRunSummary` / `maxConcurrency` / `proxyConfiguration` | | Always save RUN_SUMMARY / vacancy pages at once (default 8) / your own proxy (not needed) |

Filter values also accept plain words (`remote`, `full-time`, `1-3`, `newest`), and the input names of other hh.ru actors (`text`, `query`, `keywords`, `area`, `areaIds`, `location`, `city`, `results_wanted`, `maxItems`, `fetchDetails`, `monitoringMode`, `incrementalMode`, `stateKey`, `emitExpired`, `country`, `period`, `orderBy`...) are read too.

#### Input JSON

```json
{
  "searchQueries": ["python", "data engineer"],
  "areas": ["Москва", "Санкт-Петербург"],
  "experience": ["between1And3", "between3And6"],
  "workFormats": ["REMOTE", "HYBRID"],
  "onlyWithSalary": true,
  "searchPeriod": "7",
  "maxResults": 300,
  "includeEmployerProfile": true,
  "convertSalaryTo": "USD"
}
```

#### Paste an hh.ru link to reuse the filters you set on the site

Build a search on hh.ru, copy the address bar and put it in `startUrls`; the filters above are added to it. A catalog page (`https://hh.ru/vacancies/programmist`) returns its vacancies; an employer page (`https://hh.ru/employer/1740`) returns that employer's open vacancies; a vacancy URL returns that vacancy.

### ⬆️ Output

One row per vacancy. A real row from a run on 2026-11-06 (search `маркетолог` @ Saint Petersburg, both employer add-ons and the USD conversion on; long texts cut here):

```json
{
  "vacancyId": "139057892",
  "vacancyUrl": "https://hh.ru/vacancy/139057892",
  "site": "hh.ru",
  "title": "Графический дизайнер FITNESS HOUSE",
  "companyId": "113923",
  "companyName": "FITNESS HOUSE",
  "companyUrl": "https://hh.ru/employer/113923",
  "companyWebsite": "http://www.fitnesshouse.ru",
  "companyCategory": "COMPANY",
  "isAgency": false,
  "companyTrusted": true,
  "companyAccreditedIT": false,
  "companyRating": null,
  "companyReviewsCount": null,
  "logoUrl": "https://img.hhcdn.ru/employer-logo-original-round/2407892.jpeg",
  "salary": {
    "from": 85000,
    "to": 95000,
    "currency": "RUR",
    "gross": true,
    "mode": "MONTH",
    "frequency": null
  },
  "salaryFrom": 85000,
  "salaryTo": 95000,
  "salaryCurrency": "RUR",
  "salaryGross": true,
  "salaryMode": "MONTH",
  "salaryFrequency": null,
  "salaryText": "от 85 000 до 95 000 ₽ за месяц, до вычета налогов",
  "salaryFromConverted": 1039,
  "salaryToConverted": 1161,
  "salaryConvertedCurrency": "USD",
  "areaId": 2,
  "areaName": "Санкт-Петербург",
  "regionName": "Санкт-Петербург",
  "countryCode": "RU",
  "address": {
    "displayName": "Санкт-Петербург, Песочная набережная, 40",
    "city": "Санкт-Петербург",
    "street": "Песочная набережная",
    "building": "40",
    "district": null
  },
  "coordinates": {
    "latitude": 59.967664,
    "longitude": 30.285415
  },
  "metroStations": [
    {
      "name": "Крестовский остров",
      "line": "Фрунзенско-Приморская",
      "lineColor": "#702785"
    },
    {
      "name": "Петроградская",
      "line": "Московско-Петроградская",
      "lineColor": "#0078C9"
    },
    {
      "name": "Спортивная",
      "line": "Фрунзенско-Приморская",
      "lineColor": "#702785"
    },
    {
      "name": "Чкаловская",
      "line": "Фрунзенско-Приморская",
      "lineColor": "#702785"
    }
  ],
  "experience": "between1And3",
  "employmentForm": "FULL",
  "schedule": "fullDay",
  "workFormats": [
    "ON_SITE"
  ],
  "workSchedule": [
    "FIVE_ON_TWO_OFF"
  ],
  "workingHours": [
    "HOURS_8"
  ],
  "isRemote": false,
  "professionalRoleIds": [
    34
  ],
  "professionalRoles": [
    "Дизайнер, художник"
  ],
  "keySkills": [
    "Графический дизайн"
  ],
  "descriptionText": "FITNESS HOUSE – федеральная сеть спортивных клубов и лидер фитнес - индустрии в РФ.\n\nМы делаем фитнес доступным и удобным: клубы рядом с домом и работой, полная инфраструктура, мно...",
  "requirementSnippet": "Опыт работы дизайнером не менее 2-х лет. Высшее профильное образование (художественное‚ художественное-графическое). Отл...",
  "responsibilitySnippet": "Создание дизайн макетов для различных рекламных носителей (полиграфия‚ интерьерная реклама‚ наружная реклама, сувенирная...",
  "conditionsSnippet": "Формат: ОФИС, оформление по ТК РФ. График: 5/2 пн-пт (с 10:00 до 19:00). Оплата: 80000-95000 (обсуждается...",
  "publishedAt": "2026-11-02T11:14:44.48+03:00",
  "validThrough": "2026-12-02T11:14:44.48+03:00",
  "responsesCount": 13,
  "totalResponsesCount": 324,
  "publicationType": "standard",
  "isPromoted": false,
  "tags": [
    "Опыт 1-3 года"
  ],
  "labels": [],
  "applyUrl": "https://hh.ru/applicant/vacancy_response?vacancyId=139057892",
  "employerProfile": {
    "id": "113923",
    "name": "FITNESS HOUSE",
    "category": "company",
    "sizeCategory": null,
    "area": "Санкт-Петербург",
    "website": "http://www.fitnesshouse.ru",
    "industries": [
      "Услуги для населения",
      "Спортивные и фитнес-клубы"
    ],
    "industryIds": [
      "49",
      "49.410"
    ],
    "trusted": true,
    "accreditedIT": false,
    "identifiedByEsia": false,
    "countryCode": "RU",
    "hrBrand": null,
    "badges": [],
    "hasDivisions": false,
    "openVacancies": null,
    "description": "FITNESS HOUSE – федеральная сеть спортивных клубов и лидер фитнес - индустрии в РФ.\n\nМЫ -надежный работодатель и узнавае..."
  },
  "companyContacts": {
    "website": "http://www.fitnesshouse.ru",
    "contactEmail": "help@fhclub.ru",
    "contactEmailKind": "support",
    "contactEmailDomain": "fhclub.ru",
    "emails": [
      "help@fhclub.ru"
    ],
    "emailSources": [
      "https://www.fitnesshouse.ru/"
    ],
    "phones": [
      "+78126100606"
    ],
    "socials": {
      "telegram": "https://t.me/FHclub",
      "vk": "https://vk.com/fitnesshous",
      "dzen": "https://dzen.ru/fitnesshous"
    },
    "pagesFetched": 1,
    "ownDomain": false,
    "error": null,
    "status": "email found"
  },
  "searchQuery": "маркетолог",
  "searchArea": "Санкт-Петербург",
  "searchTotal": 452,
  "position": 1,
  "detailsFetched": true,
  "scrapedAt": "2026-11-06T12:32:20.917Z"
}
```

#### Fields

Fill rates are measured on 1,100 vacancies read with their vacancy pages (`менеджер по продажам`, all of Russia) and on 10,000 card rows (`водитель` and `продавец`, all of Russia, split by region). A field is `null` (or `[]`) when hh.ru does not carry it for that vacancy, never a made-up zero.

| Field | Filled | What it is |
|---|---:|---|
| `vacancyId`, `vacancyUrl`, `title`, `companyId`, `companyName`, `companyUrl`, `areaName`, `regionName`, `countryCode`, `publishedAt`, `applyUrl` | 100% | Core fields |
| `experience`, `employmentForm`, `schedule`, `workSchedule`, `workingHours`, `professionalRoles`, `tags` | 100% | Terms as hh.ru codes them |
| `workFormats`, `isRemote` | 95-97% / 100% | On site, remote, hybrid, field work |
| `salary`, `salaryFrom`, `salaryCurrency`, `salaryGross`, `salaryMode`, `salaryText` | 90-95% here; 22% for `python` in Moscow | Sales and blue-collar vacancies state pay far more often than IT |
| `salaryTo` / `salaryFrequency` | 48-61% / 67% | Upper end of the range / how often it is paid |
| `companyCategory`, `isAgency`, `companyTrusted`, `companyAccreditedIT`, `isPromoted`, `publicationType` | 100% | Employer type and listing package |
| `companyWebsite` / `logoUrl` | 73-79% / 86-89% | As the employer gives them on hh.ru |
| `companyRating`, `companyReviewsCount` | 59-60% | hh.ru employee-review rating; shown on hh.ru only (empty on the sister sites) |
| `address`, `coordinates` | 65-87% | When the employer gives an address |
| `metroStations` | 35-62% | Cities with a metro |
| `requirementSnippet`, `responsibilitySnippet`, `conditionsSnippet` | 95-100% | hh.ru's short excerpts from the search card |
| `responsesCount`, `totalResponsesCount` | 100% | Applications so far |
| `labels` | 68-83% | Откликнитесь среди первых, Можно без резюме... |
| `description`, `descriptionText`, `descriptionMarkdown`, `validThrough`, `archived` | 100% of rows with the vacancy page | Full description and the vacancy page's dates |
| `keySkills` | 68% of rows with the vacancy page | Employers list key skills on two thirds of vacancies |
| `partTimeOptions` / `civilLawContracts` / `flyInFlyOutDurations` | 9-16% / 20-22% / 18% of driver vacancies | Only vacancies that offer them |
| `driverLicenseTypes`, `languages`, `inclusivenessTypes` | 1-37% / rare / 5% | Only vacancies that ask for them |
| `companyDepartment` / `hrBrand` | 7-13% / 12-20% | Divisions of large employers / HR Brand award winners |
| `contactInfo` | 0% | hh.ru shows vacancy contacts only after a click to signed-in users |
| `employerProfile` | 100% with the add-on (description 90-96%, website 75-80%, industries 64-77%, open vacancies 100%) | The employer's hh.ru page |
| `companyContacts` | every row with the add-on; an email for 27% of employers (33 of 123 in four runs; 14 of 28 when vacancy pages were off), phones 26%, social links 28% | From the employer's own website; `status` says why there is none (no website on hh.ru, no email on it, or the site did not answer: timeouts, refusals, certificates Node does not trust) |
| `salaryFromConverted`, `salaryToConverted` | with `convertSalaryTo` | At hh.ru's own exchange rates |
| `changeType`, `firstSeen`, `lastSeen`, `isRepost`, `repostOfId` | monitor mode / reposts | new / updated / unchanged / removed / details (delivered before without the vacancy page, contacts or profile this run asks for, now with them) |

hh.ru removes contact details and links from vacancy descriptions (2 of 1,100 descriptions held a Telegram handle, none an email or a phone), so rows carry no contact fields from the text; turn on **Company contacts** for the employer's own website.

### How can I use hh.ru data?

- **Recruitment and staffing sales:** list every employer hiring a role in a region this week, with its website, rating and contacts.
- **Salary benchmarking:** posted ranges with gross / net and pay period per role, city, experience and work format, converted to one currency.
- **Job boards and aggregators:** feed HeadHunter vacancies with full descriptions into your site, deduplicated by `vacancyId`, reposts flagged.
- **Labour-market analysis:** count vacancies by role, skill, region, work format or employer over time.
- **Skills research:** the `keySkills` employers ask for, per role and region.

### How much does it cost to scrape hh.ru?

hh.ru Jobs Scraper is pay-per-result: **$0.71 per 1,000 vacancies**, with the vacancy page and every field in each row. No start fee. Vacancies closed before they could be read, vacancies removed by your filters, reposts you chose to skip and vacancies already delivered in monitor mode are never charged.

| Vacancies | Price |
|---:|---:|
| 100 | $0.071 |
| 1,000 | $0.71 |
| 10,000 | $7.10 |

| Add-on | Price |
|---|---|
| Company contacts from the employer's website (`company-contacts`) | $0.0072 per employer whose website gave at least one email; nothing for an employer without a website or without an email on it |
| Employer profile from hh.ru | free |
| Salary conversion | free |

Apify platform usage is included in these prices. Set a **maximum cost per run** in the run options and the run stops cleanly at it, without reading vacancies it cannot pay for.

### Run it on a schedule: only new vacancies

Turn on **Monitor mode** and schedule the actor (hourly, daily) from the **Schedules** tab. The actor remembers every vacancy it delivered in a named key-value store (`monitorStoreName`), reads each search newest first and stops at the first page it has already seen, so a run with nothing new reads one page and charges nothing. `firstRunMode: "seedOnly"` makes the first run only remember the current vacancies; `monitorIncludeUpdated` also returns vacancies whose salary, title, terms or description changed; `emitRemovedVacancies` adds a row for each remembered vacancy that left the search (with `maxResults: 0`, so each search is read to its end). Add a webhook, Slack, Discord, Telegram or WhatsApp destination to get the new vacancies as a message.

```json
{
  "searchQueries": ["бухгалтер"],
  "areas": ["Екатеринбург"],
  "monitorMode": true,
  "monitorStoreName": "buh-ekb",
  "skipReposts": true,
  "maxResults": 100,
  "telegramToken": "123456:ABC...",
  "telegramChatId": "-1001234567890"
}
```

### Integrations, API & MCP

- **No-code:** Make, Zapier, n8n, Google Sheets, Airtable, Notion via [Apify integrations](https://docs.apify.com/integrations).
- **API:** call it from Node.js or Python with `apify-client`; code on the [API tab](https://apify.com/topapi/hh-ru-jobs-scraper/api/python) and the [Apify API reference](https://docs.apify.com/api/v2).
- **MCP / AI agents:** connect Claude, Cursor or any MCP client through the [MCP tab](https://apify.com/topapi/hh-ru-jobs-scraper/api/mcp) and ask for hh.ru vacancies in plain language; **Compact rows** keeps the answers small.

### More TopApi scrapers

<table>
<tr>
<td>🗺️ <a href="https://apify.com/topapi/yandex-maps-scraper">Yandex Maps Scraper</a>: businesses with phones and websites in Russia and the CIS</td>
<td>🛒 <a href="https://apify.com/topapi/avito-scraper">Avito Scraper</a>: listings from Russia's largest classifieds site</td>
<td>💼 <a href="https://apify.com/topapi/indeed-jobs-scraper">Indeed Jobs Scraper</a>: jobs from Indeed's country sites</td>
</tr>
<tr>
<td>🇩🇪 <a href="https://apify.com/topapi/xing-jobs-scraper">XING Jobs Scraper</a>: jobs in Germany, Austria and Switzerland</td>
<td>🌍 <a href="https://apify.com/topapi/naukrigulf-jobs-scraper">Naukrigulf Jobs Scraper</a>: jobs, salaries and recruiters in the Gulf</td>
<td>🧭 <a href="https://apify.com/topapi">All TopApi actors</a></td>
</tr>
</table>

### Limits & empty runs

- **Depth:** hh.ru lists at most 2,000 results per search (20 pages of 100). With **Split searches over 2,000 results** on (default), a larger search is read region by region, city by city, then by experience and employment form: two runs read 5,000 `водитель` and 5,000 `продавец` vacancies across Russia that way in 7-9 minutes each (card rows), every vacancy once.
- **Vacancy pages are paced:** hh.ru limits how many vacancy pages one address may open (about 70 in a quick burst, then it asks for a CAPTCHA). The actor reads 30 at once, then 0.6 a second, which held for 1,100 pages in our runs: **20 vacancies with their pages in about 6 seconds, 100 in about a minute, 1,000 in about 30 minutes.** Card rows (Read each vacancy page off) are fast: 1,100 in about 40 seconds. Runs that share an address share its budget; when hh.ru still asks for a CAPTCHA, the actor moves once to an Apify datacenter address, and if that one is asked too, the remaining rows carry the search card's fields (`detailsFetched` false, the status line says how many). Rows are never held back waiting.
- **Filters hh.ru does not have:** employer rating, accredited IT, verified employers, agencies, salary at most, distance and the per-employer cap are checked on each card the actor reads. When they drop nearly every card, the search stops after the pages already read instead of reading 20 pages for a handful of rows (in our test, a rating 4.9 + accredited IT filter read one page of 100 cards, kept none and cost $0.00009; a rating 4.0 filter kept 150 of 391 cards and read on). Put a keyword, area, role or title word in the search so hh.ru does the narrowing.
- **Closed vacancies:** a vacancy can close between the search and its page; it is reported in the run summary and not charged. A few vacancies in a thousand open an employer landing page instead of a vacancy page; its row carries the card's fields.
- **Not available:** vacancy contacts (shown to signed-in users after a click), résumés (an employer account), employer ratings on the sister sites' search pages, and live viewer counts (hh.ru no longer shows them on search pages).
- **Empty dataset:** no vacancy matches the keyword, areas and filters (the status line says so), a place name was not recognised, your extra filters removed every vacancy, or in monitor mode nothing is new. Nothing is charged for an empty run.

### FAQ

#### How many vacancies can hh.ru Jobs Scraper collect in one run?

As many as the searches hold. hh.ru itself lists at most 2,000 results per search (20 pages of 100); when you ask for more, the actor reads the search region by region and city by city, then by experience and employment form, so the rest is reached too. In our tests one run delivered 5,000 `водитель` vacancies from all of Russia (95,725 on hh.ru) as card rows in 9 minutes, and 1,100 with every vacancy page in 30 minutes.

#### Can hh.ru Jobs Scraper filter like the hh.ru website?

Yes. Every filter of hh.ru's search form is an input, and hh.ru applies them before the pages are read, so a filtered run only reads matching vacancies. Filters the site does not have (employer rating, accredited IT, agencies, salary at most, title words, distance) are applied before anything is charged.

#### Does hh.ru Jobs Scraper return the full job description?

Yes, from each vacancy's own page: HTML, text and Markdown, plus key skills, valid-until date, languages and driver licences. Turn off **Read each vacancy page** for a faster card-only list (title, employer, salary, place, schedule, roles and hh.ru's requirement / responsibility snippets).

#### Does it work for hh.kz, rabota.by, hh.uz and the other HeadHunter sites?

Yes. Pick the **Site** and use the country's areas (`40` Kazakhstan, `160` Almaty, `16` Belarus, `1002` Minsk, `97` Uzbekistan, `2759` Tashkent); pasted links from any HeadHunter site work too. The sister sites do not show employer ratings on their search pages, so `companyRating` is filled on hh.ru only.

#### Can I get the recruiter's phone or email?

hh.ru shows vacancy contacts only after a click to signed-in users, so they are not in the public page (`contactInfo` is filled only when a vacancy publishes them openly). Turn on **Company contacts** to read emails, phones and social links from the employer's own website instead.

#### Can I run hh.ru Jobs Scraper on a schedule to get only new vacancies?

Yes: turn on **Monitor mode** and add a schedule. Each run returns only vacancies it has not delivered before; an empty run charges nothing.

#### Can I use hh.ru Jobs Scraper with the Apify API or an MCP server?

Yes. Start runs and read datasets with `apify-client` for Node.js or Python, or connect an MCP client through the MCP tab. Input names of other hh.ru actors are accepted.

#### Do I need an hh.ru account, cookies or an API key?

No. The actor reads what hh.ru shows to every visitor.

#### Why did my hh.ru Jobs Scraper run return no results?

The keyword, areas and filters together matched nothing (the status line names the search), a place name was not recognised (the status line says so and nothing is searched), your extra filters removed every vacancy, the vacancy ids were removed from hh.ru, or in monitor mode nothing is new since the last run. The `RUN_SUMMARY` record gives the count for each search.

#### How is hh.ru Jobs Scraper different from other hh.ru scrapers?

It reads hh.ru's own page data over plain HTTP at 256 MB (no browser), exposes every hh.ru filter and seven HeadHunter sites, reaches past the 2,000-results-per-search cap, resolves place, role and industry names, adds the employer profile, website contacts and salary conversion, and has a monitor mode with alerts, at $0.71 per 1,000 vacancies with no start fee.

#### Your feedback

We keep improving hh.ru Jobs Scraper. Found a bug or missing a field? Open an issue on the [Issues tab](https://apify.com/topapi/hh-ru-jobs-scraper/issues/open).

# Actor input Schema

## `searchQueries` (type: `array`):

Job titles or keywords as you would type them on hh.ru (Russian or English), e.g. python, бухгалтер, менеджер по продажам. Each keyword runs its own search. Leave empty to read only the URLs or ids below; leave everything empty to read 100 vacancies.

## `site` (type: `string`):

Which HeadHunter site the vacancy links and employer links point to. All of them search the same vacancies; the area decides the country.

## `areas` (type: `array`):

hh.ru area ids or names: 1 = Moscow, 2 = Saint Petersburg, 113 = Russia, 40 = Kazakhstan, 160 = Almaty, 16 = Belarus, 97 = Uzbekistan; or names as hh.ru writes them (Казань, Новосибирская область, Алматы) or in English (Moscow, Kazan). All areas go into one search. Leave empty for every area.

## `searchFields` (type: `array`):

Where the keyword must appear. Empty = everywhere (title, company name and description), as on hh.ru.

## `excludedText` (type: `string`):

Words that must not appear in the vacancy (hh.ru's own "exclude words" field), e.g. senior стажер.

## `professionalRoles` (type: `array`):

hh.ru professional role ids or names, e.g. 96 (Программист, разработчик), 156 (BI-аналитик, аналитик данных), 70 (Менеджер по продажам). The full list: https://api.hh.ru/professional_roles

## `roleCategories` (type: `array`):

Whole groups of roles by group id, e.g. 11 = Информационные технологии, 1 = Продажи, обслуживание клиентов, 3 = Финансы, бухгалтерия, 10 = Транспорт, логистика.

## `industries` (type: `array`):

Employer industry ids or names, e.g. 7 (Информационные технологии, системная интеграция, интернет) or 7.540 (Разработка программного обеспечения). The full list: https://api.hh.ru/industries

## `employerIds` (type: `array`):

hh.ru employer ids (the number in hh.ru/employer/<id>), e.g. 1740 = Яндекс, 3529 = Сбер. Each employer's open vacancies are read (with the filters below).

## `experience` (type: `array`):

Required work experience.

## `employmentForm` (type: `array`):

Full time, part time, project, rotation (вахта) or side job.

## `workFormats` (type: `array`):

On site, remote, hybrid or field work.

## `workScheduleByDays` (type: `array`):

Days on / days off: 5/2, 2/2, 6/1, weekends only, flexible...

## `workingHours` (type: `array`):

Hours per working day.

## `partTime` (type: `array`):

hh.ru's part-time checkboxes.

## `schedule` (type: `array`):

hh.ru's previous schedule filter, still applied by the site: full day, shift, flexible, remote, rotation.

## `employment` (type: `array`):

hh.ru's previous employment filter, still applied by the site.

## `education` (type: `array`):

Required education.

## `labels` (type: `array`):

hh.ru's extra filters: with address, no agencies, accredited IT companies, fewer than 10 responses, internship, evening / night shifts, salary stated, accessible, from 14 / 16 years, labour contract.

## `driverLicenses` (type: `array`):

Vacancies that ask for these driver licence categories.

## `metroStations` (type: `array`):

hh.ru metro station or line ids (e.g. 1.128 for a Moscow station). The list for a city: https://api.hh.ru/metro/1

## `salary` (type: `integer`):

hh.ru's salary filter: vacancies whose range reaches this amount (in the currency below; the site's own currency if empty).

## `currency` (type: `string`):

Currency of the salary filter.

## `onlyWithSalary` (type: `boolean`):

Skip vacancies that do not state pay.

## `acceptTemporary` (type: `boolean`):

Only vacancies open to temporary employment.

## `searchPeriod` (type: `string`):

Only vacancies published in the last day, 3 days, week or month.

## `sortBy` (type: `string`):

Order of the results. Monitor mode always reads the newest first.

## `startUrls` (type: `array`):

hh.ru pages (any HeadHunter site, regional hosts like spb.hh.ru too): a search (/search/vacancy?text=...\&area=...), a catalog page (/vacancies/programmist), an employer (/employer/<id>: its open vacancies) or a vacancy (/vacancy/<id>). Filters above are added to pasted searches.

## `vacancyIds` (type: `array`):

hh.ru vacancy ids (the number in hh.ru/vacancy/<id>) or vacancy URLs. Each returns its full vacancy; a removed vacancy is reported in the run summary and not charged.

## `maxResults` (type: `integer`):

Vacancies to deliver per keyword search, URL or employer. 0 = all of them. hh.ru lists 2,000 results per search; above that the search is split by region (see below).

## `maxTotalResults` (type: `integer`):

A cap on the whole run, over all searches. 0 = no run cap.

## `maxPages` (type: `integer`):

Stop each search after this many result pages (100 vacancies a page). 0 = no page cap.

## `splitLargeSearches` (type: `boolean`):

hh.ru lists at most 2,000 results per search. When you ask for more, a larger search is read as narrower searches (by region, then city, then experience and employment form), so every vacancy can be reached. Vacancies are delivered once.

## `includeDetails` (type: `boolean`):

Adds the full description, key skills, valid-until date, languages and driver licences from the vacancy page. Off = the search card only (title, employer, salary, place, schedule, snippets), faster.

## `includeDescription` (type: `boolean`):

Off = the description fields stay empty (smaller rows).

## `descriptionFormat` (type: `string`):

Which description fields to fill: HTML (description), plain text (descriptionText), Markdown (descriptionMarkdown), or all three.

## `descriptionMaxLength` (type: `integer`):

Cut descriptions to this many characters. 0 = no cut.

## `includeEmployerProfile` (type: `boolean`):

Adds the employer's hh.ru profile to each row (employerProfile): industries, description, website, open vacancies, category, IT accreditation, HR brand. Read once per employer per run.

## `enrichEmails` (type: `boolean`):

Reads the website the employer gives on hh.ru (home page + contact / about pages) for emails, phones and social profiles (companyContacts). Charged once per employer whose website gave at least one email.

## `convertSalaryTo` (type: `string`):

Adds salaryFromConverted / salaryToConverted in this currency, at the exchange rates hh.ru states on its search page.

## `includeRawData` (type: `boolean`):

Adds hh.ru's own search-card object (raw) to each row.

## `compact` (type: `boolean`):

Only the main columns: id, URL, title, employer, area, salary, experience, employment form, work format, published date.

## `excludeEmptyFields` (type: `boolean`):

Leave out fields that are empty on a row.

## `fields` (type: `array`):

Keep only these output fields (e.g. vacancyId, title, companyName, salaryFrom, salaryTo, keySkills).

## `includeKeywords` (type: `array`):

Keep a vacancy only when its title contains one of these words. hh.ru applies it in its own search (a word or the start of a word: dev finds Developer), so only matching pages are read; each card is checked again before anything is charged.

## `excludeKeywords` (type: `array`):

Drop a vacancy whose title contains one of these words (applied by hh.ru's search, then checked on each card).

## `excludeCompanies` (type: `array`):

Drop vacancies of employers whose name contains one of these (applied by hh.ru's search, then checked on each card).

## `companyNames` (type: `array`):

Keep only vacancies of employers whose name contains one of these (applied by hh.ru's search, then checked on each card).

## `minCompanyRating` (type: `number`):

Keep only employers with at least this hh.ru review rating (1-5). Employers without reviews are dropped when this is set.

## `onlyAccreditedIt` (type: `boolean`):

Keep only employers marked as accredited IT companies.

## `onlyTrustedEmployers` (type: `boolean`):

Keep only employers hh.ru has verified.

## `excludeAgencies` (type: `boolean`):

Drop vacancies posted by recruitment agencies, private recruiters, private individuals and the self-employed.

## `salaryMax` (type: `integer`):

Keep only vacancies whose salary starts at or below this amount (vacancies without a salary are dropped when this is set).

## `sinceHours` (type: `integer`):

Keep only vacancies published in the last N hours.

## `postedAfter` (type: `string`):

Keep only vacancies published on or after this date (YYYY-MM-DD).

## `postedBefore` (type: `string`):

Keep only vacancies published on or before this date (YYYY-MM-DD).

## `latitude` (type: `number`):

A point to measure distance from (for Radius and for Sort by distance).

## `longitude` (type: `number`):

A point to measure distance from.

## `radiusKm` (type: `integer`):

Keep only vacancies whose address lies within this distance of the point above (vacancies without an address are dropped when this is set).

## `maxItemsPerCompany` (type: `integer`):

At most this many vacancies of one employer in the run. 0 = no limit.

## `skipReposts` (type: `boolean`):

Skip a vacancy that repeats one already delivered (same employer, same title, same area) under a new id. Off = it is delivered and flagged isRepost.

## `monitorMode` (type: `boolean`):

Run on a schedule and get only vacancies not delivered by earlier runs of the same searches. Reads the newest first and stops at the first page it already knows. A vacancy delivered earlier without the vacancy page details, employer contacts or employer profile that a later run turns on comes again once with them, as changeType details (billed like any vacancy).

## `monitorStoreName` (type: `string`):

Name of the key-value store that remembers delivered vacancies. Use a different name for each independent feed.

## `firstRunMode` (type: `string`):

emitAll = the first run delivers the current vacancies; seedOnly = it only remembers them (nothing charged) and later runs deliver what is new.

## `resetMonitor` (type: `boolean`):

Forget every delivered vacancy and start the feed again.

## `monitorIncludeUpdated` (type: `boolean`):

Deliver a known vacancy again when its title, salary, employer, area or description changed (changeType updated).

## `emitUnchanged` (type: `boolean`):

Deliver every vacancy found, marked new, updated or unchanged.

## `emitRemovedVacancies` (type: `boolean`):

When every search was read to its end, deliver a row (changeType removed) for each remembered vacancy that is no longer listed.

## `webhookUrl` (type: `string`):

POSTs { total, items } of the run's new vacancies to this URL after the run.

## `webhookHeaders` (type: `object`):

Extra headers for the webhook, e.g. {"Authorization": "Bearer ..."}.

## `webhookSecret` (type: `string`):

Sent as the x-webhook-secret header.

## `slackWebhookUrl` (type: `string`):

Posts a summary with the first vacancies to Slack.

## `discordWebhookUrl` (type: `string`):

Posts a summary to Discord.

## `telegramToken` (type: `string`):

With the chat id below: sends a summary to Telegram.

## `telegramChatId` (type: `string`):

Chat or channel id for the Telegram summary.

## `whatsappPhoneNumberId` (type: `string`):

WhatsApp Cloud API sender id (with the token and recipient below).

## `whatsappAccessToken` (type: `string`):

WhatsApp Cloud API access token.

## `whatsappTo` (type: `string`):

Recipient phone number for the WhatsApp summary.

## `notificationLimit` (type: `integer`):

How many vacancies an alert lists (0-50).

## `maxConcurrency` (type: `integer`):

Vacancy pages read at once. hh.ru limits how many vacancy pages one address may open, so the actor paces itself whatever this is.

## `includeRunSummary` (type: `boolean`):

Save RUN_SUMMARY (per-search counts, filters, egress) to the run's key-value store on every run. Off = it is saved for Console runs, runs of 200+ rows and runs with a problem.

## `proxyConfiguration` (type: `object`):

Not needed: hh.ru answers direct, and the actor moves to an Apify datacenter proxy by itself when hh.ru refuses an address. Set your own proxy here to use it first.

## Actor input object example

```json
{
  "searchQueries": [
    "python"
  ],
  "site": "hh.ru",
  "areas": [
    "1"
  ],
  "onlyWithSalary": false,
  "acceptTemporary": false,
  "searchPeriod": "0",
  "sortBy": "relevance",
  "maxResults": 20,
  "splitLargeSearches": true,
  "includeDetails": true,
  "includeDescription": true,
  "descriptionFormat": "all",
  "includeEmployerProfile": false,
  "enrichEmails": false,
  "includeRawData": false,
  "compact": false,
  "excludeEmptyFields": false,
  "onlyAccreditedIt": false,
  "onlyTrustedEmployers": false,
  "excludeAgencies": false,
  "skipReposts": false,
  "monitorMode": false,
  "monitorStoreName": "hh-ru-jobs-monitor",
  "firstRunMode": "emitAll",
  "resetMonitor": false,
  "monitorIncludeUpdated": false,
  "emitUnchanged": false,
  "emitRemovedVacancies": false,
  "notificationLimit": 10,
  "maxConcurrency": 8,
  "includeRunSummary": false
}
```

# Actor output Schema

## `results` (type: `string`):

One item per hh.ru vacancy: title, employer, salary, area, address, experience, employment form, work format, schedule, key skills, full description.

## `summary` (type: `string`):

Per-search counts (results on hh.ru, pages, read, delivered, split searches), vacancies closed since listed, filters, enrichment counts and egress.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "python"
    ],
    "areas": [
        "1"
    ],
    "maxResults": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("topapi/hh-ru-jobs-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["python"],
    "areas": ["1"],
    "maxResults": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("topapi/hh-ru-jobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "python"
  ],
  "areas": [
    "1"
  ],
  "maxResults": 20
}' |
apify call topapi/hh-ru-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,topapi/hh-ru-jobs-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/7T6WVw3mxCGP4qEHB/builds/4ODFIuXwiQtp4wbr9/openapi.json
