HH.ru Jobs Search Scraper: Extract Russian Vacancy Data at Scale

---

What Is HH.ru?

HH.ru is the leading employment portal in Russia and the CIS region, hosting hundreds of thousands of active job listings daily. Whether searching for tech roles, remote positions, or region-specific opportunities, HH.ru aggregates opportunities across industries and skill levels. Manually scraping job data from search result pages is laborious and error-prone — the HH.ru Jobs Search Scraper automates this process, delivering rich, structured records for analytics and integration.

---

Overview

The HH.ru Jobs Search Scraper extracts job vacancy listings from HH.ru search result pages, capturing 60+ distinct fields per posting. It is tailored for:

• Recruiters & HR teams tracking market trends, competitor activity, and salary benchmarks
• Job aggregators building multi-source job boards
• Data analysts studying employment patterns in Russia and neighboring regions
• Academic researchers analyzing labor market dynamics

The scraper excels at handling large-scale collection with configurable item limits, failure tolerance, and remote job filtering. It respects HH.ru's infrastructure and gracefully handles timeouts and redirects.

---

Input Format

The scraper accepts a JSON configuration object with three key parameters:

{
  "urls": [
    "https://hh.ru/search/vacancy?schedule=remote&L_profession_id=0&area=113&hhtmFrom=main"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}

Parameter	Type	Description
urls	Array	HH.ru search result page URLs (e.g., filtered by location, job type, or keyword). Multiple URLs supported for batch collection.
max_items_per_url	Integer	Maximum number of job listings to extract per URL (e.g., 200). Useful for controlling data volume and runtime.
ignore_url_failures	Boolean	If true, the scraper skips failed URLs and continues processing remaining links. If false, any failure halts the entire run.

URL examples:

• Remote roles nationwide: https://hh.ru/search/vacancy?schedule=remote&area=113
• Moscow office positions: https://hh.ru/search/vacancy?area=1&order_by=relevance
• Specific keyword: https://hh.ru/search/vacancy?text=python+developer&area=113

Tip: HH.ru URLs often include search filters (schedule, area, text). Adjust these in your URLs to target specific job categories or regions.

---

Output Format

Each scraped vacancy returns a comprehensive record with 60+ fields across six categories:

Vacancy Identification

Field	Meaning
Vacancy ID	Unique HH.ru identifier for the job posting
Name	Job title as displayed
Company	Employer organization name
Compensation	Salary range (may be hidden if employer opted out)
Area	Geographic region of the position
Publication Time	When the vacancy was posted
Last Change Time	Last update timestamp
Creation Time	Internal creation date

Work Terms & Schedule

Field	Meaning
Work Schedule	Schedule type (full-time, part-time, shift-based)
Work Formats	Remote, hybrid, or office-based work mode
Working Days	Days per week (e.g., 5, 4-day weeks)
Working Time Intervals	Specific hours or flexible arrangement
Working Time Modes	Shift patterns or flexible schedules
Night Shifts	Whether night shifts are involved
Fly In Fly Out Durations	Rotation periods for remote/mobile roles

Employment & Legal

Field	Meaning
Employment	Employment type (permanent, contract, internship)
Employment Form	Legal employment arrangement
Accept Temporary	Whether temporary staffing is accepted
Accept Labor Contract	Labor agreement acceptance flag
Civil Law Contracts	Whether independent contractor roles considered
Internship	Whether position is an internship or traineeship

Requirements & Qualifications

Field	Meaning
Work Experience	Minimum required work experience
Professional Role IDs	Job category classifications
Languages	Required language proficiencies
Driver License Types	Driving license requirements (if applicable)
Accept Incomplete Resumes	Whether employer accepts incomplete applications
Response Letter Required	If a cover letter must accompany applications

Application & Communication

Field	Meaning
Contact Info	Employer contact details
Show Contact	Whether contact info is publicly visible
Template	Application template provided by employer
Auto Response	Automated response sent to applicants
Inbox Possibility	Whether direct messaging is enabled
Chat Write Possibility	Whether real-time chat with employer is allowed
Notify	Notification settings for the vacancy

Analytics & Engagement

Field	Meaning
Responses Count	Number of applications received
Total Responses Count	Total lifetime applications
Online Users Count	Active candidate views in real-time
Click URL	URL for tracking vacancy clicks
Is Adv	Whether the vacancy is promoted (paid placement)
Tags, Labels, Extra Labels	Internal categorization tags
User Labels	Custom employer labels

Technical & System Fields

Field	Meaning
Creation Site, Creation Site ID	Source platform identifier
Display Host	Server hostname delivering the listing
Can Be Shared	Permission to reshare the vacancy
Employer Manager	Employer account manager info
User Test Present	Whether a skills test is required
Closed For Applicants	Whether the position is still accepting applications
Vacancy Properties, Vacancy Platforms	Extended job attributes
Inclusiveness Types	Accessibility and inclusion flags
Branding	Employer branding information
Search RID	Request ID for this specific search

---

How to Use

1. Prepare URLs — Visit HH.ru and build search queries (filter by location, job type, salary, etc.). Copy the full URL from your browser.
2. Add to configuration — Paste URLs into the urls array. You can add one or multiple search pages.
3. Set item limit — Adjust max_items_per_url (e.g., 200 for 200 listings per page). Higher numbers take longer but capture more data.
4. Enable fault tolerance — Set ignore_url_failures: true to skip problematic URLs without stopping the entire run.
5. Execute — Run the scraper and monitor the logs for progress and errors.
6. Export — Download results as JSON, CSV, or Excel for analysis or integration.

Best practices:

• Use filters in HH.ru URLs to target specific regions, industries, or job types (reduces noise and runtime).
• For large-scale collection, split URLs by region or profession to avoid overwhelming the job portal.
• Check the output for null or hidden values (e.g., Compensation may be omitted by employers).

---

Use Cases & Business Value

• Market intelligence: Track hiring trends, salary ranges, and skill demand across Russian markets
• Competitive analysis: Monitor competitor job postings and employer branding strategies
• Recruitment optimization: Build datasets for candidate sourcing and salary benchmarking
• Job aggregator platforms: Feed HH.ru data into multi-source job boards
• Economic research: Analyze employment trends and regional labor dynamics

The scraper delivers ready-to-analyze data, cutting data collection time from hours to minutes and enabling insights that would otherwise require manual effort.

---

Conclusion

The HH.ru Jobs Search Scraper is an efficient, reliable tool for extracting Russian job market data at scale. With 60+ fields of rich vacancy information and robust error handling, it empowers recruiters, analysts, and researchers to make data-driven hiring and business decisions. Start scraping today and unlock actionable insights from Russia's largest job portal.