Crawlsmith

hh.ru Scraper (HeadHunter)

Scrape jobs from hh.ru and the HeadHunter network across Russia, Kazakhstan, Belarus, Uzbekistan, Kyrgyzstan, Georgia and Azerbaijan. Rich filters, full job descriptions, and incremental monitoring that emits only new or changed vacancies on recurring runs.

What it does

This scraper automatically searches hh.ru and collects structured, ready-to-use data for every matching vacancy. No manual browsing, no copy-paste — set your filters and hit Start.

Two modes of operation:

  1. Discovery Mode — Give it keywords (in Russian or English) plus any combination of filters: country, city, job category, experience level, salary, work format, posting date. It pages through the results and hands you clean rows.
  2. Direct URL Mode — Already built the perfect search in your browser? Paste the address straight in and every filter in that link is honoured. Individual job links work too.

Plus a third way to use it — Monitoring Mode. Run it on a schedule and it remembers what it already saw, then reports only new, updated and reappeared vacancies. On a daily run that typically means 80–95% fewer rows to pay for and read, and it even spots employers who delete and re-post the same job under a fresh ID.


Who uses it

Use Case How It Helps
Recruiters & staffing agencies See every competing vacancy for a role the moment it appears, and reach candidates and clients before the market does
Compensation & market analysts Build real salary benchmarks by city, seniority and job family from thousands of live postings instead of surveys
Job seekers & career coaches Get a daily digest of only genuinely new openings matching a very specific brief — no re-reading yesterday's list
Employer-brand & HR teams Track how rivals describe roles, what they pay, and how fast their vacancies close
Investors & market researchers Use hiring volume by industry and region as a live economic signal
Job boards & aggregators Feed a clean, deduplicated vacancy stream into your own product

Input

48 options. Required ones are marked.

Option What it does
Search keywords What to search for — Russian or English, e.g. python or менеджер по продажам.
Exclude keywords (server-side) Vacancies containing these words are excluded by hh.ru itself before results are returned.
Start URLs Paste hh.ru search URLs or individual vacancy URLs.
Country Restrict results to one country.
Cities / regions City or region names, e.g. Москва, Санкт-Петербург, Алматы, Ташкент.
Area IDs (advanced) Numeric hh area IDs, if you already know them (1 = Moscow, 2 = Saint Petersburg, 40 = Kazakhstan).
Job categories Professional-role categories from hh’s own catalogue.
Professional role IDs (advanced) Individual hh professional-role IDs, or their Russian names (96 = Programmer / Developer).
Required experience Experience level demanded by the employer.
Employment type Full-time, part-time, project work or fly-in-fly-out (вахта).
Work format On site, remote, hybrid or field work.
Work schedule Working-time arrangement.
Education required Education level the employer asks for.
Search only in Restrict where the keywords are matched.

Plus 34 more options. Full input reference on Apify.

Output fields

14 fields, grouped the way the dataset views show them. Export to JSON, CSV, Excel or pull them through the API.

Overview

  • Job title
  • Company
  • City
  • Salary from
  • Salary to
  • Currency
  • Experience
  • Work format
  • Published
  • Link

Monitoring changes

  • Change
  • Job title
  • Company
  • City
  • Salary from
  • Salary to
  • Published
  • First seen
  • Last seen
  • Repost
  • Link

Example output

One record, shortened. Real runs return one row like this per result.

