# Changelog of hh.ru Jobs Search Scraper (`jobsapi/hh-ru-jobs-search-scraper`) Actor

- **URL**: https://apify.com/jobsapi/hh-ru-jobs-search-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/jobsapi/hh-ru-jobs-search-scraper.md

## Changelog

All notable changes to the hh.ru Job Scraper are documented here.

### \[2.0.0] - 2026-08-31

#### Changed

- Replaced fragile HTML parsing with the public HH.ru REST API.
- Added search, multiple-search, single-vacancy, and multiple-vacancy modes.
- Added bounded pagination, filters, strict validation, detail concurrency, retries, and proxy-session rotation.
- Added explicit detail status, ID deduplication, run summaries, complete schemas, tests, dataset validation, and marketplace documentation.
- Removed nonfunctional unused Crawlee stubs and dead modules.

### \[1.0.0] - 2025-05-20

#### Added

- Initial production release of the hh.ru (HeadHunter Russia) Job Scraper.
- Official hh.ru REST API integration - no browser required, no credentials needed.
- Modular project structure:
  - `src/main.js` - entry point with input validation and API orchestration.
  - `src/schema/input.js` - input validation (mode, keywords, area, experience, salaryFrom).
  - `src/extractors/index.js` - vacancy normalisation (`normalizeVacancy`, `normalizeVacancyDetail`).
  - `src/filters/index.js` - deduplication and result filtering helpers.
  - `src/utils/index.js` - URL builder, HTTP retry wrapper using `got-scraping`.
  - `src/errors/` - `ScraperError`, `ErrorTypes`, `ErrorHandler`.
- Two operating modes: `search` (keyword + filters) and `jobUrl` (direct vacancy URLs).
- Pagination support up to 2 000 results (hh.ru API cap of 50 pages × 20 per page).
- Salary filter (`salaryFrom`, `onlyWithSalary`) and schedule/employment/experience filters.
- Job detail enrichment: key skills, languages, full description, contacts.
- `.actor/actor.json`, `input_schema.json`, `dataset_schema.json` for Apify platform compatibility.
- `Dockerfile` based on `apify/actor-node-playwright-chrome`.
- `README.md` with full Apify usage guide.