Skip to main content
POST
/
api
/
hh
/
vacancies
/hh/vacancies
curl --request POST \
  --url https://api.anysite.io/api/hh/vacancies \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "vacancy_id": "<string>",
  "timeout": 300
}
'
[
  {
    "id": 123,
    "name": "<string>",
    "url": "<string>",
    "description": "<string>",
    "@type": "@hh_vacancy",
    "description_text": "<string>",
    "salary": {
      "@type": "@hh_salary",
      "salary_from": 123,
      "salary_to": 123,
      "currency": "<string>",
      "is_gross": true,
      "mode": "<string>",
      "mode_label": "<string>",
      "frequency": "<string>",
      "frequency_label": "<string>"
    },
    "employer": {
      "@type": "@hh_vacancy_employer",
      "id": 123,
      "name": "<string>",
      "alias": "<string>",
      "image": "<string>",
      "web_url": "<string>",
      "is_accredited_it": true,
      "is_trusted": true
    },
    "address": {
      "@type": "@hh_vacancy_address",
      "city": "<string>",
      "street": "<string>",
      "building": "<string>",
      "display_name": "<string>",
      "district": "<string>",
      "lat": 123,
      "lng": 123,
      "metro_stations": []
    },
    "area_id": 123,
    "area_name": "<string>",
    "experience": "<string>",
    "experience_label": "<string>",
    "employment_form": "<string>",
    "employment_form_label": "<string>",
    "work_formats": [],
    "work_format_labels": [],
    "work_schedule_by_days": [],
    "work_schedule_by_days_labels": [],
    "working_hours": [],
    "working_hours_labels": [],
    "night_shifts": true,
    "internship": true,
    "accept_handicapped": true,
    "accept_labor_contract": true,
    "key_skills": [],
    "driver_license_types": [],
    "professional_role_ids": [],
    "platforms": [],
    "published_at": "<string>",
    "valid_through_at": "<string>",
    "is_archived": true,
    "is_premium": true,
    "contacts_hidden": true
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
vacancy_id
string
required

HeadHunter vacancy id, or a vacancy URL containing it

Minimum string length: 1
Examples:

"133799732"

"https://hh.ru/vacancy/133799732"

timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500

Response

Successful Response

id
integer
required
name
string
required
url
string
required
description
string
required
@type
string
default:@hh_vacancy
description_text
string | null
salary
HhSalary · object
employer
HhVacancyEmployer · object
address
HhVacancyAddress · object
area_id
integer | null
area_name
string | null
experience
string | null
experience_label
string | null
employment_form
string | null
employment_form_label
string | null
work_formats
string[]
work_format_labels
string[]
work_schedule_by_days
string[]
work_schedule_by_days_labels
string[]
working_hours
string[]
working_hours_labels
string[]
night_shifts
boolean | null
internship
boolean | null
accept_handicapped
boolean | null
accept_labor_contract
boolean | null
key_skills
string[]
driver_license_types
string[]
professional_role_ids
integer[]
platforms
string[]
published_at
string | null
valid_through_at
string | null
is_archived
boolean | null
is_premium
boolean | null
contacts_hidden
boolean | null