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:
- 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.
- 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 | Type | What it does |
|---|---|---|
| Search keywords | Text | What to search for — Russian or English, e.g. python or менеджер по продажам. |
| Exclude keywords (server-side) | Text | Vacancies containing these words are excluded by hh.ru itself before results are returned. |
| Start URLs | List | Paste hh.ru search URLs or individual vacancy URLs. |
| Country | Text | Restrict results to one country. |
| Cities / regions | List | City or region names, e.g. Москва, Санкт-Петербург, Алматы, Ташкент. |
| Area IDs (advanced) | List | Numeric hh area IDs, if you already know them (1 = Moscow, 2 = Saint Petersburg, 40 = Kazakhstan). |
| Job categories | List | Professional-role categories from hh’s own catalogue. |
| Professional role IDs (advanced) | List | Individual hh professional-role IDs, or their Russian names (96 = Programmer / Developer). |
| Required experience | Text | Experience level demanded by the employer. |
| Employment type | Text | Full-time, part-time, project work or fly-in-fly-out (вахта). |
| Work format | Text | On site, remote, hybrid or field work. |
| Work schedule | Text | Working-time arrangement. |
| Education required | Text | Education level the employer asks for. |
| Search only in | List | 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. Open the scraper on Apify and sign in (free plan works).
- 2. Fill in the input: search terms, URLs or filters, and a result limit.
- 3. Run it, then download JSON, CSV or Excel, or pull the dataset through the API.
- 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 versionRelated scrapers
RocketJobs.pl Job Scraper
Poland
Scrape non-IT job offers from RocketJobs.pl - Poland's general job board covering sales, production, logistics, healthcare, retail, gastronomy, construction and 17 more categories. Extract salaries, locations, contract types, experience levels, skills and full descriptions.
Just Join IT Scraper
Poland
Fast IT job scraper for JustJoin.it. Extract salaries, tech stacks, experience levels, remote options. Supports keyword, location, category filters. Up to 100 offers per request.
Pracuj.pl Job Listings Scraper
Poland
Fast and efficient job listings scraper for Pracuj.pl. Extract job offers, salaries, company info, locations, and more. Supports keyword search, filters, and pagination.
Meteojob Jobs Scraper
France
Scrapes job listings from Meteojob.com - one of France's largest employment platforms. API-based, fast and reliable, with rich filters and 50+ output fields.