{
  "vacancyId": "136415177",
  "url": "https://hh.ru/vacancy/136415177",
  "title": "Разработчик Python (Проект до 31.03.2027)",
  "companyId": "1455",
  "companyName": "Сатэл",
  "companyUrl": "https://hh.ru/employer/1455",
  "companyWebsite": "http://www.satel.org",
  "companyIsAccreditedIt": true,
  "companyRating": 4.5,
  "companyReviewsCount": 247,
  "salaryFrom": 250000,
  "salaryTo": 350000,
  "salaryCurrency": "RUR",
  "salaryGross": true,
  "salaryPeriod": "MONTH",
  "areaId": "1",
  "areaName": "Москва",
  "address": "Москва, 2-я Брестская улица, 48",
  "experience": "between3And6",
  "employmentForm": "FULL",
  "workFormats": [
    "ON_SITE",
    "REMOTE",
    "HYBRID"
  ],
  "workSchedules": [
    "FIVE_ON_TWO_OFF"
  ],
  "workingHours": [
    "HOURS_8"
  ],
  "professionalRoleIds": [
    "96"
  ],
  "driverLicenseTypes": [],
  "isInternship": false,
  "isNightShifts": false,
  "acceptsTemporary": false,
  "acceptsLaborContract": true,
  "publishedAt": "2026-08-21T17:12:24.639+03:00",
  "createdAt": "2026-03-10T17:43:48.229+03:00",
  "updatedAt": "2026-08-21T17:12:24.717+03:00",
  "responsesCount": 12,
  "isPromoted": false,
  "sourceSite": "hh.ru",
  "searchQuery": "python",
  "description": "Задачи: Работа в команде с front-end и ML разработчиками; Разработка новой функциональности продуктов; Участие в проектировании архитектуры.",
  "keySkills": [
    "Python",
    "FastAPI",
    "PostgreSQL"
  ],
  "changeType": "NEW",
  "firstSeenAt": "2026-08-22T06:00:00.000Z",
  "lastSeenAt": "2026-08-22T06:00:00.000Z",
  "isRepost": false,
  "repostOfId": null,
  "scrapedAt": "2026-08-22T21:29:26.315Z"
}

How to run it

  1. 1. Open the scraper on Apify and sign in (free plan works).
  2. 2. Fill in the input: search terms, URLs or filters, and a result limit.
  3. 3. Run it, then download JSON, CSV or Excel, or pull the dataset through the API.
  4. 4. Schedule it to get fresh data daily or weekly.

FAQ

Can I search in Russian? +

Yes, and you should — Russian keywords give the best coverage. Russian city names work too («Санкт-Петербург», «Екатеринбург»). English keywords and transliterated spellings are also understood.

How many vacancies can I get from one search? +

hh.ru itself only ever shows the first 2000 matches for any single search, no matter how deep you scroll. This scraper says so clearly in the log when your search is bigger than that, and tells you how many matches you aren't seeing. To collect more, split the search — by city, job category, salary band or posting date — and you can gather tens of thousands of rows across runs.

Does it get the full job description? +

Yes, when you enable it. hh's result lists genuinely don't contain descriptions, so each vacancy is opened individually to collect the full text and the employer's key-skills list. Leave it off for a much faster, cheaper run when titles and salaries are enough.

Will I keep getting the same jobs every day? +

Not if you turn on Monitoring Mode. The scraper remembers what it already reported and gives you only genuinely new, updated or reappeared vacancies — usually cutting output by 80–95% on a daily schedule. It also flags jobs that are simply old postings republished under a new ID.

Why are some results marked as promoted? +

hh places a few paid listings at the top of its result pages. Those are real vacancies, so they are kept — but flagged with isPromoted, because they repeat across pages and would otherwise look like duplicates.

Can I export the data? +

Yes — JSON, CSV, Excel, XML, HTML, RSS. You can also push data directly to Google Sheets, Zapier, Make, or any webhook/API endpoint.

How often should I run this? +

For fresh data, run daily or weekly. You can schedule automatic runs on Apify with just a few clicks — and with Monitoring Mode enabled, frequent runs stay cheap.

Does it need proxies? +

Yes, and it is already set up for you. hh.ru limits how many requests a single address may make, so the scraper rotates through Apify's standard (cheapest) proxy pool by default — that is the difference between runs that finish and runs that get refused. You don't have to configure anything; just leave the proxy option on, especially for scheduled or parallel runs.


Need something this scraper does not do?

Extra fields, a different filter, a recurring feed into your database or a one-off bulk export.

Ask for a custom version

Related scrapers