Skip to main content
POST
/
api
/
hh
/
resumes
/
search
/hh/resumes/search
curl --request POST \
  --url https://api.anysite.io/api/hh/resumes/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2500,
  "timeout": 300,
  "text": "",
  "area": "1",
  "period": "0",
  "order_by": "relevance"
}
'
[
  {
    "id": "<string>",
    "url": "<string>",
    "@type": "@hh_resume_search_item",
    "title": "<string>",
    "age": 123,
    "gender": "<string>",
    "salary": {
      "@type": "@hh_resume_salary",
      "amount": 123,
      "currency": "<string>"
    },
    "predicted_salary": {
      "@type": "@hh_resume_salary",
      "amount": 123,
      "currency": "<string>"
    },
    "total_experience_months": 123,
    "key_skills": [],
    "has_photo": true,
    "is_online": true,
    "job_search_status": "<string>",
    "lang": "<string>",
    "source": "<string>",
    "last_activity_at": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
count
integer
required

Max number of results

Required range: 1 <= x <= 5000
​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
text
string
default:""

Search query matched against resume title, skills and work history

Example:

"python"

​
area
string | null

Region id to search within (e.g. 1 for Moscow, 2 for Saint Petersburg)

Example:

"1"

​
experience
enum<string> | null

Total work experience bucket

Available options:
noExperience,
between1And3,
between3And6,
moreThan6
​
period
enum<string>
default:0

Limit to resumes updated within this many days

Available options:
0,
1,
3,
7,
30,
365
​
order_by
enum<string>
default:relevance

Result ordering

Available options:
relevance,
publication_time,
salary_desc,
salary_asc

Response

Successful Response

​
id
string
required
​
url
string
required
​
@type
string
default:@hh_resume_search_item
​
title
string | null
​
age
integer | null
​
gender
string | null
​
salary
HhResumeSalary · object
​
predicted_salary
HhResumeSalary · object
​
total_experience_months
integer | null
​
key_skills
string[]
​
has_photo
boolean | null
​
is_online
boolean | null
​
job_search_status
string | null
​
lang
string | null
​
source
string | null
​
last_activity_at
string | null
​
created_at
integer | null
​
updated_at
integer | null