README.md

HeadHunter API

По-русски | In english

HeadHunter API lets you integrate HeadHunter into your product.

First of all, read the general information on work with API and the requirements for logos and application names use.

To use services that require user or application authorization, you should register the application at https://dev.hh.ru and set up the authorization process.

After registration, the application can request of hh.ru users permission to access their personal data without obtaining and storing their usernames and password.

‼️ Note support for a new catalog of specializations (professional roles) in API HH.

‼️ Note the description of the new resume database management model. The employer has to pay for access to some methods .

OpenAPI

OpenAPI documentation will be complemented.
Methods are defined in OpenAPI have relevant links.

Specification HeadHunter API: openapi.yml.

Content

Article labels:

• – for anonymous requests, authrization isn't required.
• – for anonymous requests, requires application authorisation.
• – for applicant requests, requires user authorisation.
• – relevant for free methods for the employer, requires user authorisation.
• – relevant for paid methods for the employer, requires user authorisation.

Main

• General information
• API Service Terms of Use
• Logo use requirements
• Application name requirements
• Authorization
• Caching
• Errors and response codes
• Paid access to some API methods for employers
• New resume database management model (supported by API)

Context

• Information on the authorised user or application
  • Obtaining information on the authorised applicant
  • Obtaining information on the authorised employer manager
  • Obtaining information on the authorised application
  • Editing information on the authorised user
• Manager details
  • Manager work accounts
  • Manager preferences
• Information on active API services for paid methods
• Locales
• CV locales
• Site choice

CV

• View a CV
• Work with CVs for an applicant
  • CVs for an applicant. Phone
  • List of CVs for current user
  • CV creation & editing
  • CV publication & prolongation
  • Deleting a resume
  • CV view history
  • Information on a resume's status and readiness for publication
  • Resume visibility lists
• Artifacts (photos, portfolio)
• Search for vacancies similar to the CV
• History of responses/invitations for a resume

Vacancies

• Receiving vacancies
  • Search for vacancies
    • Clusters
    • Description of the used parameters
  • View a vacancy
• Search for vacancies similar to the vacancy
• Favorite vacancies
• Hidden vacancies
• Blacklisted employers
• Saved vacancy searches
• Vacancies for the employer / manager
  • Possible options available to current manager for publishing of vacancies
  • Vacancy posting
  • Vacancy editing
  • Vacancy prolongation
  • Published vacancy list
  • Storing vacancies
  • Archived vacancy list
  • Deleting vacancies
  • Deleted vacancy list
• Vacancy statistics
• Vacancy drafts
  • Getting a list of vacancy drafts
  • Deleting a draft
  • Creating vacancy draft
  • Publishing a vacancy from draft

Applicants

• Applicant comments
• Info on current authorized user
• Editing information on the authorized user

Employers / companies

• Company search
• View an employer/company
• Employer services
• Employer info
• Employer managers
• List of branded vacancy templates

Employer's managers

• Managers
  • Adding a manager
  • Editing a manager
  • Deleting a manager
  • Employer's manager directory
  • Getting information about a manager
  • Manager's limits

Messaging (applications/invitations)

• Messaging for applicants
  • Receiving the list of responses
  • Getting a list of active responses
  • Respond to the vacancy
  • View the response/invitation
  • Hide a response
  • View the list of messages in the response
  • Sending new message
  • Editing a message in a response
• Resume to apply for a given job
  • List of resumes that can be used to apply for a given job
  • Resumes grouped by the possibility of responding to a given job
• Messaging for employers
  • Processing model, terms and procedures
  • General description of processing responses/invitations
  • Collections and employer statuses for responses/invitations
  • List of responses/invitation
  • View the response/invitation
  • Work with messages in the response/invitation
  • Sending a message in the response/invitation
  • Inviting an applicant for a vacancy
  • Response/invitation actions (status change)
• Message templates
• Assessments

Directories

• Directories in OpenAPI
• Region directory
• Specialization directory
• Metro directory
• Language directory
• Company branches
• Educational institutions
  • Basic information about educational institutions
  • List of educational institution faculties
• Employer directories
  • Address directory
  • Types of managers and their rights
  • Employer's managers
  • Department directory
  • Test directory
  • List of regions with active vacancies
  • List of branded vacancy templates
• Key skills
• Other directories

Suggestions (autosuggest, autocomplete)

• Suggestions (autosuggest, autocomplete)
  • by university
  • by organization
  • by specialist area
  • by key skill
  • by resume position
  • by region
  • by job search keyword

Salary Database

• Reports of the Salary Database
  • Salary assessment without forecasts
• Salary Database Dictionaries
  • Industries
  • Competency levels
  • Professions and specialist areas
  • Regions and cities

Support, feedback, news

Stay in touch with us via twitter @apihhru or email [email protected].

If you found a bug in HeadHunter API or widgets, please look at issues. We probably know and are fixing it already. If we don't, it's better to report the bug there. There you can also leave your wishes and suggestions.

If you found a bug in HeadHunter site, contact website support or the support community.

You can follow the news by commits in this repository. RSS.