В качестве основного источника данных используется информация о фактических заработных платах, предоставляемая участниками проекта. Все анкеты участников проходят проверку модераторами, сведения о размерах зарплат, разительно отличающиеся от сложившихся рыночных условий, в банк данных заработных плат не включаются. При недостатке данных о фактических заработных платах API может дополнительно использовать информацию из вакансий и резюме. Этот источник менее надежный, так как данные о зарплатах в вакансиях не проходят дополнительную модерацию и могут содержать сведения, значительно отличающиеся от сложившейся рыночной ситуации. Кроме того, не всегда верно определяется специализация и уровень специалиста для вакансий и резюме. Поэтому информация о зарплатах из вакансий и резюме используется только в тех случаях когда информации о фактических зарплатах недостаточно. API Банка зарплат использует несколько способов расширения выборки, если данных для получения результатов по запросу недостаточно:
- Объединение сведений из нескольких отраслей если данных по запрошенной отрасли недостаточно.
- Объединение сведений из нескольких близких специализаций если данных по запрошенной специализации недостаточно.
- Объединение сведений из нескольких городов в рамках региона если данных по запрошенному городу недостаточно.
- Использование сведений по запрошенным специализациям из другого региона с последующей поправкой на рассчитанный коэффициент разницы в зарплатах между регионами.
API Банка зарплат предоставляет возможность делать запросы двумя способами.
- Запрос по конкретным специализациям в соответствии со справочником Банка данных заработных плат. Рекомендуется этот способ.
- Запрос по названию должности. В этом случае программа пытается самостоятельно сопоставить название должности со специализациями из Банка данных заработных плат, дальнейшие расчеты выполняются по автоматически определенным специализациям по тому же алгоритму.
Метод для получения оценки заработных плат без прогноза. Требует авторизации пользователя и наличия у пользователя доступа к платным отчётам Банка зарплат (см. https://salary.hh.ru).
GET /salary_statistics/paid/salary_evaluation/{area_id}
где
area_id— код региона (фед. округа, субъекты федерации, города), по которым будет построена выборка для формирования отчёта. См. справочник регионов.
| Имя | Обязательный | Описание |
|---|---|---|
| exclude_area | Нет | Коды регионов (федеральные округа, субъекты федерации, города), которые будут исключены из выборки для формирования отчёта в любом случае. Параметр предназначен для получения оценки на региональном рынке с исключением определенных городов/областей. См. справочник регионов |
| employee_level | Нет | Уровни специалистов, которые будут включены в выборку для формирования отчёта. См. справочник уровней специалистов |
| industry | Нет | Коды отраслей, по которым будет построена выборка для формирования отчёта. См. справочник отраслей |
| speciality | Нет | Коды профобластей и специализаций, которые будут включены в выборку для формирования отчёта. См. справочник профобластей и специализаций |
| extend_sources | Нет | Использовать ли данные из резюме и вакансий, если по указанным параметрам не нашлось данных в Банке Зарплат. Принимает значения true или false. По умолчанию false. |
| position_name | Нет | Наименование должности. Если не указаны speciality или employee_level, сервис самостоятельно определит возможные специализации и уровень специалиста по указанной должности и отрасли и построит отчет по ним. |
Зарплаты в России, за исключением Москвы и Санкт-Петербурга, для уровня «Специалист», в компаниях с отраслями «Информационные технологии» или «Сельское хозяйство»:
GET /salary_statistics/paid/salary_evaluation/113?
exclude_area=1&
exclude_area=2&
employee_level=specialist&
industry=7&
industry=29
Зарплаты в Москве с уровнями «Ведущий специалист» и «Эксперт» в специализациях «Управление разработкой ПО» и «Управление проектами».
GET /salary_statistics/paid/salary_evaluation/1?
employee_level=senior_specialist&
employee_level=expert&
speciality=1170001&
speciality=1170002
200 OK, в теле ответа содержатся данные по зарплатам и параметры выборки:
{
"market_salary": {
"upper": 50000,
"minimum": 20000,
"median": 35000,
"average": 50054,
"maximum": 52643,
"bottom": 28500
},
"resulting_parameters": {
"areas": [
{
"id": "10010",
"name": "Южный федеральный округ"
}
],
"excluded_areas": [
{
"id": "1530",
"name": "Ростовская область"
}
],
"employee_levels": [
{
"id": "specialist",
"name": "Специалист"
}
],
"industries": [
{
"id": "7",
"name": "Информационные технологии, системная интеграция, интернет"
}
],
"specialities": [
{
"id": "1200000",
"name": "Эксплуатация информационных систем"
}
],
"sources": [
"SALARIES",
"RESUMES",
"VACANCIES"
],
"indirect_calculation": null,
"positions_count": 1648,
"employers_count": 21
}
}| Имя | Тип | Описание |
|---|---|---|
| resulting_parameters | object | Набор параметров, по которым происходил расчёт |
| resulting_parameters.areas | array | Коды регионов (фед. округа, субъекты федерации, города) |
| resulting_parameters.excluded_areas | array или null | Исключённые коды регионов (фед. округа, субъекты федерации, города) |
| resulting_parameters.employee_levels | array или null | Уровни специалистов, включаемые в выборку в целевом регионе |
| resulting_parameters.industries | array или null | Отрасли |
| resulting_parameters.specialities | array или null | Профобласти |
| resulting_parameters.sources | array | Используемые источники данных |
| resulting_parameters.indirect_calculation | object или null | Параметры косвенной оценки зарплатных значений |
| employers_count | number | Количество работодателей, данные которых участвуют в выборке |
| positions_count | number | Количество записей о сотрудниках в анкетах, по которым построена выборка |
| market_salary | object | Рыночный диапазон зарплатных значений |
| market_salary.maximum | number | Максимальные значения (90-й процентиль) |
| market_salary.upper | number | Верхняя граница рыночного диапазона (75-й процентиль) |
| market_salary.median | number | В среднем по рынку (медиана) |
| market_salary.average | number | Среднее расчетное значение |
| market_salary.bottom | number | Нижняя граница рыночного диапазона (25-й процентиль) |
| market_salary.minimum | number | Минимальные значения (10-й процентиль) |
Поле resulting_parameters.indirect_calculation присутствует в ответе только при запросе данных
по одному региону и содержит параметры косвенной оценки зарплат.
В примере выше вместо "indirect_calculation": null может быть объект вида:
{
"indirect_employee_levels": [
{
"id": "senior_specialist",
"name": "Ведущий специалист"
}
],
"indirect_areas":[
{
"id": "1",
"name": "Москва"
}
],
"indirect_regional_ratio": 0.4375
}| Имя | Тип | Описание |
|---|---|---|
| indirect_calculation.indirect_areas | array или null | Регионы, использованные для косвенного расчёта |
| indirect_calculation.indirect_employee_levels | array или null | Уровни специалистов, включённые в выборку в регионе, использованном для косвенного расчёта |
| indirect_calculation.indirect_regional_ratio | number | Региональный коэффициент, который был использован для получения косвенной оценки зарплат |
Ответ, приведённый выше, означает, что:
- в запрошенном регионе «Южный ФО» (
resulting_parameters.areas) - по запрошенному уровню «Специалист» (
resulting_parameters.employee_levels) данных о зарплатах не нашлось - но удалось сделать косвенный расчёт
- относительно уровня «Ведущий специалист» (
resulting_parameters.indirect_calculation.indirect_employee_levels) - в регионе «Москва» (
resulting_parameters.indirect_calculation.indirect_areas) - коэффициент составил 0.4375 (
resulting_parameters.indirect_calculation.indirect_regional_ratio).
- относительно уровня «Ведущий специалист» (
400 Bad Request— ошибка в параметрах.403 Forbidden— нет доступа, или пользователь не авторизован.404 Not Found— нет данных для указанных параметров.