# hh.ru, free: Company enrichment API

> Возвращает данные о работодателе со ссылкой на выдачу вакансий этого работодателя

hh.ru's Application token plan for the company enrichment API costs $0.00 per 1,000 companies. hh.ru's docs list 6 of the 13 fields on our checklist: Description, Industry, Type and status, Images, Headquarters, Locations.
hh.ru limits how many calls you get but gives no number.
We haven't run hh.ru through [our company enrichment API benchmark](https://datacircle.dev/best-company-enrichment-api.txt) yet.
Half of the 2,362 plans we rank by price cost $8.704 per 1,000 companies or less. This plan and 128 others tie for the lowest price per 1,000 companies of the 2,362 plans. [See the best free company enrichment API plan.](https://datacircle.dev/best-company-enrichment-api.txt)
[APIs Peru's PEN 30 (about $9) monthly plan](https://datacircle.dev/company-enrichment-apis/apis-peru/pen-30-monthly/llms.txt) covers any number of companies in Peru only. APIs Peru's PEN 30 (about $9) monthly plan costs less up front than ROIC.ai's $29 monthly plan.
[ROIC.ai](https://datacircle.dev/company-enrichment-apis/roic-ai/89-monthly/llms.txt), [Intrinio](https://datacircle.dev/company-enrichment-apis/intrinio/150-monthly/llms.txt) and [GLEIF](https://datacircle.dev/company-enrichment-apis/gleif/free/llms.txt) are the best company enrichment API providers in the Datacircle benchmark for companies in any country.

- This page: https://datacircle.dev/company-enrichment-apis/hh-ru/free
- [Company enrichment API: the best of 190+ providers compared](https://datacircle.dev/best-company-enrichment-api.txt)
- Get it: https://dev.hh.ru/admin/developer_agreement?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=company-enrichment-api-pricing
- Request: `GET https://api.hh.ru/employers/{employer_id}`
- API key: with the plan, on https://dev.hh.ru/admin/developer_agreement?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=company-enrichment-api-pricing
- Its API docs: https://api.hh.ru/openapi/redoc?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=company-enrichment-api-pricing#tag/Rabotodatel/operation/get-employer-info
- Sold by: hh.ru (https://dev.hh.ru?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=company-enrichment-api-pricing)
- Checked: 2026-11-07

## In the answer

- Completeness: 46%
- Description: ✓
- Industry: ✓
- Type and status: ✓
- Images: ✓
- Headquarters: ✓
- Locations: ✓

## Price

- $ per 1,000 companies: $0.00
- Per: call
- Billing: free

## Aggregators

- Aggregators: none

## Charges

- 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: employer_id, HH-User-Agent header. Optional: host, locale
- Method: GET
- Path: /employers/{employer_id}

## 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 22 fields the plan's answer can hold

company ID, name, description, branded description, company type, industries, website, profile URL, vacancies URL, location, area ID, area URL, country code, open vacancies, logo, trusted, accredited IT employer, identified by ESIA, insider interviews, branding, relations, target employer count

## hh.ru's plans (1)

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

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

- `GET /employers/{employer_id}`: [hh.ru, free](https://datacircle.dev/company-enrichment-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: company enrichment API alternatives

- [Latinfo, free, GET /pe/ruc/{ruc}](https://datacircle.dev/company-enrichment-apis/latinfo/free-get-pe-ruc-ruc/llms.txt): $0.00 per 1,000, 15% complete, stored
- [ROIC.ai, free](https://datacircle.dev/company-enrichment-apis/roic-ai/free/llms.txt): $0.00 per 1,000, 54% complete
- [data.ct.gov, free, With an app token](https://datacircle.dev/company-enrichment-apis/data-ct-gov/free-with-an-app-token/llms.txt): $0.00 per 1,000, 38% complete, 1 day
- [Brreg, free](https://datacircle.dev/company-enrichment-apis/brreg/free/llms.txt): $0.00 per 1,000, 38% complete, live
- [GSTINCheck, free](https://datacircle.dev/company-enrichment-apis/gstincheck/free/llms.txt): $0.00 per 1,000, 8% complete

## 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=company-enrichment-api-pricing
- https://api.hh.ru/openapi/specification/public?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=company-enrichment-api-pricing
- https://dev.hh.ru?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=company-enrichment-api-pricing
- https://dev.hh.ru/admin/developer_agreement?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=company-enrichment-api-pricing