/hh/vacancies/search

curl --request POST \
  --url https://api.anysite.io/api/hh/vacancies/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "text": "<string>",
  "count": 1000,
  "timeout": 300,
  "area": 123,
  "salary": 1,
  "only_with_salary": true,
  "professional_role": 123,
  "industry": 123
}
'

[
  {
    "id": 123,
    "name": "<string>",
    "url": "<string>",
    "@type": "@hh_vacancy_search_item",
    "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_search_employer",
      "id": 123,
      "name": "<string>",
      "image": "<string>",
      "web_url": "<string>",
      "is_accredited_it": true,
      "is_trusted": true,
      "rating": 123,
      "review_count": 123
    },
    "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>",
    "employment_form": "<string>",
    "work_formats": [],
    "work_schedule_by_days": [],
    "working_hours": [],
    "professional_role_ids": [],
    "snippet": {
      "@type": "@hh_vacancy_search_snippet",
      "requirement": "<string>",
      "responsibility": "<string>",
      "conditions": "<string>",
      "skills": "<string>"
    },
    "response_count": 123,
    "is_premium": true,
    "is_advertisement": true,
    "accept_temporary": true,
    "accept_labor_contract": true,
    "published_at": "<string>",
    "created_at": "<string>"
  }
]

Jobs

/hh/vacancies/search

Search HeadHunter vacancies by keyword and filters

Price: 10 credits per 50 results

💡 AI Hint: Search HeadHunter (hh.ru) job vacancies by keyword with rich filters — restrict the query to the title/company/description, filter by region, minimum salary and currency, professional role, employer industry, required education and experience, employment type, schedule, work format, and publication period; order by relevance, date, or salary. Each result carries the vacancy id, title, salary, hiring employer (with rating), area, address with metro, a short requirement/responsibility snippet, and publication date.

POST

api

vacancies

/hh/vacancies/search

curl --request POST \
  --url https://api.anysite.io/api/hh/vacancies/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "text": "<string>",
  "count": 1000,
  "timeout": 300,
  "area": 123,
  "salary": 1,
  "only_with_salary": true,
  "professional_role": 123,
  "industry": 123
}
'

[
  {
    "id": 123,
    "name": "<string>",
    "url": "<string>",
    "@type": "@hh_vacancy_search_item",
    "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_search_employer",
      "id": 123,
      "name": "<string>",
      "image": "<string>",
      "web_url": "<string>",
      "is_accredited_it": true,
      "is_trusted": true,
      "rating": 123,
      "review_count": 123
    },
    "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>",
    "employment_form": "<string>",
    "work_formats": [],
    "work_schedule_by_days": [],
    "working_hours": [],
    "professional_role_ids": [],
    "snippet": {
      "@type": "@hh_vacancy_search_snippet",
      "requirement": "<string>",
      "responsibility": "<string>",
      "conditions": "<string>",
      "skills": "<string>"
    },
    "response_count": 123,
    "is_premium": true,
    "is_advertisement": true,
    "accept_temporary": true,
    "accept_labor_contract": true,
    "published_at": "<string>",
    "created_at": "<string>"
  }
]

Authorizations

access-token

string

header

required

API token from the dashboard

Headers

access-token

string

required

Body

application/json

text

string

required

Search query

Minimum string length: 1

count

integer

required

Max number of vacancies to return

Required range: 1 <= x <= 2000

timeout

integer

default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500

search_field

enum<string> | null

Restrict the query to the vacancy title, the company name, or the description

Available options:

name,

company_name,

description

area

integer | null

Region id (e.g. 1 = Moscow, 2 = Saint Petersburg)

salary

integer | null

Minimum salary

Required range: x >= 0

currency

enum<string> | null

Salary currency

Available options:

RUR,

USD,

EUR,

KZT,

UAH,

BYR,

AZN,

GEL,

KGS,

UZS

only_with_salary

boolean | null

Only vacancies that specify a salary

professional_role

integer | null

Professional role id

industry

integer | null

Employer industry id

education

enum<string> | null

Required education level

Available options:

not_required_or_not_specified,

higher,

special_secondary

experience

enum<string> | null

Required work experience

Available options:

noExperience,

between1And3,

between3And6,

moreThan6

employment

enum<string> | null

Employment type

Available options:

full,

part,

project,

flyInFlyOut

schedule

enum<string> | null

Work schedule

Available options:

fullDay,

shift,

flexible,

remote,

flyInFlyOut

working_hours

enum<string> | null

Working hours per day

Available options:

HOURS_2,

HOURS_3,

HOURS_4,

HOURS_5,

HOURS_6,

HOURS_7,

HOURS_8,

HOURS_9,

HOURS_10,

HOURS_11,

HOURS_12,

HOURS_24

work_format

enum<string> | null

Work format

Available options:

ON_SITE,

REMOTE,

HYBRID,

FIELD_WORK

label

enum<string> | null

Additional vacancy label / filter

Available options:

with_address,

not_from_agency,

accept_kids,

accredited_it,

internship,

night_shifts,

with_salary

order_by

enum<string> | null

Result ordering

Available options:

relevance,

publication_time,

salary_desc,

salary_asc

period

enum<string> | null

Publication period

Available options:

0,

1,

3,

7

Response

Successful Response

integer

required

name

string

required

url

string

required

@type

string

default:@hh_vacancy_search_item

salary

HhSalary · object

Show child attributes

employer

HhSearchEmployer · object

Show child attributes

address

HhVacancyAddress · object

Show child attributes

area_id

integer | null

area_name

string | null

experience

string | null

employment_form

string | null

work_formats

string[]

work_schedule_by_days

string[]

working_hours

string[]

professional_role_ids

integer[]

snippet

HhVacancySearchSnippet · object

Show child attributes

response_count

integer | null

is_premium

boolean | null

is_advertisement

boolean | null

accept_temporary

boolean | null

accept_labor_contract

boolean | null

published_at

string | null

created_at

string | null

/hh/vacancies /hh/vacancies/similar