HH.RU Jobs Scraper

Search public HH.RU vacancies and return a clean, AI-ready job feed for recruitment research, job alerts, and Russian labor-market analysis. The actor uses HH.RU's documented public vacancy API; it does not log in, collect resumes, or return recruiter/applicant contact details.

When to use it

Use this actor when you need current HH.RU jobs filtered by role, geographic area ID, experience, employment type, schedule, salary disclosure, or publication window. It also enriches known public hh.ru/vacancy/<id> URLs.

Do not use it for private resumes, candidate profiles, employer account data, submitting applications, or external job-board URLs.

Input

The default run searches for software engineer vacancies from the last 30 days and returns up to 20 jobs.

{
  "searchQuery": "data engineer",
  "areaIds": ["1"],
  "experience": "between1And3",
  "scheduleType": "remote",
  "publishedWithinDays": 7,
  "maxResults": 20,
  "includeJobDetails": true,
  "responseFormat": "concise"
}

areaIds uses HH.RU's numeric geographic identifiers (for example, 1 is Moscow). Leave it empty to search every area. Set vacancyUrls to public HH.RU vacancy links when you want known listings; those URLs take precedence over query filters.

Output

Each dataset row is one normalized public vacancy:

{
  "jobId": "123456",
  "title": "Data Engineer",
  "companyName": "Example Labs",
  "location": "Moscow",
  "schedule": "Remote work",
  "experience": "Between 1 and 3 years",
  "salaryMin": 250000,
  "salaryMax": 350000,
  "salaryCurrency": "RUR",
  "skills": ["Python", "SQL"],
  "professionalRoles": ["Data analyst"],
  "description": "Build reliable data pipelines…",
  "postedAt": "2026-07-15T12:00:00+0300",
  "jobUrl": "https://hh.ru/vacancy/123456",
  "source": "hh.ru"
}

The default key-value store always contains:

• OUTPUT — compact result outcome for API and agent use.
• RUN_SUMMARY — page, item, route, warning, and charge diagnostics.

Reliability and limits

HH.RU requires an identifying HH-User-Agent header and may prompt anonymous API traffic for a captcha or rate-limit it. The actor uses a consistent Russia-targeted residential session, retries transient errors, keeps useful listing data when an optional detail call fails, and reports a blocked route as UPSTREAM_FAILED rather than an empty result.

The public vacancy API limits a search window to 30 days and practical pagination to its own documented result cap. maxResults caps this actor at 100 jobs per run for predictable runtime and cost.

Pricing

This actor uses Pay per event + platform usage:

• Actor start: $0.00005 once per run.
• Job scraped: $0.003 for each validated job persisted in the dataset.
• Apify platform compute and residential proxy usage are charged separately to the run user.

At the default 20-result cap, job events cost at most $0.06005, plus platform usage. Invalid, duplicate, or unpersisted records are not charged as jobs.

Data provenance and responsible use

Rows are derived from public HH.RU vacancy search and detail pages, with the exact sourceUrl retained for provenance. Respect HH.RU's terms, applicable data-protection laws, and your users' expectations. Do not use this actor to make employment decisions about individuals.