PHPackages                             kirstepankov/myhhapi - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. kirstepankov/myhhapi

ActivePackage[API Development](/categories/api)

kirstepankov/myhhapi
====================

PHP library to interact with hh.ru API

0.1.4(3y ago)089MITPHP

Since Oct 16Pushed 3y ago1 watchersCompare

[ Source](https://github.com/KirStepankov/MyHHAPI)[ Packagist](https://packagist.org/packages/kirstepankov/myhhapi)[ RSS](/packages/kirstepankov-myhhapi/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (1)Versions (15)Used By (0)

[![Maintainability](https://camo.githubusercontent.com/baa012fcaf780b1b1af9b27978136b9e249331a2430183261ee1cbd44b60ffe8/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f37343534373665643033323438323864656632332f6d61696e7461696e6162696c697479)](https://codeclimate.com/github/KirStepankov/MyHHAPI/maintainability)[![](https://camo.githubusercontent.com/54b7d7b6acdbd8a3fb998f5bbb433e8c0049f716e0088d037fb586a287828fdd/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f37343534373665643033323438323864656632332f746573745f636f766572616765)](https://codeclimate.com/github/KirStepankov/MyHHAPI/test_coverage)

```
composer require kirstepankov/myhhapi
```

#### ![:octocat:](https://github.githubassets.com/images/icons/emoji/octocat.png ":octocat:") Ведётся разработка новых сервисов! Список будет пополняться со временем

[](#octocat-ведётся-разработка-новых-сервисов-список-будет-пополняться-со-временем)

My Headhunter API
=================

[](#my-headhunter-api)

Без усилий получите данные от HH

Предисловие
===========

[](#предисловие)

В данной библиотеки реализованы только те методы, которые мне захотелось описать. Если вы захотите использовать её, но в ней нет того, что вам нужно, обязательно пишите в issue. Как только замечу предложение, сразу обращу на него своё внимание. [Телега для связи](https://t.me/stepankoff)

Навигация
=========

[](#навигация)

- [Получение вакансии по id](https://github.com/KirStepankov/MyHHAPI#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D1%83%D0%BD%D0%B8%D0%B5-%D0%BA%D0%BE%D0%BD%D0%BA%D1%80%D0%B5%D1%82%D0%BD%D0%BE%D0%B9-%D0%B2%D0%B0%D0%BA%D0%B0%D0%BD%D1%81%D0%B8%D0%B8-%D0%BF%D0%BE-id)
- [Получение нескольких вакансий по условиям](https://github.com/KirStepankov/MyHHAPI#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D1%83%D0%BD%D0%B8%D0%B5-%D0%B2%D0%B0%D0%BA%D0%B0%D0%BD%D1%81%D0%B8%D0%B9-%D0%BF%D0%BE-%D1%83%D1%81%D0%BB%D0%BE%D0%B2%D0%B8%D1%8F%D0%BC)
- [Получение похожих вакансий относительно другой вакансии](https://github.com/KirStepankov/MyHHAPI#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D1%83%D0%BD%D0%B8%D0%B5-%D0%BF%D0%BE%D1%85%D0%BE%D0%B6%D0%B8%D1%85-%D0%B2%D0%B0%D0%BA%D0%B0%D0%BD%D1%81%D0%B8%D0%B9)
- [Поиск работодателей по параметрам](https://github.com/KirStepankov/MyHHAPI#%D0%BF%D0%BE%D0%B8%D1%81%D0%BA-%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%BE%D0%B4%D0%B0%D1%82%D0%B5%D0%BB%D1%8F)
- [Поиск работодателя по id](https://github.com/KirStepankov/MyHHAPI#%D0%BF%D0%BE%D0%B8%D1%81%D0%BA-%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%BE%D0%B4%D0%B0%D1%82%D0%B5%D0%BB%D1%8F-%D0%BF%D0%BE-id)
- [Получение всех спициальностей](https://github.com/KirStepankov/MyHHAPI#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B2%D1%81%D0%B5%D1%85-%D1%81%D0%BF%D0%B5%D1%86%D0%B8%D0%B0%D0%BB%D1%8C%D0%BD%D0%BE%D1%81%D1%82%D0%B5%D0%B9)
- [Получение всех отраслей компаний](https://github.com/KirStepankov/MyHHAPI#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B2%D1%81%D0%B5%D1%85-%D0%BE%D1%82%D1%80%D0%B0%D1%81%D0%BB%D0%B5%D0%B9-%D0%BA%D0%BE%D0%BC%D0%BF%D0%B0%D0%BD%D0%B8%D0%B9)

Список всех сервисов
====================

[](#список-всех-сервисов)

❗ Ссылки ведут на доку HH

- vacancy ([Поиск резюме по id](https://github.com/hhru/api/blob/master/docs/vacancies.md#%D0%BF%D1%80%D0%BE%D1%81%D0%BC%D0%BE%D1%82%D1%80-%D0%B2%D0%B0%D0%BA%D0%B0%D0%BD%D1%81%D0%B8%D0%B8))
- vacancies ([Поиск вакансии по условиям](https://github.com/hhru/api/blob/master/docs/vacancies.md#%D0%BF%D0%BE%D0%B8%D1%81%D0%BA-%D0%BF%D0%BE-%D0%B2%D0%B0%D0%BA%D0%B0%D0%BD%D1%81%D0%B8%D1%8F%D0%BC))
- vacanciesSimilar ([Поисх похожих вакансий](https://github.com/hhru/api/blob/master/docs/vacancies.md#%D0%BF%D0%BE%D0%B8%D1%81%D0%BA-%D0%BF%D0%BE-%D0%B2%D0%B0%D0%BA%D0%B0%D0%BD%D1%81%D0%B8%D1%8F%D0%BC-%D0%BF%D0%BE%D1%85%D0%BE%D0%B6%D0%B8%D0%BC-%D0%BD%D0%B0-%D0%B2%D0%B0%D0%BA%D0%B0%D0%BD%D1%81%D0%B8%D1%8E))
- employers ([Поиск работодателя](https://api.hh.ru/openapi/redoc#tag/Rabotodatel/paths/~1employers/get))
- employer ([Поиск работодателя по id](https://api.hh.ru/openapi/redoc#tag/Rabotodatel/paths/~1employers~1%7Bemployer_id%7D/get))
- specializations ([Специализации](https://github.com/hhru/api/blob/master/docs/specializations.md))
- industries ([Отрасли компаний](https://api.hh.ru/openapi/redoc#tag/Obshie-spravochniki/paths/~1industries/get))

Документация
============

[](#документация)

### Получение токена

[](#получение-токена)

Обязательно заполняем все три метода. Данные выдаются в лк dev.hh.ru после регистрации приложения. Для всех методов, которые уже раелизованы в данной библиотеки токен **НЕ ТРЕБУЕТСЯ**

```
use MyHHAPI\OAuth\OAuthForApplication;

$oauth = new OAuthForApplication();

$oauth->setGrantType('');
$oauth->setClientId('');
$oauth->setClientSecret('');

$token = $oauth->getAccessToken();
var_dump($token);
```

---

### Получуние конкретной вакансии по id

[](#получуние-конкретной-вакансии-по-id)

Вызываем фабрику

```
use MyHHAPI\MyHHAPIFactory;
$factory = new MyHHAPIFactory();
```

В метод `getService` необходимо передать id сервиса. Все сервиси описаны в п [**"Список всех сервисов"**](https://github.com/KirStepankov/MyHHAPI#%D1%81%D0%BF%D0%B8%D1%81%D0%BE%D0%BA-%D0%B2%D1%81%D0%B5%D1%85-%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%B2)

```
$service = $factory->getService('vacancy');
```

В объект добавляем id вакансии с ключом `idVacancy`

```
$service->setQueryFields([
    'idVacancy' => 00000000,
]);
```

Выводим полученные данные от АПИ

```
$data = $service->getData();
var_dump($data);
```

---

### Получуние вакансий по условиям

[](#получуние-вакансий-по-условиям)

Вызываем фабрику

```
use MyHHAPI\MyHHAPIFactory;
$factory = new MyHHAPIFactory();
```

В метод `getService` необходимо передать id сервиса. Все сервиси описаны в п [**"Список всех сервисов"**](https://github.com/KirStepankov/MyHHAPI#%D1%81%D0%BF%D0%B8%D1%81%D0%BE%D0%BA-%D0%B2%D1%81%D0%B5%D1%85-%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%B2)

```
$service = $factory->getService('vacancies');
```

Заполняем объект обязательными и необязательными [параметрами](https://github.com/hhru/api/blob/master/docs/vacancies.md#%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81)

```
$service->setQueryFields([
    'text' => 'Java',
]);
```

Выводим полученные данные от АПИ

```
$data = $service->getData();
var_dump($data);
```

---

### Получуние похожих вакансий

[](#получуние-похожих-вакансий)

Вызываем фабрику

```
use MyHHAPI\MyHHAPIFactory;
$factory = new MyHHAPIFactory();
```

В метод `getService` необходимо передать id сервиса. Все сервиси описаны в п [**"Список всех сервисов"**](https://github.com/KirStepankov/MyHHAPI#%D1%81%D0%BF%D0%B8%D1%81%D0%BE%D0%BA-%D0%B2%D1%81%D0%B5%D1%85-%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%B2)

```
$service = $factory->getService('vacanciesSimilar');
```

В объект добавляем id вакансии с ключом `idVacancy`

```
$service->setQueryFields([
    'idVacancy' => 00000000,
]);
```

Выводим полученные данные от АПИ

```
$data = $service->getData();
var_dump($data);
```

---

### Поиск работодателей по параметрам

[](#поиск-работодателей-по-параметрам)

Вызываем фабрику

```
use MyHHAPI\MyHHAPIFactory;
$factory = new MyHHAPIFactory();
```

В метод `getService` необходимо передать id сервиса. Все сервиси описаны в п [**"Список всех сервисов"**](https://github.com/KirStepankov/MyHHAPI#%D1%81%D0%BF%D0%B8%D1%81%D0%BE%D0%BA-%D0%B2%D1%81%D0%B5%D1%85-%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%B2)

```
$service = $factory->getService('employers');
```

В объект добавляем нужные [параметры](https://api.hh.ru/openapi/redoc#tag/Rabotodatel/paths/~1employers/get)

```
$service->setQueryFields([
    'locale' => 'EN',
    'host' => 'hh.kz'
]);
```

Выводим полученные данные от АПИ

```
$data = $service->getData();
var_dump($data);
```

---

### Поиск работодателя по id

[](#поиск-работодателя-по-id)

Вызываем фабрику

```
use MyHHAPI\MyHHAPIFactory;
$factory = new MyHHAPIFactory();
```

В метод `getService` необходимо передать id сервиса. Все сервиси описаны в п [**"Список всех сервисов"**](https://github.com/KirStepankov/MyHHAPI#%D1%81%D0%BF%D0%B8%D1%81%D0%BE%D0%BA-%D0%B2%D1%81%D0%B5%D1%85-%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%B2)

```
$service = $factory->getService('employer');
```

В объект добавляем нужные [параметры](https://api.hh.ru/openapi/redoc#tag/Rabotodatel/paths/~1employers/get). Причём `employer_id` является обязательным, а другие поля нет

```
$service->setQueryFields([
    'employer_id' => 0000000,
    'locale' => 'EN',
    'host' => 'hh.kz'
]);
```

Выводим полученные данные от АПИ

```
$data = $service->getData();
var_dump($data);
```

---

### Получение всех специальностей

[](#получение-всех-специальностей)

Вызываем фабрику

```
use MyHHAPI\MyHHAPIFactory;
$factory = new MyHHAPIFactory();
```

В метод `getService` необходимо передать id сервиса. Все сервиси описаны в п [**"Список всех сервисов"**](https://github.com/KirStepankov/MyHHAPI#%D1%81%D0%BF%D0%B8%D1%81%D0%BE%D0%BA-%D0%B2%D1%81%D0%B5%D1%85-%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%B2)

```
$service = $factory->getService('specializations');
```

Выводим полученные данные от АПИ

```
$data = $service->getData();
var_dump($data);
```

---

### Получение всех отраслей компаний

[](#получение-всех-отраслей-компаний)

Вызываем фабрику

```
use MyHHAPI\MyHHAPIFactory;
$factory = new MyHHAPIFactory();
```

В метод `getService` необходимо передать id сервиса. Все сервиси описаны в п [**"Список всех сервисов"**](https://github.com/KirStepankov/MyHHAPI#%D1%81%D0%BF%D0%B8%D1%81%D0%BE%D0%BA-%D0%B2%D1%81%D0%B5%D1%85-%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%B2)

```
$service = $factory->getService('industries');
```

Выводим полученные данные от АПИ

```
$data = $service->getData();
var_dump($data);
```

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 67.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

14

Last Release

1289d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/59b19b9d8a2917f311214244f650d74044225cc45b4e426d59381eee67e7189c?d=identicon)[KirStepankov](/maintainers/KirStepankov)

---

Top Contributors

[![KirillStepankoff](https://avatars.githubusercontent.com/u/89337921?v=4)](https://github.com/KirillStepankoff "KirillStepankoff (36 commits)")[![KirStepankov](https://avatars.githubusercontent.com/u/67799754?v=4)](https://github.com/KirStepankov "KirStepankov (17 commits)")

---

Tags

phpapihhheadhunter

### Embed Badge

![Health badge](/badges/kirstepankov-myhhapi/health.svg)

```
[![Health](https://phpackages.com/badges/kirstepankov-myhhapi/health.svg)](https://phpackages.com/packages/kirstepankov-myhhapi)
```

###  Alternatives

[seregazhuk/headhunter-api

PHP library to interact with hh.ru API

2614.1k](/packages/seregazhuk-headhunter-api)[jstolpe/instagram-graph-api-php-sdk

Instagram Graph API PHP SDK

13998.4k2](/packages/jstolpe-instagram-graph-api-php-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)