# hh.ru, free: Job postings API

> Возвращает список вакансий, размещенных в сервисе. Список вакансий фильтруется согласно переданным параметрам запроса.

hh.ru's Application token plan for the job postings API costs $0.00 per 1,000 jobs. hh.ru's docs list 8 of the 13 fields on our checklist: Description, Location, Salary, Terms, Team, Company, Posted, Status.
hh.ru limits how many pages you get but gives no number.
We haven't run hh.ru through [our job postings API benchmark](https://datacircle.dev/best-job-postings-api.txt) yet.
Half of the 400 plans we rank by price cost $0.49 per 1,000 jobs or less. This plan and 29 others tie for the lowest price per 1,000 jobs of the 400 plans. [See the best free job postings API plan.](https://datacircle.dev/best-job-postings-api.txt)
[Hirebase's $50 monthly plan (/v2/jobs/expired-jobs/export)](https://datacircle.dev/job-posting-apis/hirebase/50-monthly-web-pro-post-v2-jobs-expired-jobs-export/llms.txt) covers any number of jobs. Hirebase's $50 monthly plan costs less up front than JobDataAPI's $345 monthly plan.
[freehire](https://datacircle.dev/job-posting-apis/freehire/29-monthly-api-get-jobs-search/llms.txt), [Himalayas](https://datacircle.dev/job-posting-apis/himalayas/free-api-key-get-jobs-api-search/llms.txt) and [JobDataAPI](https://datacircle.dev/job-posting-apis/jobdataapi/free/llms.txt) are the best job postings API providers in the Datacircle benchmark.

- This page: https://datacircle.dev/job-posting-apis/hh-ru/free
- [Job postings API: the best of 40+ providers compared](https://datacircle.dev/best-job-postings-api.txt)
- Get it: https://dev.hh.ru/admin/developer_agreement?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-postings-api-pricing
- Request: `GET https://api.hh.ru/vacancies`
- API key: with the plan, on https://dev.hh.ru/admin/developer_agreement?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-postings-api-pricing
- Its API docs: https://api.hh.ru/openapi/redoc?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-postings-api-pricing#tag/Poisk-vakansij/operation/get-vacancies
- Sold by: hh.ru (https://dev.hh.ru?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-postings-api-pricing)
- Checked: 2026-11-07

## In the answer

- Completeness: 62%
- Description: ✓ snippet
- Location: ✓
- Salary: ✓
- Terms: ✓
- Team: ✓
- Company: ✓
- Posted: ✓
- Status: ✓

## Price

- $ per 1,000 jobs: $0.00
- Per: page of 100
- Billing: free

## Aggregators

- Aggregators: none

## Charges

- Most per search: 2,000
- Also pays for: nothing else

## Not found

- $ per 1,000: $0.00

## In their words

- Their pitch: Возвращает список вакансий, размещенных в сервисе. Список вакансий фильтруется согласно переданным параметрам запроса.

## Data

- Keep data: until the vacancy is moved to the archive
- Use data: 1.5. [...] В случае, если конечными пользователями Приложения являются организации и физические лица, являющиеся работодателями или кадровыми агентствами, то указанные лица вправе использовать Сервис только для целей привлечения потенциальных работников и их последующего трудоустройства непосредственно в такие юридические лица (у таких физических лиц) или у клиентов таких кадровых агентств. [...] 3.3. Использование любых материалов, получаемых посредством Сервиса с Сайта, недопустимо ни с какими целями, кроме соответствующих тематике Сайта (поиск работы, сотрудников, получение информации о рынке труда). [...] 3.11. Разработчику Приложения запрещается вносить изменения в материалы, которые получены посредством Сервиса с Сайта. Разработчик Приложения обязан следить за актуальностью вышеуказанных материалов, в том числе, своевременно удалять вакансии, которые перемещены в архив. [...] 4.3. Посредством Приложения не должно быть возможным скачивание (получение, извлечение) данных для формирования другой базы данных для предоставления данных из такой созданной базы данных (доступа к базе данных) другим лицам. [...] 4.5. Запрещено хранить и использовать полученные посредством Приложения данные для целей, отличных от тематики сайта https://hh.ru, а именно контакта потенциального работодателя с потенциальным соискателем с целью последующего трудоустройства. [...] 4.6. Запрещается передавать данные, полученные посредством Сервиса из баз данных и сайтов, принадлежащих HeadHunter и используемых для работы Сервиса, сторонним сервисам для использования. Единственными пользователями данных, полученных посредством Приложения, могут быть зарегистрированные пользователи сайта http://hh.ru, для которых инициировалось получение данных. [...] 4.7. Запрещено использовать пользовательские данные в рекламных (без согласия получателей, например, в виде рассылки спама) или целях политической или иной агитации.

## Plan

- Pay: $0

## Rate limit

- Batch: 1

## Speed

- Answer: in the call

## The call

- You send: HH-User-Agent header. Optional: text, search_field, experience, area, metro, professional_role, industry, employer_id, currency, salary, salary_frequency, salary_mode, label, period, date_from, date_to, top_lat, bottom_lat, left_lng, right_lng, order_by, sort_point_lat, sort_point_lng, clusters, describe_arguments, no_magic, responses_count_enabled, accept_temporary, employment_form, work_schedule_by_days, working_hours, work_format, excluded_text, education, driver_license_types, page, per_page, host, locale
- Method: GET
- Path: /vacancies

## About the plan

- Plan: Application token
- Who can get it: any internet user with an hh.ru account who registers an application at dev.hh.ru and accepts the developer agreement (HeadHunter may refuse a registration)

## The 86 fields the plan's answer can hold

job ID, title, job URL, API URL, apply URL, response URL, posted at, created at, archived, closed for applicants, location, area ID, area URL, address, city, street, building, address description, address ID, latitude, longitude, metro station, metro stations, company, company ID, company URL, company API URL, company vacancies URL, company logo, company country ID, company rating, company review count, company trusted, company accredited IT employer, company identified by ESIA, salary, salary min, salary max, salary currency, salary gross, salary period, salary mode, employment type, employment form, experience, schedule, work format, work schedule by days, working hours, working days, working time intervals, working time modes, professional roles, department, internship, night shifts, fly-in fly-out duration, accepts temporary workers, accepts incomplete resumes, accepts labor contract, civil law contracts, has test, response letter required, premium, job type, relations, show contacts, contact name, contact phones, call tracking enabled, insider interview, requirements snippet, responsibilities snippet, responses count, total responses count, distance from sort point, show logo in search, total results, page, total pages, results per page, search URL, clusters, search arguments, spelling fixes, search suggestions

## hh.ru's plans (1)

- [hh.ru, free](https://datacircle.dev/job-posting-apis/hh-ru/free/llms.txt): $0.00 per 1,000, 62% complete

## hh.ru's calls for this API (1)

- `GET /vacancies`: [hh.ru, free](https://datacircle.dev/job-posting-apis/hh-ru/free/llms.txt)

## hh.ru's APIs (4)

- [hh.ru: company discovery API pricing, 1 plan](https://datacircle.dev/company-discovery-apis/hh-ru/free/llms.txt)
- [hh.ru: company enrichment API pricing, 1 plan](https://datacircle.dev/company-enrichment-apis/hh-ru/free/llms.txt)
- [hh.ru: job posting details API pricing, 1 plan](https://datacircle.dev/job-posting-details-apis/hh-ru/free/llms.txt)
- [hh.ru: job postings API pricing, 1 plan](https://datacircle.dev/job-posting-apis/hh-ru/free/llms.txt)

## hh.ru: job postings API alternatives

- [freehire, free (no key), GET /jobs](https://datacircle.dev/job-posting-apis/freehire/free-no-key-get-jobs/llms.txt): $0.00 per 1,000, 85% complete, stored
- [Himalayas, free, No API key, GET /jobs/api](https://datacircle.dev/job-posting-apis/himalayas/free-no-api-key-get-jobs-api/llms.txt): $0.00 per 1,000, 62% complete, 24 hours
- [JobDataAPI, free](https://datacircle.dev/job-posting-apis/jobdataapi/free/llms.txt): $0.00 per 1,000, 46% complete
- [Arbetsförmedlingen, free, Open data, GET /search, Historical job ads: Search using parameters and/or freetext](https://datacircle.dev/job-posting-apis/arbetsformedlingen/free-open-data-get-search-historical-job-ads-search-using-parameters-and-or-freetext/llms.txt): $0.00 per 1,000, 69% complete
- [Diffbot, free, GET /kg/v3/dql](https://datacircle.dev/job-posting-apis/diffbot/free-get-kg-v3-dql/llms.txt): $0.00 per 1,000, 46% complete, stored

## Sources

From each provider's own pricing page and docs, and from what providers tell us. We read this row from these pages on 2026-11-07.

- https://api.hh.ru/openapi/redoc?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-postings-api-pricing
- https://api.hh.ru/openapi/specification/public?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-postings-api-pricing
- https://dev.hh.ru?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-postings-api-pricing
- https://dev.hh.ru/admin/developer_agreement?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-postings-api-pricing