{"id":16675802,"url":"https://github.com/seregazhuk/php-headhunter-api","last_synced_at":"2025-07-02T02:05:47.672Z","repository":{"id":57048283,"uuid":"49318062","full_name":"seregazhuk/php-headhunter-api","owner":"seregazhuk","description":"PHP library that provides a friendly API interface for HeadHunter (hh.ru) service","archived":false,"fork":false,"pushed_at":"2018-10-05T13:04:45.000Z","size":130,"stargazers_count":26,"open_issues_count":1,"forks_count":12,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-03T23:11:29.151Z","etag":null,"topics":["api","headhunter"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seregazhuk.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-01-09T09:15:38.000Z","updated_at":"2024-02-25T21:00:44.000Z","dependencies_parsed_at":"2022-08-23T18:51:00.914Z","dependency_job_id":null,"html_url":"https://github.com/seregazhuk/php-headhunter-api","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/seregazhuk/php-headhunter-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seregazhuk%2Fphp-headhunter-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seregazhuk%2Fphp-headhunter-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seregazhuk%2Fphp-headhunter-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seregazhuk%2Fphp-headhunter-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seregazhuk","download_url":"https://codeload.github.com/seregazhuk/php-headhunter-api/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seregazhuk%2Fphp-headhunter-api/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263061404,"owners_count":23407606,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","headhunter"],"created_at":"2024-10-12T13:07:52.216Z","updated_at":"2025-07-02T02:05:47.649Z","avatar_url":"https://github.com/seregazhuk.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HeadHunter.ru API library (in process)\n\n[![Code Climate](https://codeclimate.com/github/seregazhuk/php-headhunter-api/badges/gpa.svg)](https://codeclimate.com/github/seregazhuk/php-headhunter-api)\n[![Test Coverage](https://codeclimate.com/github/seregazhuk/php-headhunter-api/badges/coverage.svg)](https://codeclimate.com/github/seregazhuk/php-headhunter-api/coverage)\n[![Build Status](https://travis-ci.org/seregazhuk/php-headhunter-api.svg)](https://travis-ci.org/seregazhuk/php-headhunter-api)\n[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/seregazhuk/php-headhunter-api/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/seregazhuk/php-headhunter-api/?branch=master)\n[![Latest Stable Version](https://poser.pugx.org/seregazhuk/headhunter-api/v/stable)](https://packagist.org/packages/seregazhuk/headhunter-api)\n[![Total Downloads](https://poser.pugx.org/seregazhuk/headhunter-api/downloads)](https://packagist.org/packages/seregazhuk/headhunter-api)\n\nProvides a friendly API interface for HeadHunter (hh.ru) service.\n\nOfficial API docs available [here](https://github.com/hhru/api).\n\n - [Installation](#installation)\n - [Quick Start](#quick-start)\n - [Vacancies](#vacancies)\n - [Employers](#employers)\n - [Employer Managers](#employer-managers)\n - [Artifacts](#artifacts)\n - [User](#user)\n - [Comments](#comments)\n - [Industries](#industries)\n - [Negotiations](#employee-negotiations)\n - [Regions](#regions)\n - [Resumes](#resumes)\n - [Saved searches](#saved-searches)\n - [Specializations](#specializations)\n - [Dictionaries](#dictionaries)\n - [Suggests](#suggests)\n - [Metro](#metro)\n - [Languages](#languages)\n - [Custom requests](#custom-requests)\n\n## Dependencies\n\nRequires PHP 5.6 or above.\n\n\n## Installation\n\nThe recommended way to install this library is via [Composer](https://getcomposer.org). \n[New to Composer?](https://getcomposer.org/doc/00-intro.md)\n\n```\ncomposer require seregazhuk/headhunter-api\n```\n\n## Quick Start\n\n```php\n// You may need to amend this path to locate composer's autoloader\nrequire('vendor/autoload.php');\nuse seregazhuk\\HeadHunterApi\\Api;\n\n/**\n * Token is optional. Your need token only\n * for resources that require authentication\n */\n$api = Api::create('YOUR_TOKEN');\n$userInfo = $api-\u003eme-\u003einfo();\n```\n\nYou can create an instance without token, and later change it.\n```\n$api = Api::create();\n$api-\u003esetToken('YOUR_TOKEN');\n```\n\n## API Resources\n\n### Vacancies\n\nView vacancy by id ([official docs](https://github.com/hhru/api/blob/master/docs/vacancies.md)):\n```php\n$vacancy = $api-\u003evacancies-\u003eview($id);\n```\n\nGet similar vacancies for the current one ([official docs](https://github.com/hhru/api/blob/master/docs/vacancies.md#similar)):\n```php\n$similarVacancies = $api-\u003evacancies-\u003esimilar($id);\n```\n\nGet black listed vacancies ([official docs](https://github.com/hhru/api/blob/master/docs/blacklisted.md)):\n```php\n$blacklisted = $api-\u003evacancies-\u003eblacklisted();\n```\n\nGet list of favorited vacancies ([official docs](https://github.com/hhru/api/blob/master/docs/vacancies.md#favorited)):\n```php\n$vacancies = $api-\u003evacancies-\u003efavorited();\n\n// with pagination\n$vacancies = $api-\u003evacancies-\u003efavorited(['page' =\u003e 2]);\n```\n\nSearch ([official docs](https://github.com/hhru/api/blob/master/docs/vacancies.md#search)):\n```php\n$vacancies = $api-\u003evacancies-\u003esearch($params);\n```\n\nVacancy statistics ([official docs](https://github.com/hhru/api/blob/master/docs/employer_vacancies.md#stats)):\n```php\n$stats = $api-\u003evacancies-\u003estatistics($vacancyId);\n```\n\nEmployer's active vacancies ([official docs](https://github.com/hhru/api/blob/master/docs/employer_vacancies.md#Список-опубликованных-вакансий)):\n```php\n$vacancies = $api-\u003evacancies-\u003eactive();\n\n// you can specify a manager, by default uses current manager\n$vacancies = $api-\u003evacancies-\u003eactive($managerId);\n// with pagination\n$vacancies = $api-\u003evacancies-\u003eactive($managerId, ['page'=\u003e2]);\n```\n\nEmployer's archived vacancies ([official docs](https://github.com/hhru/api/blob/master/docs/employer_vacancies.md#Архивация-вакансий)):\n\n```php\n$archived = $api-\u003evacancies-\u003earchived();\n// with pagination\n$archived = $api-\u003evacancies-\u003earchived(['page'=\u003e2]);\n```\n\nEmployer's hidden vacancies ([official docs](https://github.com/hhru/api/blob/master/docs/employer_vacancies.md#hidden)):\n\n```php\n$hidden = $api-\u003evacancies-\u003ehidden();\n// with pagination\n$hidden = $api-\u003evacancies-\u003ehidden(['page'=\u003e2]);\n```\n\nHide a vacancy ([official docs](https://github.com/hhru/api/blob/master/docs/employer_vacancies.md#hide)):\n\n```php\n$api-\u003evacancies-\u003ehide($vacancyId);\n```\n\nRestore a vacancy ([official docs](https://github.com/hhru/api/blob/master/docs/employer_vacancies.md#restore)):\n\n```php\n$api-\u003evacancies-\u003erestore($vacancyId);\n```\n\n### Employers\n\nView employee by id ([official docs](https://github.com/hhru/api/blob/master/docs/employers.md#item)):\n```php\n$employee = $api-\u003eemployers-\u003eview($id);\n```\n\nSearch ([official docs](https://github.com/hhru/api/blob/master/docs/employers.md#search)):\n```php\n$employers = $api-\u003eemployers-\u003esearch($params);\n```\n### Employer Managers\n\nReference types and the rights of the manager ([official docs](https://github.com/hhru/api/blob/master/docs/employer_managers.md#dict)):\n```php\n$reference_type = $api-\u003eemployers-\u003egetManagerTypes();\n$reference_type = $api-\u003eemployers-\u003egetManagerTypes($employerId);\n```\nWhen used without parameters your employer id will be automatically resolved from your profile\n\nGet employer managers ([official docs](https://github.com/hhru/api/blob/master/docs/employer_managers.md#%D0%A1%D0%BF%D1%80%D0%B0%D0%B2%D0%BE%D1%87%D0%BD%D0%B8%D0%BA-%D0%BC%D0%B5%D0%BD%D0%B5%D0%B4%D0%B6%D0%B5%D1%80%D0%BE%D0%B2-%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%BE%D0%B4%D0%B0%D1%82%D0%B5%D0%BB%D1%8F)):\n```php\n$managers = $api-\u003eemployers-\u003egetManagers();\n$managers = $api-\u003eemployers-\u003egetManagers($employerId);\n$managerWhoHasVacancies = $api-\u003eemployers-\u003egetManagersWhoHasVacancies();\n$managerWhoHasVacancies = $api-\u003eemployers-\u003egetManagersWhoHasVacancies($employerId);\n```\nWhen used without parameters your employer id will be automatically resolved from your profile\n\nGet manager information ([official docs](https://github.com/hhru/api/blob/master/docs/employer_managers.md#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B8%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%86%D0%B8%D0%B8-%D0%BE-%D0%BC%D0%B5%D0%BD%D0%B5%D0%B4%D0%B6%D0%B5%D1%80%D0%B5)):\n```php\n$managers = $api-\u003eemployers-\u003egetManager($managerId);\n$managers = $api-\u003eemployers-\u003egetManager($managerId, $employerId);\n```\nWhen used without parameters your employer id will be automatically resolved from your profile\n\n### Artifacts:\n\nGet your photos ([official docs](https://github.com/hhru/api/blob/master/docs/artifacts.md)):\n```php\n$photos = $api-\u003eartifacts-\u003ephotos();\n```\n\nGet your portfolio ([official docs](https://github.com/hhru/api/blob/master/docs/artifacts.md)):\n```php\n$portfolio = $api-\u003eartifacts-\u003eportfolio();\n```\n\nDelete photo by id ([official docs](https://github.com/hhru/api/blob/master/docs/artifacts.md)):\n```php\n$api-\u003eartifacts-\u003edeletePhoto($photoId);\n```\n\nEdit photo attributes ([official docs](https://github.com/hhru/api/blob/master/docs/artifacts.md)):\n```php\n$api-\u003eartifacts-\u003eeditPhoto($photoId, $attributes);\n```\n\nUpload photo ([official docs](https://github.com/hhru/api/blob/master/docs/artifacts.md)):\n```php\n$api-\u003eartifacts-\u003euploadPhoto('photo.jpg', 'my picture description');\n```\n\nUpload portfolio ([official docs](https://github.com/hhru/api/blob/master/docs/artifacts.md)):\n```php\n$api-\u003eartifacts-\u003euploadPortfolio('portfolio.jpg', 'my portfolio description');\n```\n\n### User:\n\nGet current user info ([official docs](https://github.com/hhru/api/blob/master/docs/me.md)):\n```php\n$info = $api-\u003eme-\u003einfo();\n```\n\nUpdate name(last, first, middle). All parameters are required ([official docs](https://github.com/hhru/api/blob/master/docs/me.md#edit)):\n```php\n$api-\u003eme-\u003eeditName($lastName, $firstName, $middleName);\n```\n\nUpdate flag 'is_in_search' ([official docs](https://github.com/hhru/api/blob/master/docs/me.md#Флаг-ищу--не-ищу-работу)):\n```php\n$isInSearch = true; // or false;\n$api-\u003eme-\u003esetIsInSearch($isInSearch);\n```\n\nManager preferences by managerId. You can get your manager id from user object,\nreturned from `$api-\u003eme-\u003einfo()`. When used without parameters your manager id will be\nautomatically resolved from your profile ([official docs](https://github.com/hhru/api/blob/master/docs/manager_settings.md)).\n\n```php\n$me = $api-\u003eme-\u003einfo();\n$managerId = $me['manager']['id'];\n$preferences = $api-\u003emanager-\u003epreferences($managerId);\n\n// automatically get manager id from your profile\n$preferences = $api-\u003emanager-\u003epreferences($managerId);\n```\n\n### Applicant comments\n\nGet all comments about applicant ([official docs](https://github.com/hhru/api/blob/master/docs/applicant_comments.md#list)):\n```php\n$comments = $api-\u003ecomments-\u003eview($applicantId);\n```\n\nCreate a comment ([official docs](https://github.com/hhru/api/blob/master/docs/applicant_comments.md#add_comment)).\nYou need an applicant id, to create a comment. Applicant id can be received from resume:\n\n```php\n$resumeInfo = $api-\u003eresume-\u003eview($resumeId);\n$applicantCommentsUrl = $resumeInfo['owner']['comments']['url']; // https://api.hh.ru/applicant_comments/2743747\n// You need to parse id from this url\n\n// Create a comment, that is visible for coworkers\n$result = $api-\u003ecomments($applicantId, 'my comment');\n\n// Create a comment, that is visible only for you\n$result = $api-\u003ecreatePrivate($applicantId, 'my comment');\n```\n\nEdit comment ([official docs](https://github.com/hhru/api/blob/master/docs/applicant_comments.md#edit_comment)):\n\n```php\n// Edit a comment, that is visible for coworkers\n$api-\u003ecomments-\u003eedit($applicantId, $commentId, 'new comment text')\n\n// Edit a comment, that is visible only for you\n$result = $api-\u003eeditPrivate($applicantId, $commentId, 'new comment text');\n```\n\nDelete a comment ([official docs](https://github.com/hhru/api/blob/master/docs/applicant_comments.md#delete_comment)):\n\n```php\n$api-\u003ecomments-\u003edelete($applicantId, $commentId);\n```\n\n### Industries\nGet all industries ([official docs](https://github.com/hhru/api/blob/master/docs/industries.md)):\n```php\n$industries = $api-\u003eindustries-\u003eall();\n```\n\n### Employee Negotiations\n\nGet all negotiations ([official docs](https://github.com/hhru/api/blob/master/docs/negotiations.md#get_negotiations)):\n```php\n$negotiations = $api-\u003enegotiations-\u003eall();\n```\n\nGet only active negotiations ([official docs](https://github.com/hhru/api/blob/master/docs/negotiations.md#get_negotiations_active)):\n```php\n$negotiations = $api-\u003enegotiations-\u003eactive();\n```\n\nView the list of messages.\n\n- For employee: get messages of negotiation ([official docs](https://github.com/hhru/api/blob/master/docs/negotiations.md#get_messages)):\n- For employer: view the list of messages in the response/invitation ([official docs](https://github.com/hhru/api/blob/master/docs/employer_negotiations.md#view-the-list-of-messages-in-the-responseinvitation)):\n```php\n$api-\u003enegotiations-\u003emessages($negotiationId);\n// with pagination\n$api-\u003enegotiations-\u003emessages($negotiationId, ['page'=\u003e2]);\n```\n\nSending new message.\n\n- For employee: create a new message ([official docs](https://github.com/hhru/api/blob/master/docs/negotiations.md#send_message)):\n- For employer: sending a message in the response/invitation ([official docs](https://github.com/hhru/api/blob/master/docs/employer_negotiations.md#sending-a-message-in-the-responseinvitation)):\n\n```php\n$api-\u003enegotiations-\u003emessage($negotiationId, $messageText);\n```\n\nGit list of responses/invitation for ([official docs](https://github.com/hhru/api/blob/master/docs/employer_negotiations.md)):\n```php\n$responses = $api-\u003enegotiations-\u003einvited($vacancyId);\n```\n\n#### There are several types of invitations. For each of them you can pass a pagination array as a second argument:\nResponse\n```php\n$responses = $api-\u003enegotiations-\u003einvitedResponses($vacancyId);\n// with pagination\n$responses = $api-\u003enegotiations-\u003einvitedResponses($vacancyId, ['page'=\u003e2]);\n```\n\nConsider\n```php\n$toConsider = $api-\u003enegotiations-\u003einvitedConsider($vacancyId);\n```\n\nPhone interview\n```php\n$phoneInterviews = $api-\u003enegotiations-\u003einvitedPhoneInterviews($vacancyId);\n```\n\nAssessments\n```php\n$assessments = $api-\u003enegotiations-\u003einvitedAssessments($vacancyId);\n```\n\nInterviews\n```php\n$interviews = $api-\u003enegotiations-\u003einvitedInterviews($vacancyId);\n```\n\nOffers\n```php\n$offers = $api-\u003enegotiations-\u003einvitedOffers($vacancyId);\n```\n\nHired\n```php\n$hired = $api-\u003enegotiations-\u003einvitedHired($vacancyId);\n```\n\nDiscard by employer\n```php\n$discard = $api-\u003enegotiations-\u003einvitedDiscardByEmployer($vacancyId);\n```\n\n\n\n\n\n\nView the response/invitation by id. NegotiationId can be taken from key url in the `invited` call response.\n([official docs](https://github.com/hhru/api/blob/master/doc/employer_negotiations.md)):\n```php\n$response = $api-\u003enegotiations-\u003eview($negotiationId);\n```\n\n### Regions\n\nGet all regions ([official docs](https://github.com/hhru/api/blob/master/docs/areas.md#areas)):\n```php\n$regions = $api-\u003eregions-\u003eall();\n```\n\n### Resumes\n\nGet my resumes ([official docs](https://github.com/hhru/api/blob/master/docs/resumes.md#mine)):\n```php\n$resumes = $api-\u003eresumes-\u003emine();\n```\n\nView resume ([official docs](https://github.com/hhru/api/blob/master/docs/resumes.md#item)):\n```php\n$views = $api-\u003eresumes-\u003eview($resumeId);\n```\n\nEdit resume ([official docs](https://github.com/hhru/api/blob/master/docs/resumes.md#create_edit)):\n```php\n$api-\u003eresumes-\u003eedit($resumeId, ['first_name' =\u003e 'New name']);\n```\n\nCreate a new resume ([official docs](https://github.com/hhru/api/blob/master/docs/resumes.md#create_edit)):\n```php\n$attributes = ['first_name' =\u003e 'New name'];\n$result = $api-\u003eresumes-\u003ecreate($attributes);\n```\n\nViews history ([official docs](https://github.com/hhru/api/blob/master/docs/resumes.md#views)):\n```php\n$views = $api-\u003eresumes-\u003eviews($resumeId);\n\n// with pagination\n\n$views = $api-\u003eresumes-\u003eviews($resumeId, ['page'=\u003e2]);\n```\n\nNegotiations history ([official docs](https://github.com/hhru/api/blob/master/docs/resume_negotiations_history.md)):\n```php\n$negotiations = $api-\u003eresumes-\u003enegotiations($resumeId);\n// with pagination\n$negotiations = $api-\u003eresumes-\u003enegotiations($resumeId, ['page' =\u003e 2]);\n```\n\nUpdate resume publish date ([official docs](https://github.com/hhru/api/blob/master/docs/resumes.md#publish)):\n```php\n$api-\u003eresumes-\u003epublish($resumeId);\n```\n\nGet resume conditions ([official docs](https://github.com/hhru/api/blob/master/docs/resumes.md#conditions)):\n```php\n$conditions = $api-\u003eresumes-\u003econditions($resumeId);\n```\n\nRemove resume ([official docs](https://github.com/hhru/api/blob/master/docs/resumes.md#delete)):\n```php\n$api-\u003eresumes-\u003edelete($resumeId);\n```\n\nGet current status (if it is blocked or ready to publish) ([official docs](https://github.com/hhru/api/blob/master/docs/resumes.md#status-and-publication)):\n```php\n$status = $api-\u003eresumes-\u003estatus($resumeId);\n```\n\nGet jobs recommendations for resume ([official docs](https://github.com/hhru/api/blob/master/docs/resumes.md#similar)):\n```php\n$jobs = $api-\u003eresumes-\u003ejobs($resumeId)\n\n// with pagination\n$jobs = $api-\u003eresumes-\u003ejobs($resumeId, ['page' =\u003e 2])\n```\n\n#### Resume visibility\n[official docs](https://github.com/hhru/api/blob/master/doc_eng/resume_visibility.md)\n\nGet resume black/white list:\n```php\n$blackList = $api-\u003eresumes-\u003egetBlackList($resumeId);\n// ...\n$whiteList = $api-\u003eresumes-\u003egetWhiteList($resumeId);\n```\n\nAdd a company to black/white list:\n```php\n$api-\u003eresumes-\u003eaddToBlackList($resumeId, $companyId);\n// ...\n$api-\u003eresumes-\u003eaddToWhiteList($resumeId, $companyId);\n```\n\nRemove a company from black/white list:\n```php\n$api-\u003eresumes-\u003eremoveFromBlackList($resumeId, $companyId);\n// ...\n$api-\u003eresumes-\u003eremoveFromWhiteList($resumeId, $companyId);\n```\n\nClear black/white list:\n```php\n$api-\u003eresumes-\u003eclearBlackList($resumeId);\n// ...\n$api-\u003eresumes-\u003eclearWhiteList($resumeId);\n```\n\nSearch in black/white list:\n```php\n$companies = $api-\u003eresumes-\u003esearchInBlackList($resumeId, 'some-key-word');\n//...\n$companies = $api-\u003eresumes-\u003esearchInWhiteList($resumeId, 'some-key-word');\n```\n\nSearch in black/white list:\n\n### Saved searches:\n\nList searches ([official docs](https://github.com/hhru/api/blob/master/docs/saved_search.md#vacancies-saved-search-list)):\n```php\n$searches = $api-\u003esavedSearches-\u003eall();\n```\n\nGet one search ([official docs](https://github.com/hhru/api/blob/master/docs/saved_search.md#vacancies-saved-search-item)):\n```php\n$searches = $api-\u003esavedSearches-\u003eview($searchId);\n```\n\n### Specializations\n\nGet all specializations ([official docs](https://github.com/hhru/api/blob/master/docs/specializations.md)):\n```php\n$specializations = $api-\u003especializations-\u003eall();\n```\n\n### Dictionaries\n\nGet list of entities that are used in API ([official docs](https://github.com/hhru/api/blob/master/docs/specializations.md)):\n```php\n$dictionaries = $api-\u003edictionaries-\u003eall();\n```\n\n### Suggests\n\nEducational institutions ([official docs](https://github.com/hhru/api/blob/master/docs/suggests.md#Подсказки-по-названиям-университетов)):\n```php\n$suggests = $api-\u003esuggests-\u003eeducational_institutions($text);\n```\n\nCompanies ([official docs](https://github.com/hhru/api/blob/master/docs/suggests.md#companies)):\n```php\n$suggests = $api-\u003esuggests-\u003ecompanies($text);\n```\n\nSpecialization ([official docs](https://github.com/hhru/api/blob/master/docs/suggests.md#specialization-suggestions)):\n```php\n$suggests = $api-\u003esuggests-\u003efieldsOfStudy($text);\n```\n\nKey skills ([official docs](https://github.com/hhru/api/blob/master/docs/suggests.md#key-skills-suggestions)):\n```php\n$suggests = $api-\u003esuggests-\u003eskillSet($text);\n```\n\nPosition ([official docs](https://github.com/hhru/api/blob/master/docs/suggests.md#position-suggestions)):\n```php\n$suggests = $api-\u003esuggests-\u003epositions($text);\n```\n\nRegion ([official docs](https://github.com/hhru/api/blob/master/docs/suggests.md#region-tips)):\n```php\n$suggests = $api-\u003esuggests-\u003eareas($text);\n```\n\nTips for vacancy search key words ([official docs](https://github.com/hhru/api/blob/master/docs/suggests.md#tips-for-vacancy-search-key-words)):\n```php\n$suggests = $api-\u003esuggests-\u003evacancySearchKeyword($text);\n```\n\n## Metro\nObtaining all metro stations of all cities ([official docs](https://github.com/hhru/api/blob/master/docs_eng/metro.md)):\n```php\n$stations = $api-\u003emetro-\u003eall();\n```\n\nList of metro stations and lines in a specific city ([official docs](https://github.com/hhru/api/blob/master/docs_eng/metro.md)):\n```php\n$stations = $api-\u003emetro-\u003eforCity($cityId);\n```\n\n## Languages\nObtaining available languages ([official docs](https://github.com/hhru/api/blob/master/docs/languages.md)):\n```php\n$languages = $api-\u003elanguages-\u003eall();\n```\n\n## Faculties\nGet list of faculties of the educational institutions ([official docs](https://github.com/hhru/api/blob/master/docs/faculties.md)).\nUses institutionId that can be obtained from the suggestions for educational institutions.\n```php\n$faculties = $api-\u003efaculties-\u003eforInstitution($institutionId);\n```\n\n## Custom requests ([official docs](https://github.com/hhru/api/blob/master/docs/metro.md#list-of-metro-stations-and-lines-in-a-specific-city)):\n\n### Locale\nYou can set a locale for your requests, the results will be returned in the selected locale. `RU` is set by\ndefault ([official docs](https://github.com/hhru/api/blob/master/docs_eng/locales.md)):\n```php\n$api-\u003esetLocale('EN');\n\n// chain methods\n$api-\u003esetLocale('EN')\n    -\u003eme\n    -\u003einfo();\n```\n\n### Host\nGet data from different websites of the HeadHunter group.\n([official docs](https://github.com/hhru/api/blob/master/docs_eng/hosts.md)):\n```php\n$api-\u003esetHost('hh.kz');\n\n// chain methods\n$api-\u003esetHost('hh.kz')\n    -\u003eme\n    -\u003einfo();\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseregazhuk%2Fphp-headhunter-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseregazhuk%2Fphp-headhunter-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseregazhuk%2Fphp-headhunter-api/lists"}